# Cursor Rules cho LADA Express Management Portal

## Tổng quan
Bộ Cursor Rules này được thiết kế đặc biệt cho dự án Vue.js 3 với Vite, giúp AI assistant hiểu rõ cấu trúc và patterns của dự án.

## Danh sách Rules

### 1. project-structure.mdc
- **Áp dụng**: Luôn luôn (alwaysApply: true)
- **Mục đích**: Cung cấp tổng quan về cấu trúc dự án, entry points, và dependencies chính
- **Nội dung**: Mô tả cấu trúc thư mục, routing, state management, và API configuration

### 2. vue-coding-standards.mdc
- **Áp dụng**: Tất cả file .vue và .js
- **Mục đích**: Định nghĩa coding standards cho Vue.js
- **Nội dung**: Component structure, naming conventions, import organization, template best practices

### 3. api-patterns.mdc
- **Áp dụng**: File trong src/services/ và src/infrastructure/
- **Mục đích**: Patterns cho API calls và service layer
- **Nội dung**: Service layer pattern, error handling, loading states, response structure

### 4. component-patterns.mdc
- **Áp dụng**: File trong src/components/
- **Mục đích**: Patterns cho reusable components
- **Nội dung**: Component structure, props/emits, form components, list components, communication

### 5. routing-navigation.mdc
- **Áp dụng**: File trong src/routers/
- **Mục đích**: Patterns cho routing và navigation
- **Nội dung**: Route definition, navigation guards, programmatic navigation, nested routes

### 6. state-management.mdc
- **Áp dụng**: File trong src/stores/
- **Mục đích**: Patterns cho Pinia state management
- **Nội dung**: Store structure, usage trong components, persistence, testing

### 7. styling-css.mdc
- **Áp dụng**: File .css, .scss, và .vue
- **Mục đích**: Guidelines cho styling và CSS
- **Nội dung**: CSS architecture, Bootstrap integration, responsive design, animations

### 8. error-handling.mdc
- **Áp dụng**: Tất cả file .vue và .js
- **Mục đích**: Patterns cho error handling
- **Nội dung**: Global error handling, API errors, component error boundaries

### 9. performance-optimization.mdc
- **Áp dụng**: Tất cả file .vue và .js
- **Mục đích**: Best practices cho performance
- **Nội dung**: Lazy loading, computed properties, virtual scrolling, image optimization

### 10. security-guidelines.mdc
- **Áp dụng**: Tất cả file .vue và .js
- **Mục đích**: Security best practices
- **Nội dung**: XSS prevention, input validation, token management

### 11. page-layout-patterns.mdc
- **Áp dụng**: File trong src/views/
- **Mục đích**: Patterns cho giao diện trang và UI components
- **Nội dung**: Cấu trúc trang chuẩn, search form, data table, modal, date picker, select dropdown

## Cách sử dụng

### Cho AI Assistant
- Rules sẽ được tự động áp dụng dựa trên file patterns và alwaysApply settings
- AI sẽ sử dụng thông tin này để hiểu context và đưa ra suggestions phù hợp

### Cho Developers
- Tham khảo các patterns trong rules khi viết code mới
- Follow các conventions được định nghĩa trong rules
- Update rules khi có thay đổi trong architecture

## Cập nhật Rules

Khi cần cập nhật rules:
1. Chỉnh sửa file .mdc tương ứng
2. Test với AI assistant để đảm bảo rules hoạt động đúng
3. Document changes trong commit message

## Lưu ý
- Rules sử dụng format Markdown với Cursor-specific extensions
- File references sử dụng format `[filename](mdc:path/to/file)`
- Metadata được định nghĩa trong frontmatter YAML
