Files
pos-system/docs/vi/guides/getting-started.md
Ho Ngoc Hai b104fafa85 Refactor auth-service to iam-service and update related documentation
- Renamed auth-service to iam-service across various files for consistency.
- Updated Dockerfiles, deployment configurations, and documentation to reflect the service name change.
- Enhanced testing commands in documentation to point to the new iam-service.
- Removed outdated auth-service files and configurations to streamline the project structure.
- Improved bilingual documentation for clarity on the new service structure and usage.
2025-12-30 20:54:21 +07:00

2.0 KiB

Bắt Đầu

Yêu Cầu

  • Node.js >= 20.0.0
  • PNPM >= 8.0.0
  • Docker & Docker Compose
  • Git
  • Tài khoản Neon (https://neon.tech) - cho database

Thiết Lập Ban Đầu

  1. Clone repository

    git clone <repository-url>
    cd Base
    
  2. Thiết Lập Neon Database

    # Chạy script setup
    ./scripts/db/setup-neon.sh
    
    # Hoặc thủ công:
    # 1. Tạo Neon project tại https://neon.tech
    # 2. Tạo branches: main (dev), staging, production
    # 3. Lấy connection strings
    # 4. Cập nhật deployments/local/.env.local
    

    Xem Hướng Dẫn Thiết Lập Neon để biết chi tiết.

  3. Khởi tạo project

    ./scripts/setup/init-project.sh
    
  4. Khởi động infrastructure (Redis, Traefik - không cần PostgreSQL)

    cd deployments/local
    docker-compose up -d
    cd ../..
    
  5. Chạy database migrations

    ./scripts/db/migrate.sh iam-service dev
    
  6. Seed database

    ./scripts/db/seed.sh iam-service
    
  7. Khởi động tất cả services

    ./scripts/dev/start-all.sh
    

Điểm Truy Cập

Database

Project này sử dụng Neon PostgreSQL cho tất cả môi trường:

  • Development: Neon main branch
  • Staging: Neon staging branch
  • Production: Neon production branch

Không cần PostgreSQL local! Xem Thiết Lập Neon để biết chi tiết.

Các Bước Tiếp Theo