refactor: complete project structure reorganization and SOP implementation

- Reorganize project structure to unified apps/ directory
  - Move src/backend/ → apps/backend/ (complete .NET Core API)
  - Move src/mobile/ → apps/mobile/ (complete Flutter app)
  - Keep apps/web/ as Vue.js frontend
  - Remove duplicate src/ directory structure

- Implement comprehensive SOP (Standard Operating Procedures)
  - Create sop/ unified management directory
  - Move CLAUDE.md → sop/docs/CLAUDE.md with updated guidelines
  - Move tools/, scripts/, archive/ → sop/ for centralized management
  - Establish three-tier task management architecture

- Create unified task management system
  - Rename TASK_MANAGEMENT.md → TASKS.md for simplicity
  - Integrate 17 UI design tasks from ui-design-tasks.md
  - Update task priority classification (🔥緊急/⚠️重要/📝一般/💡想法)
  - Update ./dl script for new file paths

- Archive obsolete systems and files
  - Archive old reports/ directory (replaced by sop/archive/)
  - Archive duplicate template files violating SOP principles
  - Clean up src/ directory documentation and configs

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
鄭沛軒 2025-09-09 23:53:01 +08:00
parent fc49d3b6d7
commit 9345654cc1
266 changed files with 44402 additions and 41 deletions

View File

@ -77,7 +77,21 @@
"Bash(/Users/jettcheng1018/flutter/bin/flutter run -d Medium_Phone_API_36.0)",
"Bash(/Users/jettcheng1018/flutter/bin/flutter emulators --launch Medium_Phone_API_36.0)",
"Bash(dotnet run:*)",
"Bash(dotnet --version)"
"Bash(dotnet --version)",
"Bash(npm install)",
"Bash(npm install:*)",
"Bash(npm run dev:*)",
"Bash(find:*)",
"Bash(/bashes)",
"Bash(pkill:*)",
"Bash(say:*)",
"Bash(./dl list)",
"Bash(./dl task)",
"Bash(./scripts/file_version_manager.sh:*)",
"Bash(./scripts/archive_file.sh:*)",
"Bash(./scripts/view_archives.sh:*)",
"Bash(tree:*)",
"Bash(./sop/scripts/archive_file.sh:*)"
],
"deny": [],
"ask": []

143
TASKS.md Normal file
View File

