Accounting App

Webová účetní aplikace pro malé firmy a OSVČ. Podvojné účetnictví dle české legislativy, fakturace, evidence majetku a bankovní operace.

Tech Stack

Komponenta	Verze
PHP	8.4
Symfony	7.4
PostgreSQL	17
Node.js	22 LTS
Nuxt	4
Vuetify	3.8+
Docker	27+

Quick Start

# Kompletní setup vývojového prostředí
make dev

# Aplikace bude dostupná na:
# Frontend: http://localhost:3000
# Backend API: http://localhost:8000/api

Testovací přihlášení: admin@test.cz / admin123

Příkazy

# Základní
make up                  # Spuštění kontejnerů
make down                # Zastavení kontejnerů
make logs                # Zobrazení logů
make shell-backend       # Shell do PHP kontejneru
make shell-frontend      # Shell do Node kontejneru

# Databáze
make migrate             # Spuštění migrací
make seed                # Základní data (DPH, měny, účty)
make fixtures            # Testovací data (partneři, faktury...)

# Vývoj
make dev                 # Kompletní setup (migrate, seed, fixtures, test)
make test                # Spuštění testů
make test-unit           # Pouze unit testy
make test-integration    # Pouze integrační testy

# Kvalita kódu
make cs-fix              # PHP CS Fixer
make phpstan             # Statická analýza
make lint                # Frontend linting

# Zálohy
make backup              # Ruční záloha DB do ~/backups/
make backup-list         # Seznam záloh
make restore FILE=...    # Obnovení ze zálohy

Struktura projektu

accounting-app/
├── backend/                 # Symfony API
│   ├── src/
│   │   ├── Controller/Api/  # REST API endpointy
│   │   ├── Entity/          # Doctrine entity
│   │   ├── Repository/      # Databázové repozitáře
│   │   ├── Service/         # Business logika
│   │   └── DataFixtures/    # Seed a testovací data
│   └── tests/               # PHPUnit testy
├── frontend/                # Nuxt.js aplikace
│   ├── components/          # Vue komponenty
│   ├── composables/         # useApi, useNotification...
│   ├── pages/               # Stránky (file-based routing)
│   └── types/               # TypeScript typy
├── docker-compose.yml
└── Makefile

Funkce

Účetnictví

• Účtová osnova - dle české legislativy (třídy 0-9)
• Účetní deník - chronologický záznam všech operací
• Hlavní kniha - syntetická evidence dle účtů
• Fiskální období - správa účetních období

Fakturace

• Vydané faktury - vytvoření, editace, PDF export, sledování úhrad
• Přijaté faktury - s přílohami (obrázky, PDF skeny)
• Automatické číslování - konfigurovatelné sekvence
• Sledování splatnosti - přehledy pohledávek a závazků

Banka

• Evidence účtů - více bankovních účtů
• Import výpisů - CSV formát
• Párování transakcí - automatické i ruční párování s fakturami

Majetek

• Evidence DHM/DNM - inventární čísla, kategorie
• Odpisové plány - lineární a zrychlené odpisy
• Vyřazení majetku - s důvodem vyřazení

Partneři

• Odběratelé a dodavatelé - IČO, DIČ, kontakty
• Platební podmínky - výchozí splatnost
• Historie - přehled fakturace

Reporty a Export

• Pohledávky po splatnosti - s počtem dnů
• Závazky k úhradě - přehled nezaplacených faktur
• Cash flow - příjmy a výdaje
• Export pro účetní - CSV, ZIP balíček

API Endpointy

Endpoint	Popis
/api/partners	Partneři (odběratelé/dodavatelé)
/api/invoices	Vydané faktury
/api/received-invoices	Přijaté faktury
/api/bank-accounts	Bankovní účty
/api/bank-transactions	Bankovní transakce
/api/assets	Evidence majetku
/api/accounts	Účtová osnova
/api/entries	Účetní zápisy
/api/reports/*	Reporty a přehledy
/api/export/*	Export dat

Export pro účetní

Aplikace generuje strukturovaný exportní balíček:

export_2026/
├── ucetni_denik.csv          # Účetní deník
├── hlavni_kniha_XXX.csv      # Hlavní kniha (dle účtu)
├── faktury_vydane.csv        # Seznam vydaných faktur
├── faktury_prijate.csv       # Seznam přijatých faktur
├── dph_evidence.csv          # Evidence DPH
├── kontrolni_hlaseni.xml     # Kontrolní hlášení
└── README.txt                # Informace o exportu

Licence

MIT