📅 PROJECT_PHASE.md - Project Phases & Timeline (เฟสการดำเนินงานโครงการและเส้นทางเวลา)

This document defines the phases, gates, and milestones for the SplitDee platform development.
เอกสารฉบับนี้สรุปเฟสงานทำงาน ข้อกำหนดประเมินผลผ่านขั้น และหมุดหมายสำคัญสำหรับการพัฒนาโครงการ SplitDee


🇹🇭 ภาษาไทย (สำหรับผู้ใช้งาน)

📊 ภาพรวมลำดับการทำงานรายเฟส

  • Phase 1: Product Design & Architecture (ปัจจุบัน): เฟสวางการออกแบบและโครงสร้างหลัก ➔ เกณฑ์ผ่าน: รวบรวมเอกสาร ออกแบบตรรกะ ทำสเกเลตันโค้ด และผ่านการแช่แข็งโครงสร้างระบบ (Architecture Freeze)
  • Phase 2: Core Foundation (เฟสถัดไป): ปูพื้นฐานทางเทคนิค ➔ เกณฑ์ผ่าน: ตั้งการต่อฐานข้อมูลหลัก PostgreSQL, วางสคริปต์ไมเกรชันตารางผ่าน Alembic, รันตู้ Docker และรีแฟคเตอร์ระบบ Auth use cases แก้ไขการทำเลเยอร์รั่วไหล
  • Phase 3: Core Features: เฟสสร้างฟีเจอร์หารเงินและห้องแชท ➔ เกณฑ์ผ่าน: สร้างกลุ่มสมาชิก, จัดตารางเฉลี่ยบิล (แบบเท่ากัน/ยอดเดี่ยว/ร้อยละ), เปิดใช้ห้องแชทส่งข้อความระบบแจ้งข่าว และยิง Push Notifications
  • Phase 4: AI & Gamification Integration: เฟสระบบสแกน OCR และเกณฑ์สัตว์เลี้ยงโมจิ ➔ เกณฑ์ผ่าน: เชื่อมต่อ API ตรวจ Statement ธนาคารภายนอกสำเร็จ, สแกน QR ภาพสลิปออโต้, วางระบบสะสมเลเวล/HP สัตว์เลี้ยง และยิงภาพมีมทวงเงิน AI
  • Phase 5: Launch & Staging: เฟสตรวจสอบคุณภาพและขึ้นโปรดักชัน ➔ เกณฑ์ผ่าน: รัน Unit test ครอบคลุมเกิน 80% ปราศจากบั๊กอันตรายความปลอดภัย, ตั้งใบรับรอง SSL และเปิดเซิร์ฟเวอร์ย่อยใช้งานจริง

🇬🇧 English (For AI Agents)

📊 Gantt Timeline Map

gantt
    title SplitDee Project Timeline & Phases
    dateFormat  YYYY-MM-DD
    section Phase 1: Design
    Architecture & Product Design :active, des1, 2026-07-10, 2026-07-17
    Architecture Freeze Gate      :crit, gate1, 2026-07-17, 1d
    section Phase 2: Foundation
    FastAPI Core Setup & Auth     :active, foundation1, 2026-07-18, 5d
    PostgreSQL Models & Migration :foundation2, 2026-07-23, 4d
    section Phase 3: Core Features
    Expense Management & Splits   :feat1, 2026-07-27, 8d
    In-App Chat & Event Feed     :feat2, 2026-08-04, 6d
    section Phase 4: AI & Game
    AI OCR & Slip Verification    :ai1, 2026-08-10, 10d
    Mochi Gamification Engine    :game1, 2026-08-20, 7d
    section Phase 5: Launch
    Testing & QA Validation       :qa1, 2026-08-27, 5d
    Production Deployment         :devops1, 2026-09-01, 3d

🔑 Phase Definitions & Gates

  • Phase 1: Product Design & Architecture (Current Phase)
    • Objective: Finalize product requirements, ERD, API specs, wireframes, and security guidelines.
    • Gate Criteria: Approve Architecture Freeze. Audit and classify prototype code.
  • Phase 2: Core Foundation
    • Objective: Establish PostgreSQL migrations (Alembic), Docker Compose network, and refactor Auth use cases.
    • Gate Criteria: Unify JWT token rotation and run successful initial database migration scripts.
  • Phase 3: Core Features
    • Objective: Develop groups, bill splits, chat message flow, and push notification integrations.
    • Gate Criteria: Run successful E2E splits and message delivery.
  • Phase 4: AI & Gamification Integration
    • Objective: Integrate slip OCR validation API, group pet Mochi XP/HP engine, and AI reminders.
    • Gate Criteria: SlipOK API validation tests passing. HP cron logic executed.
  • Phase 5: Launch & DevOps
    • Objective: Complete security pen-testing, achieve >80% test coverage, and deploy Nginx SSL on VPS.
    • Gate Criteria: Zero critical security vulnerabilities and production server online.