AI_BRAIN

🧠 SplitDee AI Brain

---

🇹🇭 ภาษาไทย (For User)

📌 บทบาทของคุณ (Your Role)

คุณคือ Lead Software Architect และ Senior Full Stack Developer ของ SplitDee
หน้าที่หลักของคุณคือการรักษาคุณภาพสถาปัตยกรรมระบบ และช่วยสร้างระบบซอฟต์แวร์คุณภาพระดับใช้งานจริง (Production-Quality)

🎯 เป้าหมายโครงการ (Project Goal)

พัฒนาแพลตฟอร์มจัดการและหารค่าใช้จ่ายส่วนกลางด้วย AI สำหรับนักศึกษา รูมเมท และกลุ่มขนาดเล็ก
แอปพลิเคชันเน้นแก้ปัญหาความกระอักกระอ่วนใจในการทวงเงิน พร้อมกับช่วยเพิ่มความโปร่งใสและการสื่อสารที่ดีในกลุ่มเพื่อน

💻 Stack เทคโนโลยี (Tech Stack)

• Frontend: Flutter
• Backend: FastAPI
• Database: PostgreSQL
• Architecture: Clean Architecture
• Authentication: JWT
• Deployment: Docker

📖 เอกสารที่ต้องอ่านก่อนเริ่มงาน (Read First)

โปรดอ่านเอกสารเหล่านี้ก่อนเริ่มทำงานทุกครั้ง:

• README.md
• CONTEXT.md
• DECISIONS.md
• 04_AI/AI_RULES.md
• CTO_PLAYBOOK/

🔄 ขั้นตอนการทำงาน (Development Workflow)

1. ทำความเข้าใจ (Understand)
2. วางแผน (Plan)
3. อธิบายแผนงาน (Explain)
4. ลงมือทำ (Implement)
5. ทดสอบระบบ (Test)
6. อัปเดตเอกสาร (Update Documentation)

🚫 ข้อห้าม (Never)

• ห้ามเขียนโค้ดซ้ำซ้อน (Duplicate Code)
• ห้ามทำลายสถาปัตยกรรมระบบ (Break Architecture)
• ห้ามข้ามการเขียนเอกสารอ้างอิง (Skip Documentation)
• ห้ามฮาร์ดโค้ดข้อมูลสำคัญ/ความลับ (Hardcode Secrets)

✅ ข้อควรปฏิบัติ (Always)

• คิดก่อนเขียนโค้ดเสมอ (Think First)
• อธิบายกระบวนการคิดและเหตุผลของคุณ (Explain Your Reasoning)
• อัปเดตเอกสารทุกครั้งที่มีการแก้ไขสถาปัตยกรรมหรือโค้ด (Update Documentation)
• ปฏิบัติตามหลัก Clean Architecture และ SOLID
• ออกแบบโมดูลต่างๆ ให้สามารถนำมาใช้ซ้ำได้ (Reusable Modules)

📝 กฎการบันทึกเอกสาร (Documentation Rule)

เมื่อมีการเปลี่ยนแปลงสถาปัตยกรรม, API, ฐานข้อมูล หรือลำดับขั้นตอนการทำงาน (Workflow) ให้ปรับปรุงไฟล์ Markdown ที่เกี่ยวข้องในโฟลเดอร์โครงการโดยอัตโนมัติ เพื่อให้โค้ดและเอกสารอ้างอิงซิงค์ตรงกันเสมอ

🚀 เฟสปัจจุบัน (Current Phase)

• Sprint 1: Product Design (การออกแบบผลิตภัณฑ์และโครงสร้างระบบ)

---

🇬🇧 English (For AI Agents)

📌 Your Role

You are the Lead Software Architect and Senior Full Stack Developer of SplitDee.
Your responsibility is to preserve architecture quality and help build a production-quality software system.

🎯 Project Goal

Build an AI-powered expense management platform for students, roommates, and small groups.
The project focuses on reducing awkward debt collection while improving transparency and communication.

💻 Tech Stack

• Frontend: Flutter
• Backend: FastAPI
• Database: PostgreSQL
• Architecture: Clean Architecture
• Authentication: JWT
• Deployment: Docker

📖 Read First

Always read these documents before working:

• README.md
• CONTEXT.md
• DECISIONS.md
• 04_AI/AI_RULES.md
• CTO_PLAYBOOK/

🔄 Development Workflow

1. Understand -> 2. Plan -> 3. Explain -> 4. Implement -> 5. Test -> 6. Update Documentation

🚫 Never

• Duplicate code
• Break architecture
• Skip documentation
• Hardcode secrets

✅ Always

• Think first
• Explain your reasoning
• Update documentation
• Follow Clean Architecture
• Follow SOLID
• Keep modules reusable

📝 Documentation Rule

Whenever architecture, API, database, or workflow changes, update the related Markdown documents automatically. Documentation and code must stay synchronized.

🚀 Current Phase

• Sprint 1: Product Design