chore: update project documentation, audit reports, and initialize IDE configuration files

docs/audits/TEST_FILES_INDEX.md

@@ -1,217 +1,216 @@
-# 📑 Index: Admin Module Missing Test Files Analysis
+# 📑 Mục lục: Phân tích Tệp Kiểm thử Còn thiếu của Module Admin
 
-## 📌 Document Overview
+## 📌 Tổng quan Tài liệu
 
-Three comprehensive documents have been created to guide you in writing tests for the 3 missing handler/listener files in the admin module:
+Ba tài liệu toàn diện đã được tạo ra để hướng dẫn bạn viết kiểm thử cho 3 tệp handler/listener còn thiếu trong module admin:
 
 ### 1. **ADMIN_MODULE_TEST_ANALYSIS.md** (25 KB)
-**Purpose:** Complete reference guide with all source code and patterns
+**Mục đích:** Tài liệu tham khảo đầy đủ với toàn bộ mã nguồn và các mẫu
 
-**Contains:**
-- ✅ Full source code of all 3 untested files
-- ✅ All associated command/query classes
-- ✅ Complete working test files for reference (approve-listing, ban-user, user-banned)
-- ✅ Detailed interface definitions
-- ✅ Complete file structure of admin module
-- ✅ Step-by-step testing recommendations
-- ✅ Test writing checklist
+**Nội dung:**
+- ✅ Toàn bộ mã nguồn của 3 tệp chưa được kiểm thử
+- ✅ Tất cả các lớp command/query liên quan
+- ✅ Các tệp kiểm thử hoạt động hoàn chỉnh để tham khảo (approve-listing, ban-user, user-banned)
+- ✅ Định nghĩa interface chi tiết
+- ✅ Cấu trúc tệp đầy đủ của module admin
+- ✅ Khuyến nghị kiểm thử từng bước
+- ✅ Danh sách kiểm tra viết kiểm thử
 
-**Best for:** Reading through the full context and examples
+**Phù hợp nhất để:** Đọc qua toàn bộ ngữ cảnh và các ví dụ
 
 ---
 
 ### 2. **DETAILED_HANDLER_COMPARISON.md** (15 KB)
-**Purpose:** Side-by-side comparisons and test code walkthroughs
+**Mục đích:** So sánh song song và hướng dẫn đọc mã kiểm thử
 
-**Contains:**
-- ✅ File structure comparisons
-- ✅ Side-by-side handler code comparison (approve vs reject)
-- ✅ Test code walkthrough with annotations
-- ✅ How to adapt existing tests for new handlers
-- ✅ Query handler patterns explained
-- ✅ Listener comparison tables
-- ✅ Complete test examples ready to adapt
+**Nội dung:**
+- ✅ So sánh cấu trúc tệp
+- ✅ So sánh mã handler song song (approve vs reject)
+- ✅ Hướng dẫn đọc mã kiểm thử có chú thích
+- ✅ Cách điều chỉnh các kiểm thử hiện có cho handler mới
+- ✅ Giải thích các mẫu query handler
+- ✅ Bảng so sánh listener
+- ✅ Ví dụ kiểm thử hoàn chỉnh sẵn sàng để điều chỉnh
 
-**Best for:** Understanding the patterns and adapting test code
+**Phù hợp nhất để:** Hiểu các mẫu và điều chỉnh mã kiểm thử
 
 ---
 
 ### 3. **QUICK_REFERENCE.md** (3 KB)
-**Purpose:** Fast lookup while writing tests
+**Mục đích:** Tra cứu nhanh khi đang viết kiểm thử
 
-**Contains:**
-- ✅ 3 files at a glance with all key details
-- ✅ Location and pattern to follow for each
-- ✅ Mock setup templates
-- ✅ Test coverage checklist
-- ✅ High-level overview
+**Nội dung:**
+- ✅ 3 tệp tổng quan với tất cả thông tin chi tiết quan trọng
+- ✅ Vị trí và mẫu cần tuân theo cho từng tệp
+- ✅ Mẫu thiết lập mock
+- ✅ Danh sách kiểm tra độ phủ kiểm thử
+- ✅ Tổng quan cấp cao
 
-**Best for:** Quick lookup while actively coding tests
+**Phù hợp nhất để:** Tra cứu nhanh khi đang tích cực viết mã kiểm thử
 
 ---
 
-## 🎯 The 3 Missing Test Files
+## 🎯 3 Tệp Kiểm thử Còn thiếu
 
 ### 1. reject-listing.handler.spec.ts
