統一數據接口規範 v1.0｜中控台系統基礎

🎯 執行摘要

                主公，TASK-001 已完成！

                統一數據接口規範已設計完成，為中控台系統打下堅實基礎。本規範整合 tasks.json、concepts.json、pendingmemo 三大數據源，建立標準化接口，確保中控台能無縫讀取與操作所有待辦數據。

📊 現有數據源分析

數據源	路徑	數據量	結構類型	狀態
tasks.json	`workskm-deploy/data/`	14 個任務	結構化（完整）	● 優先整合
concepts.json	`workskm-deploy/data/`	8 個構想	結構化（完整）	● 優先整合
pendingmemo	`.workbuddy/pendingmemo/`	2 個（1完成1轉正）	結構化（簡化）	● 次級整合
pendingdata.html	`workskm-deploy/`	靜態頁面	非結構化	● 需轉換

🔧 統一接口設計

1. 通用數據模型（Unified Data Model）

{
  "metadata": {
    "version": "1.0.0",
    "schema": "unified-task",
    "last_updated": "2026-04-19T14:22:00.000Z",
    "source": "tasks|concepts|pendingmemo",
    "total_count": 14,
    "status_summary": {
      "pending": 14,
      "in_progress": 0,
      "completed": 0,
      "blocked": 0
    }
  },
  "tasks": [ ... ]
}
            

2. 標準化任務結構（Standardized Task Schema）

欄位名稱	類型	必填	說明	來源映射
`id`	string	必填	唯一標識符	TASK-XXX / IDEATION-XXX / MEMO-XXX
`title`	string	必填	任務標題	各數據源 title
`description`	string	可選	詳細描述	concepts.description / 手動輸入
`status`	enum	必填	pending/in_progress/completed/blocked	統一映射
`priority`	number	可選	1-5，5為最高	tasks.priority.level / concepts.priority
`phase`	string	可選	所屬階段	tasks.time_management.phase
`deadline`	ISO8601	可選	截止日期	tasks.time_management.deadline
`source_type`	string	必填	數據來源標記	tasks/concepts/pendingmemo
`created_at`	ISO8601	必填	創建時間	各數據源日期
`updated_at`	ISO8601	可選	更新時間	自動生成

🌐 API 接口規範

GET /api/v1/tasks

獲取所有任務列表（統一格式）

參數：

source: tasks|concepts|pendingmemo|all（默認 all）
status: pending|in_progress|completed|blocked
priority: 1-5
phase: Phase 1-4

GET /api/v1/tasks/:id

獲取單個任務詳情

PATCH /api/v1/tasks/:id

更新任務狀態

請求體：

{
  "status": "in_progress",
  "updated_at": "2026-04-19T14:22:00.000Z"
}
                

GET /api/v1/dashboard

獲取中控台儀表板數據

返回：健康度評分、進度統計、高優先級任務、逾期提醒

🔄 數據同步機制

同步策略

                讀取時合併，寫入時分離

                中控台讀取時統一從各數據源合併為標準格式；寫入時根據 source_type 回寫到對應原始文件。

同步流程

啟動加載：讀取 tasks.json、concepts.json、pendingmemo/index.json
格式轉換：將各數據源轉換為統一任務結構
合併去重：按 id 去重，保留最新版本
內存緩存：統一數據存於內存，供中控台實時操作
變更追蹤：標記修改過的任務
持久化：按 source_type 回寫到對應文件

數據映射表

統一欄位	tasks.json 映射	concepts.json 映射	pendingmemo 映射
`id`	task.id	concept.id	memo.id
`title`	task.title	concept.title	memo.title
`status`	status_flow.current	concept.status	memo.status
`priority`	priority.level	concept.priority	固定 3
`phase`	time_management.phase	從分類推導	無
`deadline`	time_management.deadline	無	無

📋 狀態映射規範

統一狀態值

統一狀態	說明	對應 tasks.json	對應 concepts.json	對應 pendingmemo
`pending`	待執行	pending	pending	待確認
`in_progress`	進行中	in_progress	designing	進行中
`completed`	已完成	completed	done	已完成
`blocked`	阻塞中	blocked	-	-

🗺️ 實施路線圖

Phase 1：基礎建設（當前）

✅ TASK-001：設計統一數據接口規範（已完成）
⏳ TASK-002：實現數據同步機制（下一步）
⏳ TASK-003：數據驗證與錯誤處理

Phase 2：智能派生

⏳ TASK-004：設計構想派生規則引擎
⏳ TASK-005：實現自動派生功能
⏳ TASK-006：智能優先級算法
⏳ TASK-007：整合 TED 驅動機制

Phase 3：中控台建置

⏳ TASK-008：中控台頁面架構設計
⏳ TASK-009：實現數據可視化組件
⏳ TASK-010：交互功能開發
⏳ TASK-011：AI 建議助手整合

Phase 4：成長循環

⏳ TASK-012：執行反饋收集機制
⏳ TASK-013：經驗自動沉澱
⏳ TASK-014：循環優化與上線

✅ 結論與下一步

                主公，統一數據接口規範已完成！

                本規範確立了：

                1. 通用數據模型 - 統一 metadata + tasks 結構

                2. 標準化任務結構 - 10 個核心欄位規範

                3. API 接口規範 - 4 個核心接口定義

                4. 數據同步機制 - 讀取合併、寫入分離策略

                5. 狀態映射規範 - 4 種統一狀態值

                下一步：TASK-002 實現數據同步機制

📋 統一數據接口規範 v1.0

🎯 執行摘要

📊 現有數據源分析

🔧 統一接口設計

1. 通用數據模型（Unified Data Model）

2. 標準化任務結構（Standardized Task Schema）

🌐 API 接口規範

🔄 數據同步機制

同步策略

同步流程

數據映射表

📋 狀態映射規範

統一狀態值

🗺️ 實施路線圖

Phase 1：基礎建設（當前）

Phase 2：智能派生

Phase 3：中控台建置

Phase 4：成長循環

✅ 結論與下一步