Dokumentacja techniczna#
Ta sekcja opisuje, jak Fyndi jest zbudowane i jak jest utrzymywane: z jakich części składa się projekt, gdzie leżą dane, co potrafi panel staff, jak pilnujemy jakości i jak powstaje wydanie aplikacji.
Strony techniczne są dla osób, które chcą zrozumieć „jak to działa pod spodem” — programistów wracających do projektu, osoby piszące treść i każdego, kto zastanawia się, dlaczego coś działa właśnie tak. Do samego zwiedzania miasta ta wiedza nie jest potrzebna.
Co jest w tej sekcji#
Dziesięć stron, każda odpowiada na jedno pytanie:
- Jak zbudowane jest Fyndi — części systemu, przepływ danych i warstwy klienta,
- Gdzie leżą dane — konta, trasy, punkty, znajdźki, boty, nagrody i gdzie nie ma jawnych odpowiedzi,
- Co potrafi panel staff — role, dostęp i poszczególne ekrany panelu,
- Jak pilnujemy jakości — bramki, kontrole, self-testy i weryfikacja na urządzeniu,
- Jak powstaje wydanie APK — skąd pobrać aplikację, jak jest budowana i podpisywana,
- Co się zmieniło — historia zmian napisana językiem użytkownika,
- Jak rysowana jest mapa — znaczniki, ikony z jednego źródła i koszt wydajności,
- Jak zbudowana jest postać 3D — atlas, bryły, wymiary, animacje i kolory,
- Jak pracujemy — planer, zgłoszenia, rola agenta i mózg projektu.
Jak czytać strony techniczne#
Te strony świadomie nie mają kadrów z aplikacji. Ekrany telefonu opisują strony z grup W mieście, Zwiedzanie i Postać i AR — tutaj liczy się układ części, tabele i liczby, a nie wygląd ekranu. Tam, gdzie trzeba wybrać między opcjami, stoi tabela.
| Czego szukasz | Gdzie to jest |
|---|---|
| Podziału projektu na części i przepływu danych | Architektura |
| Tego, co leży w bazie, a co na dysku | Model danych |
| Ekranów panelu i ról | Panel staff |
| Bramek, kontroli i pomiarów | Jakość i kontrole |
| Budowy i podpisu APK | Wydania APK |
| „Co się zmieniło i co to dla mnie znaczy” | Historia zmian |
| Reguł rysowania znaczników | Mapa i znaczniki |
| Budowy postaci blocky | Postać 3D |
| Planera, zgłoszeń i pracy agentów | Proces pracy |
Strony techniczne opisują stan z wersji aplikacji podanej w stopce. Wersje i rozmiar aktualnego wydania są w stopce żywe — przeglądarka pobiera je z serwera, więc po nowym wydaniu nie trzeba nic poprawiać w tekście.
Spis stron technicznych#
Wszystkie strony wchodzą w skład drzewa dokumentacji i są wymienione w spisie po lewej stronie.
| Strona | Na jakie pytanie odpowiada |
|---|---|
| Architektura | Z czego składa się Fyndi i dlaczego właśnie tak |
| Model danych | Co gdzie leży i jak przechowywane są odpowiedzi do zagadek |
| Panel staff | Kto widzi panel, jakie ma role i co jest na poszczególnych stronach |
| Jakość i kontrole | Jakie bramki działają, jak je uruchomić i czego pilnuje bramka dokumentacji |
| Wydania APK | Skąd pobrać aplikację, jak powstaje wydanie i jak jest podpisane |
| Historia zmian | Najnowsze zmiany i wcześniejsze wydania w języku użytkownika |
| Mapa i znaczniki | Jedna warstwa znaczników, kolory, ikony i koszt wydajności |
| Postać 3D | Trzy warstwy wyglądu, wymiary, animacje i szafa |
| Proces pracy | Planer, kolumny, rola agenta i mózg projektu |
Dokumentacja nie jest osobnym projektem: pliki markdown leżą w tym samym repozytorium co kod, a strona docs.fyndi.app powstaje z nich w jednym kroku (bez zależności do instalowania). Dzięki temu opis funkcji zmienia się w tym samym zestawieniu zmian co sama funkcja — pilnuje tego bramka dokumentacji.
Opis zgodny z aplikacją 0.120.1 (zaktualizowano 2026-09-26).