-**Type:** Command Handler Test
-**Location:** `apps/api/src/modules/admin/application/__tests__/`
-**Reference Pattern:** `approve-listing.handler.spec.ts`
-**Complexity:** Medium
+**Loại:** Kiểm thử Command Handler
+**Vị trí:** `apps/api/src/modules/admin/application/__tests__/`
+**Mẫu tham khảo:** `approve-listing.handler.spec.ts`
+**Độ phức tạp:** Trung bình
 
-**Key Testing Points:**
-- Happy path: Successfully reject PENDING_REVIEW listing
-- Error: NotFoundException when listing doesn't exist
-- Error: ValidationException for wrong listing status
+**Các điểm kiểm thử quan trọng:**
+- Luồng thành công: Từ chối thành công danh sách ở trạng thái PENDING_REVIEW
+- Lỗi: NotFoundException khi danh sách không tồn tại
+- Lỗi: ValidationException khi trạng thái danh sách không hợp lệ
 
 ---
 
 ### 2. get-revenue-stats.handler.spec.ts
-**Type:** Query Handler Test
-**Location:** `apps/api/src/modules/admin/application/__tests__/`
-**Reference Pattern:** `get-dashboard-stats.handler.spec.ts`
-**Complexity:** Low
+**Loại:** Kiểm thử Query Handler
+**Vị trí:** `apps/api/src/modules/admin/application/__tests__/`
+**Mẫu tham khảo:** `get-dashboard-stats.handler.spec.ts`
+**Độ phức tạp:** Thấp
 
-**Key Testing Points:**
-- Query returns RevenueStatsItem[] from repository
-- Verify parameters passed (startDate, endDate, groupBy)
-- Support both 'day' and 'month' groupBy values
+**Các điểm kiểm thử quan trọng:**
+- Query trả về RevenueStatsItem[] từ repository
+- Xác minh các tham số được truyền vào (startDate, endDate, groupBy)
+- Hỗ trợ cả hai giá trị groupBy là 'day' và 'month'
 
 ---
 
 ### 3. user-deactivated.listener.spec.ts
-**Type:** Event Listener Test
-**Location:** `apps/api/src/modules/admin/application/__tests__/`
-**Reference Pattern:** `user-banned.listener.spec.ts`
-**Complexity:** Medium
+**Loại:** Kiểm thử Event Listener
+**Vị trí:** `apps/api/src/modules/admin/application/__tests__/`
+**Mẫu tham khảo:** `user-banned.listener.spec.ts`
+**Độ phức tạp:** Trung bình
 
-**Key Testing Points:**
-- Expires ACTIVE & PENDING_REVIEW listings for deactivated user
-- Logs handling start and result count
-- Handles case with 0 listings updated
+**Các điểm kiểm thử quan trọng:**
+- Hết hạn các danh sách ACTIVE và PENDING_REVIEW của người dùng bị vô hiệu hóa
+- Ghi nhật ký bắt đầu xử lý và số lượng kết quả
+- Xử lý trường hợp có 0 danh sách được cập nhật
 
 ---
 
-## 📖 Recommended Reading Order
+## 📖 Thứ tự Đọc Được Khuyến nghị
 
-### For First Time Implementation:
-1. Start with **QUICK_REFERENCE.md** (3 min read)
-2. Review **DETAILED_HANDLER_COMPARISON.md** (10 min read)
-3. Keep **ADMIN_MODULE_TEST_ANALYSIS.md** open for detailed code reference
+### Để Triển khai Lần đầu:
+1. Bắt đầu với **QUICK_REFERENCE.md** (đọc 3 phút)
+2. Xem lại **DETAILED_HANDLER_COMPARISON.md** (đọc 10 phút)
+3. Giữ **ADMIN_MODULE_TEST_ANALYSIS.md** mở để tham khảo mã chi tiết
 
-### For Specific Handler:
-- **reject-listing**: Check `approve-listing.handler.spec.ts` example in DETAILED_HANDLER_COMPARISON.md
-- **get-revenue-stats**: Check Query Handler section in DETAILED_HANDLER_COMPARISON.md
-- **user-deactivated**: Check Listener Comparison section in DETAILED_HANDLER_COMPARISON.md
+### Cho Handler Cụ thể:
+- **reject-listing**: Xem ví dụ `approve-listing.handler.spec.ts` trong DETAILED_HANDLER_COMPARISON.md
+- **get-revenue-stats**: Xem phần Query Handler trong DETAILED_HANDLER_COMPARISON.md
+- **user-deactivated**: Xem phần So sánh Listener trong DETAILED_HANDLER_COMPARISON.md
 
 ---
 
