matching_app/docs/general.md
2025-05-02 15:12:18 +07:00

70 lines
2.3 KiB
Markdown

# 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ự]
---