epub-translator-studio

07. Roadmapa i kontrybucje

7.0. Status wdrozenia (2026-02-10)

• M1: zrealizowane.
• M2: zrealizowane.
• M3: zrealizowane (Wiki backend aktywny, opublikowane: Home, _Sidebar, Workflow-and-Recovery).
• M7: domkniete (series manager: termy + style rules + lorebook + historia zmian, prompt augmentation kontekstem serii, orchestrator batch serii z raportem).
• M4: domkniete (ledger orchestration upfront + twardy gate EPUBCheck + tokenized inline editor + dashboard ledger metrics + stale widoczny pasek ledgera + presety promptow Gemini w GUI + telemetry retry/timeout + export metryk do release notes + alert progowy ledgera).
• M5: domkniete (nested-inline chips w edytorze + dodatkowe testy regresji + walidator integralnosci ­/  z raportem po runie).
• M6: domkniete (diff-aware retranslation + semantic diff gate + raport changed/reused/retranslated + auto-findings QA).
• Increment Async I/O: wdrozony bezpieczny etap preflight (Health check I/O providerow + Health check all (async) pluginow), pelny async dispatch translacji pozostaje kolejnym krokiem.
• M3-M7: issue i milestone na GitHub domkniete (cleanup statusow wykonany).
• M8: domkniete na GitHub (issue: #45, #46, #47, #48, #49 sa zamkniete; milestone zamkniety).
• M9: domkniete (#51 zamkniete jako umbrella; zakres rozbity na M10).
• M10: domkniete na GitHub (#53, #54, #55 zamkniete; milestone zamkniety).
• Security hardening (CI/repo): wdrozone (CodeQL, Dependabot updates, gate HIGH,CRITICAL, blokujacy gate CVE dla pip-audit).

7.1. Priorytety techniczne

1. Memory-first translation: cache segmentow + reuse po hashu.
2. Human-in-the-loop: pamiec zatwierdzonych decyzji redaktora.
3. EPUB-aware segmentacja i integralnosc markup (­, inline tags).
4. Smart retranslation: diff-aware + semantic diff gate do recenzji.

7.2. Priorytety produktowe

1. Mniejszy koszt API i krotszy czas przez agresywny reuse cache.
2. Adaptacyjne podpowiedzi stylu/terminow z decyzji redaktora.
3. Recenzja tylko zmian o realnej roznicy semantycznej.
4. Spojnosc stylu miedzy tomami jednej serii (batch/library) - fundament techniczny juz dodany.

Aktualny increment M4 (wdrozony):

1. mini-dashboard ledgera (done/processing/error/pending) widoczny stale w sekcji Uruchomienie,
2. presety promptow pod provider/mode z gotowymi recepturami Gemini,
3. telemetry retry/timeout per provider (Google/Ollama) w runtime metrykach,
4. alert progowy ERROR > N przy pasku ledgera,
5. export metryk runu/ledgera do sekcji release notes (Studio Tools -> Dashboard),
6. testy jednostkowe logiki presetow.

7.3. Jak zglaszac zmiany

• Bug: przez Issue (template bug_report)
• Feature: przez Issue (template feature_request)
• Kod: przez Pull Request

W PR podaj:

• co zmieniasz,
• dlaczego,
• jak testowales,
• czy dotyka to workflow krytycznych.

7.4. Standard PR

PR powinien byc:

• maly i skupiony,
• z jasnym celem,
• z testowalnym efektem,
• z dokumentacja gdy zmienia sie sposob uzycia.

7.5. Release discipline

Dla kazdego release:

1. podsumowanie zmian,
2. lista ryzyk,
3. instrukcja migracji (jesli potrzeba),
4. jasne CTA do feedbacku.

7.6. Sponsoring i utrzymanie

Jesli projekt oszczedza czas:

• wesprzyj: https://github.com/sponsors/Piotr-Grechuta
• zglaszaj regresje i pomysly,
• pomoz dopracowac dokumentacje i testy.

7.7. Definicja sukcesu roadmapy

• mniej regresji po merge,
• krotszy czas od bug report do fix,
• mniejsza liczba problemow z konfiguracja,
• szybszy onboarding nowego urzadzenia.

7.8. Kolejne milestone’y (M8-M10 domkniete)

1. M8#45: DONE.
2. M8#46: DONE.
3. M8#47: DONE.
4. M8#48: DONE.
5. M8#49: DONE.
6. M9#51: DONE (zamkniete jako umbrella; scope podzielony na M10).
7. M10#53: DONE (Prompt Router).
8. M10#54: DONE (Easy Startup).
9. M10#55: DONE (Reliability UX).

Zakres i kryteria Done sa utrzymywane w:

• docs/09-Backlog-do-uzgodnienia.md

This site is open source. Improve this page.