-## 🔍 What Each Document Covers
+## 🔍 Nội dung Của Từng Tài liệu
 
-### ADMIN_MODULE_TEST_ANALYSIS.md Sections:
-1. **Section 1:** Untested Handler Files (with full source code)
-2. **Section 2:** Existing Test Files Structure & Patterns
-3. **Section 3:** Handler Code for Reference (ban-user example)
-4. **Section 4:** Infrastructure Files (context only)
-5. **Section 5:** Presentation Layer (context only)
-6. **Section 6:** Test Writing Recommendations
-7. **Section 7:** Complete File Structure
+### Các phần của ADMIN_MODULE_TEST_ANALYSIS.md:
+1. **Phần 1:** Các tệp handler chưa được kiểm thử (với toàn bộ mã nguồn)
+2. **Phần 2:** Cấu trúc và mẫu tệp kiểm thử hiện có
+3. **Phần 3:** Mã handler để tham khảo (ví dụ ban-user)
+4. **Phần 4:** Các tệp cơ sở hạ tầng (chỉ để tham khảo ngữ cảnh)
+5. **Phần 5:** Tầng trình bày (chỉ để tham khảo ngữ cảnh)
+6. **Phần 6:** Khuyến nghị viết kiểm thử
+7. **Phần 7:** Cấu trúc tệp đầy đủ
 
-### DETAILED_HANDLER_COMPARISON.md Sections:
-1. **File Structure Comparison:** Directory layouts
-2. **Side-by-Side Handler Comparison:** approve vs reject
-3. **Test Code Walkthrough:** approve-listing test annotated
-4. **How to Adapt:** For reject-listing
-5. **Query Handler Comparison:** dashboard-stats vs revenue-stats
-6. **Query Handler Test Pattern:** Full example
-7. **Listener Comparison:** user-banned vs user-deactivated
-8. **Listener Test Pattern:** Full example
+### Các phần của DETAILED_HANDLER_COMPARISON.md:
+1. **So sánh cấu trúc tệp:** Bố cục thư mục
+2. **So sánh handler song parallel:** approve vs reject
+3. **Hướng dẫn đọc mã kiểm thử:** Kiểm thử approve-listing có chú thích
+4. **Cách điều chỉnh:** Cho reject-listing
+5. **So sánh Query Handler:** dashboard-stats vs revenue-stats
+6. **Mẫu kiểm thử Query Handler:** Ví dụ đầy đủ
+7. **So sánh Listener:** user-banned vs user-deactivated
+8. **Mẫu kiểm thử Listener:** Ví dụ đầy đủ
 
-### QUICK_REFERENCE.md Sections:
-1. **Handler 1:** reject-listing overview
-2. **Handler 2:** get-revenue-stats overview
-3. **Handler 3:** user-deactivated overview
-4. **Mock Setup Templates:** For each type
-5. **Testing Checklist:** What to verify
+### Các phần của QUICK_REFERENCE.md:
+1. **Handler 1:** Tổng quan reject-listing
+2. **Handler 2:** Tổng quan get-revenue-stats
+3. **Handler 3:** Tổng quan user-deactivated
+4. **Mẫu thiết lập Mock:** Cho từng loại
+5. **Danh sách kiểm tra kiểm thử:** Những gì cần xác minh
 
 ---
 
-## 💡 Quick Start Guide
+## 💡 Hướng dẫn Bắt đầu Nhanh
 
-### Step 1: Choose Your Handler
+### Bước 1: Chọn Handler của bạn
 ```
-reject-listing → Use approve-listing as template
-get-revenue-stats → Use get-dashboard-stats as template
-user-deactivated → Use user-banned as template
+reject-listing → Dùng approve-listing làm mẫu
+get-revenue-stats → Dùng get-dashboard-stats làm mẫu
+user-deactivated → Dùng user-banned làm mẫu
 ```
 
-### Step 2: Review the Reference Test
-Read the reference test file from **DETAILED_HANDLER_COMPARISON.md**
+### Bước 2: Xem lại Kiểm thử Tham khảo
+Đọc tệp kiểm thử tham khảo từ **DETAILED_HANDLER_COMPARISON.md**
 
-### Step 3: Copy & Adapt
-- Copy the test structure
-- Change imports
-- Adapt test data
-- Verify mock calls
+### Bước 3: Sao chép và Điều chỉnh
+- Sao chép cấu trúc kiểm thử
+- Thay đổi các import
+- Điều chỉnh dữ liệu kiểm thử
+- Xác minh các lệnh gọi mock
 
-### Step 4: Verify Coverage
-Run: `npm test admin`
+### Bước 4: Xác minh Độ phủ
+Chạy: `npm test admin`
 
 ---
 
