← Moja historia · plan 8 tygodni · magazyn

Specyfikacja: „Warsztat” — jedna strona z całym laboratorium Maćka

Wersja 1, 17.10.2026, do akceptacji. Autor: agent, na prośbę Maćka („jedna kompleksowa strona: plan, warsztat, budżet, inspiracje, mapa, curriculum, śledzenie postępów”).

1. Po co i dla kogo

Jedna strona, którą Maciej otwiera codziennie na telefonie przy stole i na Macu wieczorem. W dziesięć sekund odpowiada na pięć pytań: co dziś robię, czy jestem w planie, gdzie leży część, ile wydałem, co umiem i czego mi brakuje. Agent pisze do niej dane po każdej rozmowie; Maciej czyta, klika i wysyła dowody. Dzisiejsze pięć osobnych stron (Moja historia, Magazyn, plan dnia, plan 8 tygodni, galeria zakupów) staje się zakładkami jednej aplikacji o wspólnym wyglądzie i jednej nawigacji.

Zasady nadrzędne, przeniesione z dotychczasowych ustaleń:

• Zwykły polski, bez skrótów; skrót tylko w nawiasie po opisie słowami.
• Postęp liczy się tylko z dowodem. Zakupy to kontekst, nie postęp.
• Jedno źródło prawdy w plikach w repo (YAML, Markdown); strona jest z nich generowana, statyczna, na portalu wyników, bez logowania, nieindeksowana. Bez danych osobowych (telefon, adres, numery zamówień tak, ale bez danych odbiorcy).
• Nic nie wpisuje się dwa razy. Część opisana raz (czesci.yaml) pojawia się w magazynie, w budżecie, w planie dnia i na slajdach z tego samego wiersza.

2. Moduły (zakładki)

2.1 Dziś (pulpit)

Pierwszy ekran. Zawiera:

• Dzisiejszy element: nazwa, zdjęcie, co wyjąć (adresy z magazynu), zjawisko do sprawdzenia, jaki dowód i do której godziny; przycisk „pokaż instrukcję” (slajdy albo opis dnia).
• Pasek tygodnia: siedem kółek, punkty, próg 5/7, numer tygodnia planu i jego kamień.
• Zaległości: dni bez dowodu, z czerwonym paskiem; dopóki są, pulpit pokazuje je nad dzisiejszym elementem.
• Najbliższy kamień i czego do niego brakuje (z mapy umiejętności).
• Ostatnie dowody (3 miniatury), paczki w drodze, budżet miesiąca (wydane / limit), licznik: dzień X z 56 planu.

2.2 Plan

• Osiem tygodni: temat, wprowadzenie teoretyczne, ćwiczenia dzień po dniu, kamień, punkty (dzisiejsza strona planu, tylko wpięta w nawigację).
• Dzień po dniu: kalendarz 19.10–13.12; każdy dzień ma stan: zaplanowany / zaliczony (z dowodem) / zero / przesunięty / wolny; kliknięcie dnia otwiera kartę dnia (połączenia, biblioteki, zjawisko, dowód, link do slajdów, części z adresami).
• Przesunięcia: gdy tydzień niezaliczony, agent przesuwa plan; strona pokazuje pierwotną i aktualną datę.
• Talie slajdów: lista wszystkich prezentacji (artefakty claude.ai) z datą i zakresem; przy każdym dniu odnośnik do właściwego slajdu.

2.3 Curriculum (ścieżka)

Kamienie M0–M11 i R1–R3 jako droga z zależnościami; przy każdym: projekt na zaliczenie, wymagane węzły z poziomami, stan (zaliczony / w toku / zablokowany przez…), data zaliczenia i dowód. Tory: główny, sztuczna inteligencja, kierunki docelowe (rakieta, satelita). To dzisiejsza zakładka „Ścieżka” + stany z planu.

2.4 Mapa umiejętności

Dzisiejsza mapa (42 węzły, 9 gałęzi, poziomy 0–5, panel węzła z dowodami i „następny poziom wymaga”) oraz tabela. Dochodzi: historia poziomów (wykres: punkty mapy w czasie) i filtr „co podniesie najbliższy kamień”.

2.5 Postępy (dziennik i dowody)

