Spaces:
Sleeping
Sleeping
| title: Test DB | |
| emoji: 🧾 | |
| colorFrom: indigo | |
| colorTo: blue | |
| sdk: docker | |
| pinned: false | |
| # Generator faktur | |
| Projekt oferuje dwa sposoby tworzenia faktur: prostą aplikację CLI oraz rozbudowany panel webowy z backendem Flask i estetycznym PDF-em. | |
| ## Co w środku? | |
| - **CLI** – szybkie narzędzie terminalowe do pojedynczych dokumentów. | |
| - **Frontend + backend** – logowanie, edycja danych firmy, inteligentny formularz nabywcy, historia faktur i eleganckie PDF-y z logo. | |
| --- | |
| ## Aplikacja webowa | |
| ### Wymagania | |
| - Python 3.8+ | |
| - `pip install -r requirements.txt` | |
| - (opcjonalnie) `NEON_DATABASE_URL` – gdy ustawisz połączenie z bazą PostgreSQL/Neon, klienci i faktury są zapisywani w bazie zamiast w pliku. | |
| ### Uruchomienie | |
| ```powershell | |
| python server.py | |
| # aplikacja działa na http://localhost:5000 | |
| ``` | |
| ### Funkcje | |
| - onboarding z konfiguracją firmy i logo, | |
| - logowanie z tokenem w `sessionStorage`, | |
| - edycja sprzedawcy i zarządzanie logo (PNG/JPG do 512 KB), | |
| - formularz nabywcy z wyszukiwarką (po nazwie lub NIP-ie, wyniki tylko z konta zalogowanego użytkownika), | |
| - dynamiczna tabela pozycji licząca netto/VAT/brutto oraz obsługę stawek 23/8/5/0/ZW/NP, | |
| - sekcja zwolnienia podatkowego i automatyczna nota prawna, | |
| - dashboard z filtrami dat, wykresem i historią ostatnich 200 faktur, | |
| - eksport PDF spójny z UI (logo nad sprzedawcą, kapsułki z sumami, czytelna tabela). | |
| > PDF-y generuje [jsPDF](https://cdnjs.com/libraries/jspdf) ładowany z CDN – przeglądarka musi mieć dostęp do internetu. | |
| ### Reset danych | |
| - tryb plikowy: usuń `web_invoice_store.json`, aby przejść onboarding ponownie, | |
| - tryb Neon: wyczyść tabele w bazie lub użyj nowej bazy. | |
| --- | |
| ## Aplikacja CLI | |
| Lekki kreator w terminalu zapisujący dokumenty do katalogu `invoices/` i historię w `invoice_data.json`. | |
| ### Uruchomienie | |
| ```powershell | |
| python invoice_app.py | |
| ``` | |
| 1. Przy pierwszym starcie wpisz dane firmy i ustaw hasło. | |
| 2. Przy kolejnych startach logujesz się, uzupełniasz dane pozycji i (opcjonalnie) klienta. | |
| 3. Utworzona faktura trafia do `invoices/`, a historia do pliku JSON. | |
| ### Reset CLI | |
| Usuń katalog `invoices/` oraz plik `invoice_data.json`, aby rozpocząć od nowa (historia zostanie utracona). | |