-## 📊 Test Statistics
+## 📊 Thống kê Kiểm thử
 
-| File | Type | Tests | Complexity |
+| Tệp | Loại | Số kiểm thử | Độ phức tạp |
 |------|------|-------|------------|
-| reject-listing.handler.spec.ts | Command | 3 | Medium |
-| get-revenue-stats.handler.spec.ts | Query | 3 | Low |
-| user-deactivated.listener.spec.ts | Listener | 3 | Medium |
-| **Total** | - | **9** | - |
+| reject-listing.handler.spec.ts | Command | 3 | Trung bình |
+| get-revenue-stats.handler.spec.ts | Query | 3 | Thấp |
+| user-deactivated.listener.spec.ts | Listener | 3 | Trung bình |
+| **Tổng cộng** | - | **9** | - |
 
 ---
 
-## ✅ Verification Checklist
+## ✅ Danh sách Kiểm tra Xác minh
 
-After writing tests:
-- [ ] All 3 test files created
-- [ ] All imports correct
-- [ ] All mocks set up properly
-- [ ] Tests compile without errors
-- [ ] `npm test admin` passes all tests
-- [ ] No console warnings
-- [ ] Code coverage > 85%
+Sau khi viết kiểm thử:
+- [ ] Đã tạo đủ 3 tệp kiểm thử
+- [ ] Tất cả các import đúng
+- [ ] Tất cả các mock được thiết lập đúng cách
+- [ ] Kiểm thử biên dịch không có lỗi
+- [ ] `npm test admin` vượt qua tất cả kiểm thử
+- [ ] Không có cảnh báo console
+- [ ] Độ phủ mã > 85%
 
 ---
 
-## 🔗 File Locations
+## 🔗 Vị trí Tệp
 
-**Source Files (need tests):**
+**Tệp nguồn (cần kiểm thử):**
 - `apps/api/src/modules/admin/application/commands/reject-listing/reject-listing.handler.ts`
 - `apps/api/src/modules/admin/application/queries/get-revenue-stats/get-revenue-stats.handler.ts`
 - `apps/api/src/modules/admin/application/listeners/user-deactivated.listener.ts`
 
-**Reference Test Files:**
+**Tệp kiểm thử tham khảo:**
 - `apps/api/src/modules/admin/application/__tests__/approve-listing.handler.spec.ts`
 - `apps/api/src/modules/admin/application/__tests__/get-dashboard-stats.handler.spec.ts`
 - `apps/api/src/modules/admin/application/__tests__/user-banned.listener.spec.ts`
 
-**Where to Create New Tests:**
-- `apps/api/src/modules/admin/application/__tests__/reject-listing.handler.spec.ts` (NEW)
-- `apps/api/src/modules/admin/application/__tests__/get-revenue-stats.handler.spec.ts` (NEW)
-- `apps/api/src/modules/admin/application/__tests__/user-deactivated.listener.spec.ts` (NEW)
+**Nơi tạo kiểm thử mới:**
+- `apps/api/src/modules/admin/application/__tests__/reject-listing.handler.spec.ts` (MỚI)
+- `apps/api/src/modules/admin/application/__tests__/get-revenue-stats.handler.spec.ts` (MỚI)
+- `apps/api/src/modules/admin/application/__tests__/user-deactivated.listener.spec.ts` (MỚI)
 
 ---
 
-## 📞 Key Takeaways
+## 📞 Những Điểm Mấu chốt
 
-1. **All 3 files** follow established patterns in the codebase
-2. **Reference tests exist** for each handler type
-3. **Total tests needed:** 9 (3 per file)
-4. **Estimated time:** 1-2 hours to implement all
-5. **Difficulty:** Low to Medium (high code reuse)
-6. **Documentation:** Very thorough (all code provided)
+1. **Cả 3 tệp** đều tuân theo các mẫu đã được thiết lập trong codebase
+2. **Các kiểm thử tham khảo tồn tại** cho từng loại handler
+3. **Tổng số kiểm thử cần có:** 9 (3 mỗi tệp)
+4. **Thời gian dự kiến:** 1-2 giờ để triển khai tất cả
+5. **Độ khó:** Thấp đến Trung bình (tái sử dụng mã cao)
+6. **Tài liệu:** Rất đầy đủ (tất cả mã đã được cung cấp)
 
 ---
 
-Generated: 2026-04-11
-All test examples ready to adapt and implement.
-
+Được tạo: 2026-04-11
+Tất cả ví dụ kiểm thử đã sẵn sàng để điều chỉnh và triển khai.