📦 TÀI LIỆU YÊU CẦU SẢN PHẨM (PRD - PRODUCT REQUIREMENTS DOCUMENT)

Tên sản phẩm: Phanh13 Task Lab & Cognitive Kanban System

Phiên bản: 1.0
Tình trạng: Chờ phê duyệt (Ready for Implementation)
Tài liệu tham chiếu: URD (User Requirements)

1. TỔNG QUAN SẢN PHẨM (EXECUTIVE SUMMARY)

1.1. Mục tiêu (Objective)

Xây dựng một hệ thống quản lý công việc và tối ưu hóa nhận thức (Cognitive Workflow System) bao gồm 2 phân hệ chính:

Task Lab (Hộp xả não & Định hình tư duy): Tiếp nhận câu lệnh thô, phân tích thành 6 bước hành động và cung cấp trạm kiểm duyệt ý tưởng (Validation Checklist).
Cognitive Kanban (Bảng thực thi 4 cột & Đẻ version): Nhận diện bài toán lớn, tự động bóc tách thành subtasks $\le 15$ phút bằng AI, quản lý kéo thả và lưu trữ chiêm nghiệm với cơ chế Version Spawning ( \to v_n$).

1.2. Các chỉ số KPI / Thành công (Product Metrics)

Tốc độ phản hồi AI (Latency): Thời gian phân rã subtasks bằng AI $\le 5$ giây.
Tương tác UI (UI Responsiveness): Tốc độ phản hồi kéo thả, mở modal $\le 0.1$ giây.
Tính trọn vẹn dữ liệu (Data Integrity): Không mất dữ liệu Findings / Evidence khi chuyển đổi giữa các version.

2. KIẾN TRÚC THÔNG TIN & SƠ ĐỒ LUỒNG (USER FLOW & ARCHITECTURE)

2.1. Sơ đồ Luồng Người dùng (End-to-End User Flow)