• Oś czasu: wpisy dziennika (jak dziś), każdy z dowodami.
• Galeria dowodów: wszystkie zdjęcia, zrzuty i filmy z historia/dowody/, z datą, do czego są dowodem (dzień planu, węzeł, kamień) i kliknięciem w pełny rozmiar. Zdjęcia z danymi osobowymi (etykiety paczek) oznaczone „lokalnie”, nie publikowane.
• Statystyki: dni z dowodem / bez, seria dni z rzędu, godziny przy stole (z dziennika), punkty mapy na tydzień.

2.6 Warsztat

• Stanowisko: zdjęcie stołu z podpisanymi strefami (mata, lampa, lutownica, pudełka 1–13, półka), lista rzeczy „na biurku” z czesci.yaml.
• Magazyn: dzisiejsza strona (pudełka ze zdjęciami, mapki pól z miniaturami, okno elementu z wizualizacją „gdzie w pudełku”, skąd co jest, co wydrukować, konwencja na slajdach) jako zakładka.
• Części: tabela wszystkich 248 elementów z filtrami (dzisiejsza zakładka „Części”), plus kolumna „używane w dniu/kamieniu”.
• Narzędzia i materiały eksploatacyjne: osobny widok (co się zużywa: cyna, topnik, plecionka, IPA) ze stanem „jest / kończy się / brak” wpisywanym przez agenta na słowo Maćka.

2.7 Budżet

• Wydatki: każde zamówienie (data, sklep, kwota, dostawa, pozycje) z inwentarz.md/czesci.yaml; suma per miesiąc, per kategoria (narzędzia, płytki, czujniki, napędy, materiały, pojemniki, dron), per sklep.
• Koszt kamienia: ile kosztowały części użyte do danego kamienia (np. „pierwszy lot” = dron + XIAO + anteny), liczone z przypisania części do dni planu.
• Planowane: drukarka 3D (1 160 zł, decyzja 22.11), ewentualne woreczki, lampa (w drodze); limit miesięczny ustalony przez Maćka; pasek „wydane / limit”.
• Zasada bata: zakupy części zablokowane, gdy bieżący tydzień niezaliczony; budżet pokazuje to jako kłódkę.

2.8 Inspiracje

Dzisiejsza zakładka (17 pomysłów z etapami i wymaganiami) + dla każdego: „co z tego zrobisz dziś z części, które masz” (liczone z czesci.yaml), koszt brakujących części, powiązanie z kamieniem.

2.9 Wiedza

• Notatki z nauki: lista notatek (drony/notatki/) z datą, tematami i odnośnikami do węzłów mapy; „tematy do wrócenia” (dziś 4) jako osobna lista ze stanem.
• Słowniczek: każde pojęcie użyte na stronie (magistrala dwuprzewodowa, modulacja szerokości impulsu, suma kontrolna…) wyjaśnione jednym akapitem zwykłym językiem; słowa na stronie podkreślone kropkami, dotknięcie pokazuje wyjaśnienie.
• Pytania otwarte: lista pytań Maćka bez odpowiedzi, z datą.

2.10 Zakupy

Zamówienia i paczki (stan: zamówione / nadane / odebrane / sprawdzone z paragonem), opisy ofert (64 strony) i galeria zdjęć produktów; to dzisiejsze „Zakupy” + galeria, wpięte w budżet.

3. Nawigacja i wygląd

• Rama aplikacji jak dziś w Mojej historii (biała rama, lewy pasek z sekcjami: Dziś · Plan · Curriculum · Mapa · Postępy · Warsztat · Budżet · Inspiracje · Wiedza · Zakupy), na telefonie dolny pasek z pięcioma ikonami (Dziś, Plan, Warsztat, Mapa, Więcej).
• Jeden zestaw kolorów i czcionek dla wszystkich zakładek (dziś magazyn i plany mają inne); tryb ciemny; akcent morski, kamienie w kolorze ceglastym.
• Każde zdjęcie klikalne do pełnego rozmiaru. Każda tabela z wyszukiwarką. Druk: mapki na wieczka, karta dnia, plan tygodnia (A4).
• Adresy stron stałe: /wyniki/projekty/robotics/warsztat/#dzis, #plan/2026-10-21, #mapa/i2c, #magazyn/3-B4, #budzet/2026-10. Dzisiejsze adresy (moja-historia, magazyn, plany) przekierowują do nowych.

4. Dane (jedno źródło prawdy)

