# FORMAT

# Title: Matchmaking Microsite

# Short Description: Microsite chiến dịch “Team Ngọt Ngào và Thanh Dịu”, cho phép người dùng đăng ký thông tin cá nhân, matching tự động, thông báo qua email và quay thưởng.

# Core Purpose: Cung cấp nền tảng ghép đôi tự động dựa trên sở thích và tiêu chí người dùng, quản lý thông báo và trao giải thưởng cho người may mắn.
# Key Features Overview:
#   - Đăng ký hồ sơ người dùng
#   - Ghép đôi tự động với 3 kết quả phù hợp
#   - Thông báo qua email (xác nhận, kết quả, quà tặng)
#   - Trang kết quả tương tác (HTMX)
#   - Quay thưởng và phân bổ quà tặng
#   - **Database Connectivity:** Kết nối PostgreSQL qua biến môi trường (host, port, user, password, dbname)
#   - **Environment Management:** Hỗ trợ development, staging, production
#   - **CI/CD Integration:** Sử dụng DroneCI

## Core Technologies
- Go
- PostgreSQL
- HTMX
- Docker
- Cloud (VPS Storage)
- CI/CD (DroneCI)

# Development Phases
1. **Foundation Setup**:
   - Core infrastructure
   - CI/CD pipeline
   - Database provisioning

2. **Core Components**:
   - Database layer
   - Config management  
   - Logging/Monitoring
   - API framework

3. **Business Features**:
   - User registration
   - Matching engine
   - Notification system

# Architectural Constraints
- Layer Isolation: Tách biệt rõ business logic và infrastructure
- Testability: Components phải testable độc lập
- Environment Parity: Config hoạt động đồng nhất qua các môi trường

# Implementation Order
1. Database Layer → 2. Core Services → 3. API Framework → 4. Business Features

# Target Audience: Cá nhân muốn tham gia chương trình ghép đôi

# Key Document References:
#   - **Roadmap:** ./roadmap.md
#   - **Architecture:** ./architecture.md
#   - **Technical Specifications:** ./spec.md
#   - **Database Schema:** ./schema.md
#   - **Adapters/Connections:** ./adapter.md
#   - **Queries:** ./query.md
#   - **UX/UI Design:** ./ux.md
#   - **Source Code Repository:** [Link to Git Repo]
#   - **Project Management Tool:** [Link to Tool]

# Project Members:
#   - [Member Name 1]: [Role]
#   - [Member Name 2]: [Role]
#   - ...

# (Optional) Reference Projects: [Link hoặc mô tả dự án tương tự]
---