b104fafa85
- 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.
90 lines
1.8 KiB
Markdown
90 lines
1.8 KiB
Markdown
# 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**
|
|
```bash
|
|
git clone <repository-url>
|
|
cd Base
|
|
```
|
|
|
|
2. **Chạy script khởi tạo**
|
|
```bash
|
|
./scripts/setup/init-project.sh
|
|
```
|
|
|
|
3. **Khởi động infrastructure local**
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# Khởi động tất cả services
|
|
./scripts/dev/start-all.sh
|
|
|
|
# Khởi động service cụ thể
|
|
./scripts/dev/start-service.sh iam-service
|
|
|
|
# Xem logs
|
|
./scripts/dev/logs.sh iam-service
|
|
|
|
# Chạy migrations
|
|
./scripts/db/migrate.sh iam-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](../guides/)
|
|
- 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! 🚀
|