Generator: jeden skrypt aplikacja/generuj.py buduje całą stronę z tych plików i publikuje (--publikuj), zastępując dzisiejsze cztery generatory. Przebudowa także automatycznie raz dziennie o 6:00 (zadanie cron na serwerze), żeby licznik dni i zaległości były aktualne nawet bez rozmowy.

5. Jak Maciej wchodzi w interakcję

• Czyta i klika: wszystko na stronie. Nie loguje się, niczego nie wpisuje.
• Dowód: wysyła zdjęcie/film/zrzut w rozmowie z agentem (jak dziś). Agent zapisuje plik do dowody/, dopisuje do dni.yaml i dowody.yaml, przelicza punkty, przebudowuje stronę. Czas od wysłania do widocznego punktu: jedna rozmowa.
• Przełożenie, zamiana ćwiczenia, zmiana adresu części, zużyty materiał: jedno zdanie do agenta.
• Etap 3 (opcja): przycisk „wyślij dowód” na karcie dnia, który otwiera aparat telefonu i wysyła plik kanałem, który Maciej wybierze (Telegram po włączeniu, albo rozszerzenie Chrome, które już łapie znaleziska). Do tego czasu kanałem jest rozmowa.

6. Rola agenta („trener”)

• Początek każdej rozmowy: stan planu z dni.yaml (dziś, zaległości, dowód za wczoraj).
• Po każdej sesji: dziennik, dowody, mapa (tylko z dowodem), przebudowa strony, wpis w pamięci długoterminowej.
• Niedziela: punkty tygodnia, decyzja zaliczony/nie, przesunięcia, rozpisanie następnego tygodnia dzień po dniu (karty dni), talia slajdów, gdy tydzień tego wymaga.
• Nowa paczka: adresy w magazynie, opisy ofert, zdjęcia, budżet.
• Nigdy: nie podnosi poziomu bez dowodu, nie kupuje, nie wpisuje danych osobowych.

7. Etapy wdrożenia

1. Etap 1 (ten weekend, 18–19.10): jedna nawigacja i jeden wygląd dla wszystkiego, co już istnieje (Moja historia, Magazyn, oba plany, galeria); pulpit „Dziś” z dzisiejszym elementem, paskiem tygodnia i zaległościami; dni.yaml dla tygodni 1–2; Budżet z inwentarz.md (wydatki per zamówienie, miesiąc, kategoria, limit); przekierowania starych adresów. Stare generatory zostają do czasu równoległej weryfikacji, potem znikają.
2. Etap 2 (do końca tygodnia 2, 1.11): galeria dowodów z przypisaniami, słowniczek z podkreśleniami, koszt kamienia, historia poziomów, stanowisko ze strefami, materiały eksploatacyjne, przebudowa z crona, karty dni dla tygodni 3–8 w miarę rozpisywania.
3. Etap 3 (listopad, po decyzji Maćka): wysyłanie dowodu ze strony, przypomnienia (Telegram po włączeniu), eksport planu tygodnia do PDF, widok „retrospektywa” na koniec planu.

8. Miary, po których poznamy, że działa

• Maciej otwiera „Dziś” każdego dnia planu (licznik otwarć nie jest potrzebny; wystarczy, że dowody przychodzą).
• Od dowodu do widocznego punktu: jedna rozmowa, bez dopytywania „do czego to dowód”.
• Pytanie „gdzie jest X” i „ile wydałem w październiku” ma odpowiedź na stronie bez pytania agenta.
• Żadna informacja nie istnieje w dwóch plikach naraz.

9. Decyzje do podjęcia przez Maćka

1. Nazwa aplikacji: propozycja „Warsztat” (albo zostaje „Moja historia”).
2. Strona startowa portalu: czy „Dziś” ma być pierwszym ekranem całego portalu wyników, czy tylko zakładki robotics.
3. Limit miesięczny budżetu do paska „wydane / limit” (październik: dotąd ok. 2 480 zł bez drukarki).
4. Kanał dowodów w etapie 3: Telegram (wymaga zdjęcia flagi wyłączającej wysyłkę) czy rozszerzenie Chrome.
5. Jawność: portal jest dziś jawny bez hasła; strona będzie zawierać zdjęcia stanowiska i dowody. Zostawiamy, czy włączamy hasło na całą zakładkę.