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>
|
|
@ -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": []
|
||||
|
|
|
|||
|
|
@ -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%完整覆蓋
|
||||
|
|
@ -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`
|
||||
|
|
@ -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/`
|
||||
|
|
@ -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/`
|
||||
|
Before Width: | Height: | Size: 544 B After Width: | Height: | Size: 544 B |
|
Before Width: | Height: | Size: 442 B After Width: | Height: | Size: 442 B |
|
Before Width: | Height: | Size: 721 B After Width: | Height: | Size: 721 B |
|
Before Width: | Height: | Size: 1.0 KiB After Width: | Height: | Size: 1.0 KiB |
|
Before Width: | Height: | Size: 1.4 KiB After Width: | Height: | Size: 1.4 KiB |
|
Before Width: | Height: | Size: 11 KiB After Width: | Height: | Size: 11 KiB |
|
Before Width: | Height: | Size: 295 B After Width: | Height: | Size: 295 B |
|
Before Width: | Height: | Size: 406 B After Width: | Height: | Size: 406 B |
|
Before Width: | Height: | Size: 450 B After Width: | Height: | Size: 450 B |
|
Before Width: | Height: | Size: 282 B After Width: | Height: | Size: 282 B |
|
Before Width: | Height: | Size: 462 B After Width: | Height: | Size: 462 B |
|
Before Width: | Height: | Size: 704 B After Width: | Height: | Size: 704 B |
|
Before Width: | Height: | Size: 406 B After Width: | Height: | Size: 406 B |
|
Before Width: | Height: | Size: 586 B After Width: | Height: | Size: 586 B |
|
Before Width: | Height: | Size: 862 B After Width: | Height: | Size: 862 B |
|
Before Width: | Height: | Size: 862 B After Width: | Height: | Size: 862 B |
|
Before Width: | Height: | Size: 1.6 KiB After Width: | Height: | Size: 1.6 KiB |
|
Before Width: | Height: | Size: 762 B After Width: | Height: | Size: 762 B |
|
Before Width: | Height: | Size: 1.2 KiB After Width: | Height: | Size: 1.2 KiB |
|
Before Width: | Height: | Size: 1.4 KiB After Width: | Height: | Size: 1.4 KiB |
|
Before Width: | Height: | Size: 68 B After Width: | Height: | Size: 68 B |
|
Before Width: | Height: | Size: 68 B After Width: | Height: | Size: 68 B |
|
Before Width: | Height: | Size: 68 B After Width: | Height: | Size: 68 B |