README

Skeleton Nette aplikace připravený pro okamžitý vývoj. Obsahuje předkonfigurované prostředí, Docker setup, třívrstvou MVP architekturu a sadu nástrojů pro zajištění kvality kódu.

Funkce

• Docker prostředí — PHP 8.5 + Apache, MariaDB, phpMyAdmin, Node.js
• Třívrstvá MVP architektura — oddělení prezentační, doménové a datové vrstvy
• Modulární struktura — samostatný Admin a Web modul
• Autentizace a autorizace — přihlašování uživatelů, role-based access control
• Databázové migrace — Phinx pro verzování databázové struktury
• CLI příkazy — Symfony Console pro konzolové operace
• Frontend build — Vite pro moderní správu CSS a JS assetů
• Formuláře jako komponenty — znovupoužitelné UI komponenty s BaseComponent
• Automatická registrace služeb — Facade, Service, Repository, Mapper, Factory, Command
• Kompletní code quality toolchain — PHPStan, PHPCS, Rector, Latte lint, Neon lint
• Testování — Nette Tester připraven k použití

Požadavky

• Docker a Docker Compose
• Make

Rychlý start

# Klonování projektu
git clone https://github.com/hintik-dev/nette-base-project.git
cd nette-base-project

# Konfigurace prostředí
cp docker/.env_example docker/.env
cp docker/php.env_example docker/php.env
cp config/local.example/ config/local -r

# Vyplníme nastavení připojení do databáze v config/local/database.neon (při použití jiné než vývojové databáze v kontejneru).

# Spuštění
make up

# Nastavení práv (zapisovatelné složky)
make chmod

# Databázové migrace
make migrate

# Instalace NPM závislostí
make ni

# Build assetů
make node-build-dev

Aplikace bude dostupná na http://localhost:10000 (port určen dle obsahu souboru docker/.env).

Podrobný návod: docs/getting-started.md

Dokumentace

Architektura

Projekt implementuje třívrstvou MVP architekturu:

Presentation  →  Domain  →  Infrastructure
(Presentery)     (Fasády,    (Repozitáře,
                 Služby,      Mappery,
                 Entity)      Databáze)

Aplikace je rozdělena do dvou modulů:

• Admin (/admin/…) — přihlášení správci
• Web (/…) — veřejná část webu

Make příkazy

make up             # Spuštění Docker prostředí
make bash           # Bash v PHP kontejneru
make migrate        # Spuštění databázových migrací
make watch          # Watch mód pro assety
make all            # Všechny testy a kontroly kódu
make all-fix        # Automatická oprava všech problémů
make nette-tester   # Spuštění testů
make phpstan        # Statická analýza

Kompletní přehled příkazů: docs/workflow.md

Technologie

Autor

Jan Hinterholzinger — jan@hinterholzinger.cz

GitHub: hintik-dev

Licencováno pod MIT licencí.