pos-system/docs/vi/onboarding/new-developer-guide.md

Hướng Dẫn Cho Developer Mới

Chào mừng đến với team GoodGo Microservices Platform!

Checklist Ngày Đầu Tiên

• Quyền truy cập GitHub repository
• Quyền truy cập môi trường development
• Docker đã cài đặt và đang chạy
• Node.js và PNPM đã cài đặt
• IDE đã cấu hình (khuyến nghị VS Code)
• Đã đọc hướng dẫn này

Thiết Lập Môi Trường Development

1. Clone repository

   git clone <repository-url>
   cd Base
   

2. Chạy script khởi tạo

   ./scripts/setup/init-project.sh
   

3. Khởi động infrastructure local

   cd deployments/local
   docker-compose up -d
   

4. Xác minh setup

   • Kiểm tra Traefik: http://localhost:8080
   • Kiểm tra API: http://localhost/api/v1/health

Công Cụ Development

VS Code Extensions Khuyến Nghị

• ESLint
• Prettier
• Prisma
• Docker
• GitLens

Các Lệnh Hữu Ích

# Khởi động tất cả services
./scripts/dev/start-all.sh

# Khởi động service cụ thể
./scripts/dev/start-service.sh auth-service

# Xem logs
./scripts/dev/logs.sh auth-service

# Chạy migrations
./scripts/db/migrate.sh auth-service dev

# Chạy tests
pnpm test

Tiêu Chuẩn Code

• TypeScript: Bật strict mode
• Linting: ESLint với shared config
• Formatting: Prettier
• Commits: Định dạng Conventional Commits
• Tests: Tối thiểu 80% coverage

Tìm Kiếm Trợ Giúp

• Xem Tài Liệu
• Hỏi trong Slack channel của team
• Xem lại các ví dụ code hiện có
• Pair với senior developer

Các Bước Tiếp Theo

1. Chọn một task nhỏ từ backlog
2. Tạo feature branch
3. Implement và test
4. Tạo pull request
5. Nhận code review

Chúc may mắn! 🚀