This commit is contained in:
2026-04-28 22:17:25 +02:00
parent 6d3dba89ed
commit 1156ce046c
12 changed files with 965 additions and 112 deletions

View File

@@ -21,20 +21,20 @@
- Kod ma mieć komentarze tylko tam, gdzie wyjaśniają „dlaczego”, nie „co”
## Utrwalanie stalych wymagan
- Trwale wymagania techniczne zapisuj w tym pliku (`AGENTS.md`) w root projektu.
- Trwale wymagania techniczne zapisuj w tym pliku (`CLAUDE.md`) w root projektu.
- Dla zmiennych srodowiskowych utrzymuj tez wpisy w `.env.example`.
- Dokumentacje techniczna utrzymuj w folderze `DOCS`:
- `DOCS/DB_SCHEMA.md` - aktualny schemat bazy danych (aktualizacja przy kazdej zmianie migracji/schematu),
- `DOCS/ARCHITECTURE.md` - struktura klas, metod, modulow i przeplywow,
- `DOCS/TECH_CHANGELOG.md` - chronologiczny log zmian technicznych (co i dlaczego).
- Dokumentacje techniczna utrzymuj w folderze `.paul/codebase/`:
- `.paul/codebase/db_schema.md` - aktualny schemat bazy danych (aktualizacja przy kazdej zmianie migracji/schematu),
- `.paul/codebase/architecture.md` - struktura klas, metod, modulow i przeplywow,
- `.paul/codebase/tech_changelog.md` - chronologiczny log zmian technicznych (co i dlaczego).
- Przy kazdej nowej funkcji lub zmianie:
- zaktualizuj odpowiednie sekcje w `DOCS/DB_SCHEMA.md`, `DOCS/ARCHITECTURE.md`, `DOCS/TECH_CHANGELOG.md`,
- zaktualizuj odpowiednie sekcje w `.paul/codebase/db_schema.md`, `.paul/codebase/architecture.md`, `.paul/codebase/tech_changelog.md`,
- opisz nowe tabele/kolumny/indeksy/FK, nowe klasy/metody oraz zmiany kontraktow API.
## Wdrażanie poprawek
- Przed wdrożeniem zmian w kodzie, przeglądnij, poniższe dokumenty aby nowe kody dopasować do istniejacych już rozwiązań:
- `DOCS/DB_SCHEMA.md` - aktualny schemat bazy danych
- `DOCS/ARCHITECTURE.md` - struktura klas, metod, modulow i przeplywow
- `.paul/codebase/db_schema.md` - aktualny schemat bazy danych
- `.paul/codebase/architecture.md` - struktura klas, metod, modulow i przeplywow
- Zrób plan i mi go przedstaw
- Po akceptacji przejdź do wdrożenia
- Po wdrożeniu przeprowadź testy