Anki Study Report

Локальное расширение для Anki 26.05+: Python runtime собирает и анализирует учебные данные, а React/TypeScript dashboard показывает их в защищённом локальном интерфейсе.

Проект находится в активной разработке. Актуальная версия и пользовательская история изменений находятся в anki_study_report/version.py и CHANGELOG.md.

Что уже есть

• локальные страницы Today, Activity, Statistics/FSRS, Decks, Search, Cards и Profile;
• рабочее пространство Inspection Profiles с базовым и расширенным редактированием, проверкой и сохранением настроек;
• явный цикл безопасного действия и повторной проверки одной проблемной карточки;
• безопасные действия и bounded API без прямого доступа frontend к Anki collection;
• token-protected dashboard только на 127.0.0.1;
• sanitizer и Shadow DOM для предпросмотра карточек без JavaScript execution surface;
• Fast CI, exact package handoff и real-Anki Docker E2E на трёх committed APKG;
• доказательства с проверяемой схемой для прогресса, ошибок, предварительных проверок, отмены и идентичности нерелизной сборки;
• каноническая итоговая сводка real-Anki E2E, bounded 90-day history и observational-only regression reporting;
• repository-owned exact Cards AV/audio/media gate с self-verifying evidence.

Куда идти дальше

Архитектура в одном экране

flowchart LR
    A[Anki add-on<br/>Python runtime] --> B[Bounded local API]
    B --> C[React / TypeScript dashboard]
    A --> D[Markdown / HTML report]
    C --> E[Loopback only<br/>Token protected]
    A --> F[Anki collection]
    C -. no direct collection access .-> F

Основные каталоги:

anki_study_report/   Python add-on, runtime и API
web-dashboard/       Vite + React + TypeScript
tests/               Python и contract tests
scripts/             build, package и verification
docker/anki-e2e/     real-Anki Desktop E2E
docs/                актуальные контракты
roadmap/             треки, зависимости и критерии
reports/             исторические отчёты и evidence

Текущее направление

• Core: C1 и C2 завершены. Inspection Profiles полностью интегрированы, Cards прошли приёмку и получили адаптивную desktop-компоновку с сохранением фильтров в текущей сессии. Следующий отдельный этап — C3 UI & Shell; он ещё не начат.
• Platform / CI: E2E-I1–E2E-I6 завершены; следующий Platform/CI этап не активирован автоматически и требует отдельного измеренного trigger.
• Остальные треки: Gamification, Operations, Identity и Extensions независимы или условны и не блокируют Core без явной зависимости.

Точные статусы и критерии находятся в roadmap; run IDs, SHA и исторические результаты — в reports.

Основные инварианты

1. Frontend не читает Anki collection напрямую.
2. Dashboard остаётся loopback-only и token-protected.
3. Payload и публичное поведение меняются синхронно между backend, frontend types, tests и docs.
4. Sanitizer, media validation, action allowlists и preview isolation не ослабляются ради удобства.
5. Generated assets, logs, screenshots, profile data, tokens, .ankiaddon и E2E outputs не коммитятся.
6. Release, merge и публикация — отдельные явно одобряемые действия.
7. Real-Anki Docker E2E является integration gate, а не обычным циклом отладки.

Основные команды

Canonical non-Docker check:

.\scripts\run_full_check.ps1 -SkipDocker

Package validation:

node scripts/run_python.mjs scripts/package_addon.py --check

Полный Docker E2E запускается только когда это оправдано риском изменения:

.\scripts\run_full_check.ps1 -CleanDocker

Лицензия

Проект распространяется по лицензии GPL-3.0-only.