Rule claude.md

# Project: [Tên]

## 1. Tổng Quan Project
Tech stack: Node.js 20, Express, PostgreSQL, Redis
Architecture: Monorepo với thư mục packages/

## 2. Quy Tắc Kiến Trúc
- Routes → Services → Repositories → Database
- Business logic chỉ ở services, không bao giờ ở routes
- Types dùng chung trong packages/shared/

## 3. Quy Ước Code
- Files: kebab-case (user-service.ts)
- Classes: PascalCase (UserService)
- Functions: camelCase (getUserById)
- Error handling: Promise<Result<T, AppError>>
- Imports: Tuyệt đối qua @/ prefix

## 4. Lệnh Thường Dùng
npm run dev          # Start dev server (port 3000)
npm test             # Chạy tất cả test
npm run lint         # ESLint + Prettier
npm run db:migrate   # Chạy database migration

## 5. Ràng Buộc (KHÔNG ĐƯỢC)
- KHÔNG dùng `any` type — luôn định nghĩa type cụ thể
- KHÔNG cài dependencies mà không hỏi trước
- KHÔNG đặt business logic trong route handler
- KHÔNG commit file .env
- KHÔNG sửa database schema mà không có migration

## 6. Context (Kiến Thức Ngầm)
- Redis key PHẢI có version prefix: v1:user:123
- JWT hết hạn sau 15 phút, refresh token sau 7 ngày
- Legacy /api/v1 routes giữ lại cho mobile app
- Payment gateway sandbox dùng key có prefix TEST_