Nette Base Project

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

Dokument	Popis
Spuštění projektu	Konfigurace prostředí, Docker, první spuštění
Struktura projektu	Architektura, vrstvy, typy souborů, kontejnery
Komponenty	Tvorba komponent, factory, registrace
Formuláře	Formuláře v komponentách, validace, DTO
CLI Příkazy	Psaní a spouštění konzolových příkazů
Migrace	Správa databázové struktury přes Phinx
Testování	Psaní a spouštění testů (Nette Tester)
Vývojový workflow	Konvence, nástroje kvality, Make příkazy

---

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

Oblast	Technologie
Framework	Nette 3.2
PHP	8.5+
Databáze	MariaDB (Nette Database Explorer)
Migrace	Phinx 0.16
CLI	Symfony Console 7
Frontend	Vite
Statická analýza	PHPStan 2
Coding standard	PHP_CodeSniffer 3
Refaktoring	Rector 2
Testování	Nette Tester 2.6

---

Autor

Jan Hinterholzinger — jan@hinterholzinger.cz

GitHub: hintik-dev

---

Licencováno pod MIT licencí.