matching_app/docs/test_steps.md

Test Steps for Milestone 2: Core Components Setup & API Infrastructure

1. Folder Structure Verification

• Kiểm tra cấu trúc thư mục dự án theo chuẩn architecture.md
• Đảm bảo các package chính: internal/adapter, internal/helper, internal/uiux

2. Config Loader

• Test đọc cấu hình từ file YAML
• Test override giá trị qua biến môi trường
• Xác minh config trả về đúng cấu trúc

3. Logging System

• Kiểm tra khởi tạo Zap logger
• Ghi log thử các mức (info, warn, error)
• Đảm bảo log xuất hiện đúng format

4. Database Connection Pool

• Test kết nối đến PostgreSQL
• Kiểm tra pool hoạt động (nối nhiều connection)
• Xử lý lỗi khi cấu hình DB sai
• Test invalid connection string
• Test valid connection

5. Error Handling

• Kiểm tra các loại error (NotFound, InvalidInput, Unauthorized, Internal)
• Đảm bảo error được log đúng và trả về HTTP status phù hợp

6. Health Check Endpoint

• Gọi API /health kiểm tra trạng thái hệ thống
• Test trường hợp DB lỗi, API trả về unhealthy
• Test health endpoint returns 200
• Test response contains status

7. Middleware

• Kiểm tra logging middleware (log request, response)
• Kiểm tra error middleware (ghi lại error phát sinh)

8. Router Structure

• Đảm bảo các route cơ bản đã đăng ký
• Health check endpoint hoạt động

9. API Documentation

• Kiểm tra tài liệu API (Swagger/OpenAPI nếu có)

Test Results - 2025-04-29

✅ Database Connection: Passed ✅ Health Check: Passed ✅ Config Loader: Passed

Các component cốt lõi đã sẵn sàng cho Milestone 3

---

Ghi chú:

• Nên thực hiện cả unit test, integration test và manual API test cho từng bước trên.
• Ghi lại kết quả test, lỗi phát hiện và hướng xử lý nếu có.