Proces pracy#
Praca nad Fyndi idzie przez paczki: właściciel zgłasza zmianę, 🕵️ Manager zakłada paczkę, a jeden 👽 SI prowadzi ją od pierwszego commita do wydania. Planer w panelu jest lokalną tablicą tej pracy — nie publikuje zgłoszeń i nie synchronizuje się z GitHub Issues.
Planer i paczki#
Planer /panel/planner to lokalny kanban: trzy boxy robocze — Pomysły, Do zrobienia, W trakcie — a pod nimi tabela Zrobione; dane trzyma baza API pod /admin/tasks. Nie ma żadnej synchronizacji z GitHub Issues — karta nie tworzy zgłoszenia, tytuł nigdzie nie „jedzie w obie strony”, a skasowanie karty nie kasuje niczego poza kartą.
Właściciel ma trzy drogi wejścia, świadomie minimalne: kartę w planerze, formularz zgłoszenia z jednym polem w telefonie albo wiadomość głosową do asystenta. Każda kończy się tak samo — zmianą, którą trzeba zaplanować, wykonać i wydać. Droga od zgłoszenia do wydania jest jedna:
- Właściciel zgłasza zmianę — kartą, formularzem albo głosówką.
- 🕵️ Manager zakłada paczkę o numerze
P-xxx: jeden opis, jedno kryterium odbioru, jeden wykonawca. - Jeden 👽 SI robi całą paczkę od A do Z — kod, testy, dokumentację i mózg projektu, bez dzielenia pracy na kilka równoległych rąk.
- Dowody lądują w
/dowody/P-xxx/— zrzuty, wyniki testów, pomiary. Bez dowodu nie ma odbioru. - Wpis w
brain/log.mdi wCHANGELOG.mdzamyka pracę opisem, co się zmieniło i dlaczego. - Wydanie APK —
bash scripts/build_release_apk.shbuduje, podpisuje i publikuje nową wersję (Wydania APK).
Kolumny i paczki#
Kolumny znaczą tyle, ile mówi tabela — to cała umowa planera:
| Miejsce w planerze | Co znaczy | Kto decyduje |
|---|---|---|
| Pomysły (box) | notatka na przyszłość — jeszcze nie praca | właściciel |
| Do zrobienia (box) | zmiana zatwierdzona, czeka na paczkę | właściciel |
| W trakcie (box) | paczka w rękach jednego SI | SI |
| Zrobione (tabela pod boxami) | odebrane i wydane | właściciel |
Zatwierdzenie to przesunięcie karty do Do zrobienia — nic nie trafia do wykonania wcześniej. Stanu Do odbioru nie ma od 2026-10-06: po raporcie karta zostaje w W trakcie, a Zrobione ustawia wyłącznie właściciel. Karta w Pomysłach jest notatką, nie poleceniem.
Co robi SI#
- Bierze całą paczkę
P-xxx— nie pojedyncze zadanie z niej i nie dwie paczki naraz. - Najpierw pisze plan: kroki, kryteria akceptacji i obszar, plus notatkę, czego nie zamierza zrobić.
- **Przenosi kartę do W trakcie** przed pierwszą zmianą w kodzie, żeby nikt nie zaczął tego samego drugi raz.
- Robi paczkę do końca — kod, testy, dokumentację i mózg projektu. Dokumentacja i mózg (
docs/,brain/) idą w tej samej paczce co zmiana w produkcie, a nie „przy okazji następnej”. - Zbiera dowody w trakcie pracy — commit, wynik testu, pomiar, zrzut ekranu — bo każde zdanie w raporcie musi być odtwarzalne.
- Kończy raportem, wypisując, co zostało zrobione, co zweryfikowane, a co świadomie pominięte; kartę zostawia w W trakcie — o przeniesieniu do Zrobione decyduje właściciel.
- **Nigdy nie ustawia Zrobione** — to decyzja właściciela.
Dwie rzeczy warto powiedzieć wprost, bo są najczęstszym nieporozumieniem:
- Albo dowód, albo się nie wydarzyło. Brak dowodu to nie skończone zadanie; uczciwym stanem końcowym jest „do odbioru”, nie „zrobione”. Po trzech nieudanych próbach pozycja dostaje znacznik „zablokowane” z powodem i praca staje, zamiast się zapętlać.
- Niezależna weryfikacja. Pracę kogoś innego sprawdza osobny przebieg z czystym kontekstem: kontrole są celowo sabotowane, żeby zobaczyć, czy czerwienieją, a twierdzenia mierzone ponownie w kodzie.
Dokumentacja i mózg projektu#
Dwa artefakty wiedzy są częścią repozytorium, a nie czyjejś pamięci:
| Artefakt | Co to jest |
|---|---|
| Ten przewodnik | strony markdown w repozytorium, budowane do statycznej strony. Zmiana funkcji i jej opis trafiają w tej samej paczce, a bramka sprawdza strukturę, odsyłacze, obrazy i parytet obu języków (Jakość i kontrole) |
| Mózg projektu | katalog wiedzy w repozytorium: notatki techniczne, decyzje, dziennik pracy i noty dzienne. Da się go przeglądać w zakładce Wiki w panelu jako graf powiązanych notatek |
Samo repozytorium jest utrzymywane na bieżąco automatycznie: projekt pracuje wprost na serwerze i wypycha commity do repozytorium, strażnik co dziesięć minut wypycha to, co zostało pominięte, i przypomina na Telegramie o niezacommitowanej pracy. Nie scala niczego sam — rozjazd w drugą stronę jest raportowany i rozstrzyga go człowiek.
Opis zgodny z aplikacją 0.357.3 (zaktualizowano 2026-11-12).