Przejdź do treści
Fyndi docs
English

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:

  1. Właściciel zgłasza zmianę — kartą, formularzem albo głosówką.
  2. 🕵️ Manager zakłada paczkę o numerze P-xxx: jeden opis, jedno kryterium odbioru, jeden wykonawca.
  3. 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.
  4. Dowody lądują w /dowody/P-xxx/ — zrzuty, wyniki testów, pomiary. Bez dowodu nie ma odbioru.
  5. Wpis w brain/log.md i w CHANGELOG.md zamyka pracę opisem, co się zmieniło i dlaczego.
  6. Wydanie APK — bash scripts/build_release_apk.sh buduje, podpisuje i publikuje nową wersję (Wydania APK).

Kolumny i paczki#

Kolumny znaczą tyle, ile mówi tabela — to cała umowa planera:

Miejsce w planerzeCo znaczyKto decyduje
Pomysły (box)notatka na przyszłość — jeszcze nie pracawłaściciel
Do zrobienia (box)zmiana zatwierdzona, czeka na paczkęwłaściciel
W trakcie (box)paczka w rękach jednego SISI
Zrobione (tabela pod boxami)odebrane i wydanewł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#

  1. Bierze całą paczkę P-xxx — nie pojedyncze zadanie z niej i nie dwie paczki naraz.
  2. Najpierw pisze plan: kroki, kryteria akceptacji i obszar, plus notatkę, czego nie zamierza zrobić.
  3. **Przenosi kartę do W trakcie** przed pierwszą zmianą w kodzie, żeby nikt nie zaczął tego samego drugi raz.
  4. 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”.
  5. Zbiera dowody w trakcie pracy — commit, wynik testu, pomiar, zrzut ekranu — bo każde zdanie w raporcie musi być odtwarzalne.
  6. 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.
  7. **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:

ArtefaktCo to jest
Ten przewodnikstrony 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 projektukatalog 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).

Wersja aplikacji: 0.357.3 Wersja API: 0.73.0

docs.fyndi.app · 2026-11-12