4 Commits
Author SHA1 Message Date
brunoandClaude Sonnet 4.5 0a79d7de9a Add requirements specification v2.1 - production-ready version
This v2.1 represents comprehensive engineering improvements based on
three expert reviews and technical feasibility research (2026 latest tech stack).

Major improvements over v2.0:

**Data Consistency** ⭐
- wrong_count completely driven by attempts (no manual updates)
- Enforced rule: any "correct/wrong/unknown" action must create an attempt
- Provides rebuild_wrong_counts repair tool

**Offline Architecture Clarification** ⭐
- Online: PostgreSQL FTS + pg_jieba
- Offline: SQLite FTS5 + trigram tokenization
- Event Sourcing sync strategy (incremental action logs)
- Outbox queue + idempotency + conflict resolution

**FSRS Replaces SM-2** ⭐
- Using dart-fsrs v2.0.0 (official package)
- More scientific than SM-2 (adopted by Anki)
- Boundary conditions: ease_factor[1.3,2.8], max_interval=90 days
- Anti-gaming mechanisms (prevent same-day double attempts)

**Multi-question Segmentation Strategy** ⭐
- P0 (MVP): Manual box selection + intelligent hints (stable)
- P1 (Week 5-8): Auto-segmentation via PP-DocLayoutV3
- "Puzzle-style adjustment": drag boundaries with auto-snap
- Significantly reduces MVP risk (4-week delivery)

**Strict KPI Metrics** ⭐
- Cohort definition: Week 1 questions tracked to Week 4
- "Second review" definition: ≥24 hours interval, review_mode='daily_review'
- "Heavy wrong" definition: attempts wrong ≥3 on different dates
- All metrics aggregatable from attempts/review_sessions tables

**Latest Tech Stack (2026)** ⭐
- PP-OCRv5 (May 2025, +13% accuracy)
- PP-FormulaNet_plus-M (Chinese formula BLEU 89.76%)
- PP-DocLayoutV3 (Jan 2026, non-planar document support)
- PostgreSQL + pg_jieba (online FTS)
- SQLite FTS5 (offline FTS)
- FSRS via dart-fsrs v2.0.0
- pHash image fingerprinting + TF-IDF text similarity

**UX Optimizations** ⭐
- Anti-cheating: 3-second delay or key value input for "Got it" button
- Anti-frustration: Show hints/tips before full answer on "Don't know"
- Puzzle-style adjustment for manual question segmentation
- pHash first-pass deduplication (instant, OCR-error proof)

**Gamification Prep** ⭐
- Database schema reserves: points, current_streak, longest_streak
- badges and user_badges tables
- P2 implementation ready

**MVP Degradation Paths** ⭐
- Every P0 feature has minimum viable standard defined
- Clear fallback options if auto-features fail
- 4-week delivery risk significantly reduced

Addresses all critical feedback from:
- Expert Review 1 (S-grade): UX details, sync strategy, gamification
- Expert Review 2 (Tech feasibility): Data consistency, offline arch, MVP scope
- Expert Review 3 (Tech research): Latest 2026 tech stack

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
2026-02-09 22:41:58 +08:00
brunoandClaude Sonnet 4.5 5198371250 Add requirements specification v2.0 based on expert reviews
This v2.0 version represents a major architectural redesign based on
comprehensive reviews from Claude Opus 4.6, ChatGPT 5.2 Pro, and Gemini 3 Pro.

Key improvements:
- Core philosophy shift from "error management tool" to "learning efficiency improvement system"
- Added spaced repetition system (SuperMemo SM-2 algorithm) as P0 priority
- Added practice/self-test mode with retrieval practice
- Added structured error cause taxonomy system
- Technical stack optimizations (Elasticsearch → PostgreSQL FTS for MVP)
- New database tables: attempts, error_tags, review_sessions
- Learning effectiveness KPIs and acceptance criteria
- Comprehensive exception handling section
- Risk mitigation strategies

Addresses all critical feedback regarding learning efficiency mechanisms,
behavioral change support, and MVP scope optimization.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
2026-02-09 22:22:23 +08:00
bruno 02a9df4c88 docs: 添加项目交付文档 2026-02-09 21:17:47 +08:00
brunoandClaude Sonnet 4.5 b2cc88aa6a 初始提交: 错题集应用核心功能实现
功能特性:
- ✅ 完整的后端API (FastAPI)
- ✅ 图片处理管线 (PaddleOCR + OpenCV)
- ✅ 手写去除功能
- ✅ Elasticsearch全文搜索
- ✅ MinIO对象存储集成
- ✅ Flutter跨平台前端架构
- ✅ Riverpod状态管理
- ✅ Docker容器化部署

技术栈:
- 后端: Python 3.9+, FastAPI, PostgreSQL, Elasticsearch, Redis
- 前端: Flutter 3.0+, Dart, Riverpod
- 图像处理: PaddleOCR, OpenCV
- 基础设施: Docker, MinIO

完成度:
- 后端核心功能: 85%
- 图片处理: 100%
- 前端数据层: 100%
- 前端UI: 20%

文档:
- 需求规格说明书
- 技术设计文档
- API接口文档
- 实施进度文档
- 快速启动脚本

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
2026-02-09 19:53:45 +08:00