[1. Nhập Ý Tưởng Thô] │ ▼ [2. AI Phân Tích 6 Bước Tư Duy] ──► [3. Tick Checklist: Problem & Big Idea] │ ▼ [4. Chuyển sang Màn hình Kanban] │ ▼ [5. Bấm '✨ AI Breakdown' (Sinh task ≤ 15')] │ ▼ [6. Kéo Thẻ: Chưa làm ➔ Đang Focus ➔ In Use] │ ▼ [7. Mở Modal Chiêm Nghiệm & Gắn Evidence] │ ▼ [8. Bấm '🚀 Spawn v+1' (Đóng thẻ cũ, đẻ v2)]

3. ĐẶC TẢ CHI TIẾT TÍNH NĂNG (DETAILED FEATURE SPECIFICATIONS)

🎯 MÀN HÌNH 1: TASK LAB (HỘP XẢ NÃO)

3.1. Khung Chat Xả Não (Input Prompt Engine)

Vị trí: Khung nhập liệu cố định ở đáy màn hình.
Tương tác:
- Nhập văn bản tự do (Multi-line text) và bấm nút Send (hoặc phím Enter).
- Khi gửi: Hiển thị hiệu ứng chờ (Thinking State) trong lúc hệ thống bóc tách.
Logic Phân Tích (Parsing Engine): Bóc tách văn bản thành 6 trường dữ liệu:
1. outcome_goal: Mục tiêu cụ thể cần đạt.
2. ools_info: Công cụ, nguồn tin cần dùng.
3. ction_plan_5w1h: Bối cảnh 5W1H (Who, Where, Duration, Deadline, How).
4. skills_resources: Kỹ năng hoặc tài liệu cần chuẩn bị.
5. definition_of_done: Tiêu chuẩn để nghiệm thu kết quả.

eflection_version: Phiên bản ban đầu (Mặc định: 0.1 -> v1.0).

3.2. Thẻ Bài Toán & Trạm Kiểm Duyệt (Task Card & Validation Checklist)

Giao diện thẻ: Thẻ bo góc mềm mại, hiển thị 6 khối nội dung phân chia rõ ràng.
Validation Checklist:
- Checkbox 1: [ ] Đã confirm Problem (Vấn đề) với anh Đắc/Team
- Checkbox 2: [ ] Đã review Big Idea (Ý tưởng) với ChatGPT/Team
- Hành vi: Khi tick vào, chữ chuyển sang màu xanh lá đậm; không khóa thao tác khác (Non-blocking reminder).
Hành động trên thẻ:
- Nút "Mở Kanban" ➔ Điều hướng sang kanban.html?item_id={id} để lọc đúng bài toán đó.
- Nút "Xóa" ➔ Xóa bài toán và xác nhận với người dùng.

🎯 MÀN HÌNH 2: COGNITIVE KANBAN (BẢNG THỰC THI 4 CỘT)

3.3. Thanh Điều Khiển & Bộ Lọc Dự Án (Project Filter Bar)

Dropdown chọn Dự án: Liệt kê toàn bộ các bài toán lớn đã tạo từ Task Lab. Lựa chọn mặc định theo query param item_id.
Nút "✨ AI Breakdown":
- Khi bấm: Gửi request tới AI API với bối cảnh của bài toán đang chọn.
- Trạng thái Loading: Đổi text thành Đang Breakdown... và disable nút.
- Kết quả: Tự động thêm các subtask $\le 15$ phút vào cột "Chưa làm" và refresh lại bảng.
Nút "+ Task 15' mới": Cho phép thêm thủ công 1 subtask nhanh vào dự án hiện tại.

3.4. Bảng Thực Thi 4 Cột (Drag & Drop Board)

Cột 1: 📌 Chưa làm ($\le$ 15'): Chứa các thẻ chờ làm.
Cột 2: 🔥 Đang focus: Chứa tối đa 1 - 2 việc đang tập trung làm ngay.
Cột 3: 🧪 In Use & Audit (Chờ Review): Chứa các thẻ đã xong v0, đang sử dụng thực tế hoặc chờ review với team.
Cột 4: ✅ Đã lưu trữ: Chứa các thẻ hoàn thành hoặc đã spawn version mới.
Quy tắc Kéo thả:
- Cho phép kéo thả thẻ qua lại giữa 4 cột.
- Khi thả vào cột mới: Tự động cập nhật status ( odo, doing, in_use, done) xuống Database qua API PUT.

Kích hoạt: Khi click vào thẻ nằm ở cột In Use & Audit.
Các trường dữ liệu:
1. Evidence (Link chứng minh): Input text nhập link Docs, Figma, URL kết quả.
2. Findings (Học được gì / Lỗi gì): Textarea ghi nhận phản hồi, lỗi thực tế.
3. Next Actions (Cần nâng cấp gì): Textarea kế hoạch cải tiến cho version sau.
Nút bấm hành động:
- "Lưu (Chưa Spawn)": Lưu dữ liệu Evidence & Findings vào thẻ hiện tại, đóng modal.
- "🚀 Spawn Next Version":
  1. Kiểm tra bắt buộc đã điền Findings và Next Actions.
  2. Gửi request POST /task-lab/subtasks/:id/spawn.
  3. Thẻ hiện tại (v1) được đổi status thành done (chuyển sang cột Đã lưu trữ).
  4. Sinh ra 1 thẻ mới ở cột odo với ersion = v2 (hoặc {n+1}$), mang theo nội dung cải tiến.

4. THIẾT KẾ DỮ LIỆU & API (DATA SCHEMA & ENDPOINTS)

4.1. Database Schema (Cloudflare D1 SQLite)

`sql -- 1. Bảng Bài toán lớn CREATE TABLE IF NOT EXISTS task_lab_items ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, outcome_goal TEXT, tools_info TEXT, action_plan_5w1h TEXT, skills_resources TEXT, definition_of_done TEXT, reflection_version TEXT, status TEXT DEFAULT 'pending', created_at DATETIME DEFAULT CURRENT_TIMESTAMP );

-- 2. Bảng Subtasks 15 phút & Chiêm nghiệm CREATE TABLE IF NOT EXISTS task_lab_subtasks ( id INTEGER PRIMARY KEY AUTOINCREMENT, item_id INTEGER NOT NULL, title TEXT NOT NULL, status TEXT DEFAULT 'todo', -- 'todo' | 'doing' | 'in_use' | 'done' version TEXT DEFAULT 'v0.1', evidence TEXT DEFAULT '', findings TEXT DEFAULT '', next_actions TEXT DEFAULT '', created_at DATETIME DEFAULT CURRENT_TIMESTAMP, completed_at DATETIME ); `

4.2. Danh mục API Endpoints

Phương thức	Đường dẫn (Path)	Mục đích
GET	/task-lab/items	Lấy danh sách toàn bộ bài toán lớn
POST	/task-lab/items	Tạo mới một bài toán lớn từ khung xả não
DELETE	/task-lab/items/:id	Xóa một bài toán
POST	/task-lab/items/:id/breakdown	Gọi AI để sinh danh sách subtasks $\le 15'$
GET	/task-lab/subtasks	Lấy toàn bộ subtasks theo bộ lọc
POST	/task-lab/subtasks	Tạo subtask thủ công
PUT	/task-lab/subtasks/:id	Cập nhật trạng thái kéo thả, Findings, Evidence
POST	/task-lab/subtasks/:id/spawn	Đóng băng version cũ và đẻ version mới (+1$)

5. TIÊU CHÍ NGHIỆM THU (ACCEPTANCE CRITERIA - AC)

[x] AC-1: Giao diện tuân thủ bảng màu Healing Green, tỷ lệ font nhỏ thoáng đãng (~13.5px), không có yếu tố gây ngộp mắt.
[x] AC-2: Nhập prompt tự do ở Task Lab phân tích đúng 6 khối nội dung và hiển thị 2 checkbox nhắc nhở.
[x] AC-3: Bấm nút AI Breakdown tạo ra ít nhất 3 - 6 subtasks dưới 15 phút và xuất hiện ngay tại cột "Chưa làm".
[x] AC-4: Kéo thả thẻ mượt mà giữa 4 cột, F5 không bị mất trạng thái.
[x] AC-5: Bấm Spawn Next Version tạo thẻ mới tăng số version chính xác ( \to v2 \to v_n$) và chuyển thẻ cũ vào Lưu trữ.
[x] AC-6: Có hệ thống kiểm thử tự động (Auto-test script) để kiểm tra tính toàn vẹn của API trước mỗi lần bàn giao.

📦 TÀI LIỆU YÊU CẦU SẢN PHẨM (PRD - PRODUCT REQUIREMENTS DOCUMENT) ​

Tên sản phẩm: Phanh13 Task Lab & Cognitive Kanban System ​

1. TỔNG QUAN SẢN PHẨM (EXECUTIVE SUMMARY) ​

1.1. Mục tiêu (Objective) ​

1.2. Các chỉ số KPI / Thành công (Product Metrics) ​

2. KIẾN TRÚC THÔNG TIN & SƠ ĐỒ LUỒNG (USER FLOW & ARCHITECTURE) ​

2.1. Sơ đồ Luồng Người dùng (End-to-End User Flow) ​

3. ĐẶC TẢ CHI TIẾT TÍNH NĂNG (DETAILED FEATURE SPECIFICATIONS) ​

🎯 MÀN HÌNH 1: TASK LAB (HỘP XẢ NÃO) ​

3.1. Khung Chat Xả Não (Input Prompt Engine) ​

3.2. Thẻ Bài Toán & Trạm Kiểm Duyệt (Task Card & Validation Checklist) ​

🎯 MÀN HÌNH 2: COGNITIVE KANBAN (BẢNG THỰC THI 4 CỘT) ​

3.3. Thanh Điều Khiển & Bộ Lọc Dự Án (Project Filter Bar) ​

3.4. Bảng Thực Thi 4 Cột (Drag & Drop Board) ​

3.5. Modal Chiêm Nghiệm & Đẻ Version (Reflection & Version Spawning Modal) ​

4. THIẾT KẾ DỮ LIỆU & API (DATA SCHEMA & ENDPOINTS) ​

4.1. Database Schema (Cloudflare D1 SQLite) ​

4.2. Danh mục API Endpoints ​

5. TIÊU CHÍ NGHIỆM THU (ACCEPTANCE CRITERIA - AC) ​