🗂️ SplitDee Vault Index
Welcome to the SplitDee engineering knowledge base. This index provides a complete structural overview of all documents in the vault, categorized by domain and function.
🗺️ System Maps & Core Files
- ARCHITECTURE_FREEZE_REPORT - Gate 1 review and formal approval for production development.
- PROJECT_STATUS - Real-time sprint dashboard and frozen milestones.
- PROJECT_HEALTH_REPORT - Overall project health, metrics, scores, and risks.
- README - Project introduction, mission, and folder summary.
- Dashboard - Current sprint status, developer focus, and quick shortcuts.
- CONTEXT - Bilingual sprint status, decisions, and next tasks.
- DECISIONS - Core architecture decisions (FastAPI, Flutter, PostgreSQL, Clean Architecture).
- MEMORY - Project parameters, coding languages, and configurations.
- ROADMAP - Sprint breakdowns and feature schedules.
- TASK_LOG - Detailed backlog of completed, active, and upcoming items.
- SYSTEM_MAP - Complete layout of system modules and data flows.
- Project Phases - Timeline, Gantt chart, and gates definitions.
- Glossary - Definitions of core project terms.
📦 01_Product (Product & Requirements)
- Product Overview - Name, description, philosophy, and target users.
- Vision - Core values, philosophy, and long-term directions.
- Problem Statement - Key user pain points and SplitDee solutions.
- User Persona - Persona profiles (Didi the student and Bank the office worker).
- Feature List - Details on expense splits, AI verification, chat, and gamification.
- Functional Requirements - Mandatory functional checklist (FRs).
- Non-Functional Requirements - Compliance, security, and performance criteria (NFRs).
- Use Cases - Actor specifications and interaction flows.
- Domain Model - Ubiquitous language, entity attributes, validations, and constraints.
- Business Rules - Comprehensive ledger of math equations, limits, and approval policies.
🎨 02_UX (User Interface & Screens)
- Screen Flows - Navigation diagrams, ASCII wireframes, and UI state logic.
- UI Mockup Prompts - Midjourney and DALL-E 3 prompts for generating UI layouts.
🏛️ 03_System (Architecture & Design)
- System Architecture - Clean Architecture layers (domain, use case, infra, presentation).
- Database Design - Mermaid ERD, table definitions, and index strategies.
- API Design - RESTful endpoint routing, Pydantic schemas, and error codes.
- Security Policy - Cryptography standards, CORS, and double-spend protection.
- Component Diagram - Module interfaces and backend/frontend components.
- Deployment Architecture - Network topography, ingress proxies, and container setups.
- Sequence Diagrams - Auth flows, bill splits, and OCR validations.
- State Machines - Mermaid state diagrams for Bill, Payment, and Pet lifecycles.
- Domain Events - Event triggers, sources, and expected results.
- Permission Matrix - Role-Based Access Control (RBAC) authorization matrix.
- Notification Strategy - Push priorities, exponential backoff, and LINE/FCM integrations.
- Error Handling - Recovery strategies, offline sync, and race condition mitigations.
📜 Architecture Decision Records (ADRs)
- ADR-001 FastAPI - Selection of backend runtime environment.
- ADR-002 PostgreSQL - Choice of relational database system.
- ADR-003 Flutter - Selection of cross-platform mobile client framework.
🛠️ 05_Development (Standards & DevOps)
- Coding Standards - PEP 8 Python and Dart conventions, branch strategy, commit templates.
- Deployment Guide - Docker Compose, SSL, backup policies, and disaster recovery.
🧪 06_Testing (QA & Testing)
- Testing Strategy - Pytest configurations, Flutter widget tests, coverage gates.
💼 00_Project (Project Management & Audits)
- Project Management - Risk register summary, technical debt log, assumptions, constraints.
- Risk Register - Detailed security, financial, technical, and adoption risks.
- Architecture Review - Clean Architecture boundary leak evaluations.
- Implementation Status - Classification of source files (Accepted, Needs Refactor).
- Freeze Checklist - Domain freeze checklist.
- Open Questions - List of unresolved vendor and technical decisions.
- Next Sprint - Sprint 2 backlog and auth refactoring tasks.
🧠 AI Agent Instructions
- AI_RULES - Guidelines and rules for AI developers.
- AI_BRAIN - Project roles, goals, and sprint settings.
- AI_PERSONA - Tone, autonomy level, and ownership principles.
- AI_WORKFLOW - Step-by-step document update workflow.
- HOW_CHATGPT_THINKS - Fundamental software design philosophies.
- AI_SESSION - Current/most recent session summary.
- PROMPTS - Core prompt templates for development tasks.
- AI Architecture - OCR pipeline, prompts, and safety instructions.
🗄️ Archive (Obsolete / Developer Sessions)
- MISSION_NEXT - Legacy developer task checklist.
- MISSION_RULES - Pre-CTO playbook session constraints.
- WAKE_UP - Daily boot-up developer instructions.
- CTO_NOTES - Casual developer architecture ideas.