@ -0,0 +1,143 @@
# 🎯 Drama Ling 任務清單
## 📋 當前任務
### 🔥 緊急任務
- [ ] 🎨 **語法錯誤訂正頁面** - 完成學習閉環的關鍵頁面 (預估4-6小時)
- 📄 參考: [學習閉環系統](projects/learning-loop-system.md)
- [ ] 🎨 **表達不順訂正頁面** - 語音發音訂正界面 (預估4-6小時)
- 📄 參考: [語音訂正系統](projects/voice-correction-system.md)
- [ ] 💎 **UI_SubscriptionPlans設計** - 訂閱方案選擇頁面,核心商業功能 (預估6-8小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 💳 **UI_PaymentFlow設計** - 付費流程頁面,提升轉換率 (預估6-8小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] ⏰ **UI_TimedDialogue設計** - 300秒限時挑戰界面 (預估6-8小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
### ⚠️ 重要任務
- [ ] 📊 **資料庫schema設計** - 確定用戶表結構和關聯設計 (預估6-8小時)
- 📄 參考: [資料庫設計專案](projects/database-design-project.md)
- [ ] 🔐 **用戶認證流程細節** - 註冊、登入、權限管理流程 (預估4-6小時)
- 📄 參考: [用戶認證系統](projects/user-auth-system.md)
- [ ] 🏆 **UI_RankingDetail設計** - 排行榜詳情頁面,社群競爭功能 (預估4-6小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 🎁 **UI_RewardClaim設計** - 獎勵領取頁面,增強成就感 (預估3-4小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 📋 **UI_BonusMission_Main設計** - 每日任務主頁,提升活躍度 (預估4-6小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
### 📝 一般任務
- [ ] 🎨 **文字輸入彈窗界面** - 替換prompt()的完整UI (預估2-3小時)
- 📄 參考: [UI組件系統](projects/ui-component-system.md)
- [ ] 🔗 **頁面導航連接** - 完善用戶流程導航 (預估2-4小時)
- 📄 參考: [導航系統](projects/navigation-system.md)
- [ ] 🛠️ **特殊情況處理** - 錯誤狀態處理機制 (預估3-4小時)
- 📄 參考: [錯誤處理系統](projects/error-handling-system.md)
- [ ] 📚 **文檔格式統一** - 統一所有文檔格式規範 (預估2-3小時)
- 📄 參考: [文檔規範](projects/documentation-standards.md)
- [ ] 🏷️ **UI組件命名規範** - 建立統一命名標準 (預估1-2小時)
- 📄 參考: [命名規範系統](projects/naming-convention-system.md)
- [ ] 📚 **UI_ReviewCards設計** - 間隔複習卡片界面 (預估4-5小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 📊 **UI_ReviewProgress設計** - 複習進度統計頁面 (預估3-4小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 📅 **UI_ReviewSchedule設計** - 個人化複習排程頁面 (預估3-4小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 🏅 **UI_BadgeCollection設計** - 學習成就徽章收藏頁面 (預估3-4小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 💰 **UI_PurchasedContent設計** - 已購買內容管理頁面 (預估3-4小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 📺 **UI_AdOffer設計** - 廣告獎勵邀請頁面 (預估2-3小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 🎬 **UI_AdViewing設計** - 廣告觀看過程界面 (預估2-3小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
### 💡 未來想法
- [ ] 🔍 **UI功能重複評估** - 分析Result相關UI合併可能性
- [ ] 🎨 **應用圖標和啟動畫面** - 品牌視覺設計
- [ ] ❌ **錯誤處理UI組** - 錯誤、載入、網路異常、維護公告頁面 (預估6-8小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
- [ ] 🎨 **UI設計一致性檢查** - 17個新UI與71個現有UI的統一性檢查 (預估4-6小時)
- 📄 參考: [UI設計任務清單](projects/ui-design-tasks.md)
---
## 📊 快速統計
**當前狀態**:
- 🔥 緊急: 5個任務 (+3個UI設計)
- ⚠️ 重要: 5個任務 (+3個UI設計)
- 📝 一般: 12個任務 (+7個UI設計)
- 💡 想法: 4個任務 (+2個UI設計)
**預估工作量**: 總計 98-132 小時 (包含17個UI設計任務)
---
## 📚 已完成任務 (最近10個)
### 2025-09-09 完成
- [x] ✅ **CLAUDE.md文檔修正** - 修正章節重複、日期過時等結構性問題 ✅ (2025-09-09)
- 📄 專案文檔: [CLAUDE.md問題分析](archive/2025-09-09/225744_claude-md-issues-analysis.md)
- 🔧 解決內容: 章節編號重複、日期過時、工作流程不一致、檔案參考錯誤、問題管理流程混淆
- [x] ✅ **API文檔系統重組** - 移動swagger-ui.html到docs/api/ (已完成)
- [x] ✅ **專案管理系統整合** - 完成三層架構設計 (已完成)
- [x] ✅ **情境學習界面實現** - 完成vocabulary.html的情境學習功能 (已完成)
### 2025-09-08 完成
- [x] ✅ **02_design規格完善** - 建立5個核心功能詳細規格文檔 (已完成)
- [x] ✅ **API模組化文檔** - 完成7個API模組建立 (已完成)
- [x] ✅ **UI設計缺漏修復** - 100%完成40個缺失UI設計 (已完成)
- [x] ✅ **系統整合指南** - 完成INTEGRATION_GUIDE.md (已完成)
- [x] ✅ **工具系統更新** - ./dl命令支援新任務管理系統 (已完成)
- [x] ✅ **CLAUDE工作指南更新** - 整合協作標準和通知系統 (已完成)
- [x] ✅ **問題追蹤系統建立** - ISSUES.md完整問題管理機制 (已完成)
---
## 🛠️ 系統使用指南
### 查看任務
```bash
./dl task # 打開此任務管理文件
./dl status # 查看任務統計
./dl list # 快速查看待辦清單
```
### 工作模式
1. **討論階段**: 與Claude自由討論需求和想法
2. **記錄階段**: Claude自動記錄任務到此系統並創建對應專案詳細文檔
3. **執行階段**: 查看此文件選擇任務批量執行
4. **完成階段**: 標記任務完成 [x],任務自動移至已完成區域
### 任務格式說明
```markdown
- [ ] 🎯 **任務名稱** - 簡短描述 (預估時間)
- 📄 參考: [專案詳細文檔](projects/project-name.md)
```
---
**建立日期**: 2025-09-09
**最後更新**: 2025-09-09 (整合UI設計任務)
**維護者**: Claude Code & Drama Ling Team
---
## 🎨 UI設計專案說明
本任務清單已整合 `projects/ui-design-tasks.md` 中的17個UI設計任務分佈如下
### 🔥 第一優先級 - 核心商業功能 (3個)
- UI_SubscriptionPlans, UI_PaymentFlow, UI_TimedDialogue
### ⚠️ 第二優先級 - 學習體驗增強 (3個)
- UI_RankingDetail, UI_RewardClaim, UI_BonusMission_Main
### 📝 第三優先級 - 學習功能完善 (7個)
- UI_ReviewCards, UI_ReviewProgress, UI_ReviewSchedule, UI_BadgeCollection, UI_PurchasedContent, UI_AdOffer, UI_AdViewing
### 💡 第四優先級 - 輔助功能 (4個)
- 錯誤處理UI組, UI設計一致性檢查
**設計目標**: 完成剩餘17個UI介面從71/88 (81%) 達成100%完整覆蓋

27
apps/README.md Normal file
View File

@ -0,0 +1,27 @@
# Drama Ling Applications
本目錄包含 Drama Ling 專案的所有應用程式。
## 應用程式架構
```
apps/
├── web/ # Vue.js Web 前端應用
├── mobile/ # Flutter 移動端應用
└── backend/ # .NET Core 後端 API
```
## 開發狀態
| 應用程式 | 狀態 | 技術棧 | 說明 |
|---------|------|--------|------|
| Web | ✅ 開發中 | Vue.js + Quasar | Web 前端界面 |
| Mobile | ✅ 開發中 | Flutter + Riverpod | 跨平台移動應用 |
| Backend | ✅ 開發中 | .NET Core + EF Core | REST API 服務 |
## 開發指南
各應用程式的詳細開發文檔請參考:
- 技術文檔:`../docs/04_technical/`
- 專案規格:`../projects/`
- 任務管理:`../TASKS.md`

45
apps/backend/README.md Normal file
View File

@ -0,0 +1,45 @@
# Drama Ling Backend API
.NET Core 後端 API 服務
## 技術棧
- **.NET 8**: 跨平台框架
- **ASP.NET Core Web API**: RESTful API
- **Entity Framework Core**: ORM 資料庫存取
- **PostgreSQL**: 主要資料庫
- **Redis**: 快取和會話管理
- **JWT**: 身份驗證
## 專案結構
```
backend/
├── DramaLing.API/ # Web API 專案
├── DramaLing.Application/ # 應用服務層
├── DramaLing.Core/ # 領域模型層
├── DramaLing.Infrastructure/ # 基礎設施層
├── DramaLing.Tests/ # 測試專案
└── DramaLing.sln # 解決方案檔
```
## 快速開始
### 1. 安裝相依套件
```bash
dotnet restore
```
### 2. 設定資料庫
```bash
# 建立資料庫
dotnet ef database update --project DramaLing.Infrastructure --startup-project DramaLing.API
```
### 3. 啟動開發服務器
```bash
dotnet run --project DramaLing.API
# API: http://localhost:5000
# Swagger: http://localhost:5000
```
## 開發指南
詳細開發文檔請參考:`../../docs/04_technical/`

43
apps/mobile/README.md Normal file
View File

@ -0,0 +1,43 @@
# Drama Ling Mobile App
Flutter 移動端應用程式
## 技術棧
- **Flutter 3.16+**: 跨平台框架
- **Dart 3.0+**: 程式語言
- **Riverpod**: 狀態管理
- **Go Router**: 導航路由
- **Dio + Retrofit**: HTTP 客戶端
- **Hive**: 本地資料存儲
- **Material 3**: UI 設計系統
## 專案結構
```
mobile/
├── lib/
│ ├── core/ # 核心功能 (常數、工具、服務)
│ ├── features/ # 功能模組 (認證、學習、對話等)
│ └── shared/ # 共用組件 (Widget、模型、Provider)
└── pubspec.yaml # Flutter 專案配置
```
## 快速開始
### 1. 安裝相依套件
```bash
flutter pub get
```
### 2. 程式碼生成
```bash
dart run build_runner build
```
### 3. 啟動應用
```bash
flutter run
# 需要模擬器或實體裝置
```
## 開發指南
詳細開發文檔請參考:`../../docs/04_technical/`

View File

Before

Width:  |  Height:  |  Size: 544 B

After

Width:  |  Height:  |  Size: 544 B

View File

Before

Width:  |  Height:  |  Size: 442 B

After

Width:  |  Height:  |  Size: 442 B

View File

Before

Width:  |  Height:  |  Size: 721 B

After

Width:  |  Height:  |  Size: 721 B

View File

Before

Width:  |  Height:  |  Size: 1.0 KiB

After

Width:  |  Height:  |  Size: 1.0 KiB

View File

Before

Width:  |  Height:  |  Size: 1.4 KiB

After

Width:  |  Height:  |  Size: 1.4 KiB

Some files were not shown because too many files have changed in this diff Show More