Nền tảng Giai đoạn 1 MVP Quản lý Doanh nghiệp Địa phương

# MVP Giai đoạn 1 — Nền tảng (Foundation)

## Mục tiêu

Tạo dựng nền tảng kỹ thuật cho Hệ thống Quản lý Doanh nghiệp Địa phương (Local Business Management System).

CHƯA triển khai các tính năng nghiệp vụ kinh doanh ở giai đoạn này.

Mục tiêu là có được một ứng dụng Go gọn gàng, sạch sẽ, đáp ứng các việc sau:

1. Khởi chạy thành công
2. Tải cấu hình (configuration)
3. Kết nối tới PostgreSQL
4. Chạy di trú cơ sở dữ liệu (database migrations)
5. Cung cấp một HTTP API
6. Có ghi nhật ký có cấu trúc (structured logging)
7. Có kiểm tra sức khỏe hệ thống (health checks)
8. Có cơ chế khởi động và tắt ứng dụng an toàn, gọn gàng (clean startup/shutdown)

## Ngăn xếp Công nghệ (Stack)

* Go
* PostgreSQL
* HTTP REST API
* Di trú cơ sở dữ liệu bằng SQL (SQL migrations)
* Hệ thống biến môi trường / cấu hình
* Ghi nhật ký có cấu trúc (Structured logging)

## Cấu trúc Thư mục Ban đầu

```text
cmd/
  server/
    main.go

internal/
  platform/
    config/
    database/
    http/
    logging/

  core/

migrations/

api/

go.mod
```

## Điểm cuối (Endpoint) Bắt buộc

```http
GET /health
```

Phản hồi kỳ vọng:

```json
{
  "status": "ok",
  "database": "ok"
}
```

## Yêu cầu Kỹ thuật

Triển khai cơ chế tắt ứng dụng an toàn (graceful shutdown).

Kết nối cơ sở dữ liệu bắt buộc phải sử dụng cơ chế gom nhóm kết nối (connection pooling).

Cấu hình phải được lấy từ các biến môi trường / tệp cấu hình thay vì gắn cứng (hardcode) các giá trị trong mã nguồn.

Tạo một cơ chế di trú (migration) có khả năng nâng cấp và thay đổi lược đồ (schema) PostgreSQL một cách an toàn.

Chưa tạo kiến trúc mô-đun/plugin ở giai đoạn này ngoài cấu trúc tối thiểu cần thiết để giữ cho ranh giới giữa các thành phần trong tương lai được rõ ràng.

## Sản phẩm Bàn giao (Deliverable)

Một máy chủ Go chạy cục bộ được kết nối thành công tới PostgreSQL với cấu trúc dự án sạch sẽ và hệ thống chạy migration hoàn chỉnh.

Không thêm bất kỳ thứ gì khác.