Commit Graph

2 Commits

Author SHA1 Message Date
鄭沛軒 937f6994eb feat: restructure API specifications into modular architecture
Major refactoring of API documentation for better maintainability:

## New Modular Structure
- Split 2400+ line monolithic API spec into 10 focused modules
- Created centralized navigation at docs/04_technical/api/README.md
- Each module now 200-400 lines for easier maintenance

## Completed API Modules (7/10)
-  Authentication & Authorization API (JWT, OAuth, permissions)
-  User Management API (profiles, stats, achievements)
-  Dialogue Practice API (scenarios, AI analysis, assistance)
-  Subscription System API (in-app purchases, permissions)
-  Daily Missions API (tasks, progress, rewards)
-  Error Handling (comprehensive error codes)
-  Common Standards (RESTful principles, formats)

## Updated Specifications
- Third-party integration spec with iOS/Android in-app purchases
- API completion plan with 3-phase development strategy
- Organized processed requirements in 已處理/ folder

## Technical Improvements
- 35+ API endpoints fully documented with examples
- 11 error categories with handling guidelines
- Unified response formats and security standards
- Team-friendly parallel development structure

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-07 13:29:26 +08:00
鄭沛軒 945c7f8530 docs: update comprehensive documentation with new learning system features
- Add vocabulary learning system with recognition→familiarity→dialogue→review progression
- Add life points system (命條系統) with 5-hour auto-recovery mechanics
- Add spaced repetition algorithm using 2^review_count formula
- Add reply assistance system with 3-layer architecture and Google Translate integration
- Add 13-stage learning progression with sequential unlocking
- Update user flow specification with complete learning flows including life points checks
- Update AI algorithm specs with vocabulary learning modules
- Update business logic with comprehensive gamification mechanics
- Update content management with vocabulary data structures
- Update system schema with new data bindings: Vocabulary, VocabularyReview, LifePoints, ContinuousLearning, TimeWarp
- Add requirement documents for vocabulary review, vocabulary learning stages, scenario dialogue, and challenge learning
- Remove deprecated UI mockup images from 05_views directory

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-06 19:36:57 +08:00