Dokumentace

Požadavky

PHP 8.3+, Composer 2, Node.js 22.12+, MySQL 8 nebo MariaDB 10.6+, Nginx a PHP-FPM. PHP rozšíření: BCMath, cURL, DOM, Fileinfo, Intl, Mbstring, OpenSSL, PDO MySQL, XML a Zip.

Instalace

Po získání zdrojového kódu spusťte v kořeni projektu:

composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
# Nastavte APP_URL, databázi a SMTP v .env
npm ci
npm run build
php artisan migrate --force
php artisan optimize

Nginx musí směrovat do adresáře public/. Zápis povolte jen do storage/ a bootstrap/cache/. Zapněte HTTPS před registrací uživatelů.

První účet

Registrujte se, ověřte e-mail a vytvořte společnost. SMTP musí být funkční; lokální MAIL_MAILER=log ukládá zprávy do aplikačního logu.

Registrace

php artisan invoice:registration off
php artisan invoice:registration on

Zálohy a aktualizace

Zálohujte databázi, privátní soubory a bezpečně uložený APP_KEY. Před aktualizací udělejte zálohu, přepněte aplikaci do údržby, nainstalujte závislosti, sestavte frontend, spusťte migrace, obnovte cache a restartujte fronty. Podrobnosti jsou v README.md a docs/INSTALLATION.md ve zdrojovém kódu.

Stav vývoje

Fáze 2: účty, společnosti, zákazníci, katalog, běžná tuzemská fakturace, PDF, QR platby a CSV export. Před vystavením doplňte IČO a zápis v rejstříku / evidenci v nastavení společnosti. Plátce potřebuje DIČ a DUZP; podporována je měna CZK a sazby 12 % / 21 %. Platby, editor šablon, upomínky a další moduly přibudou v dalších fázích.