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

docs/audits/WEB_UPGRADE_CHECKLIST.md

@@ -1,194 +1,194 @@
-# Next.js 15.2.35 → 15 Upgrade Checklist
+# Danh Sách Kiểm Tra Nâng Cấp Next.js 15.2.35 → 15
 
-## ✅ Pre-Upgrade Verification
+## ✅ Xác Minh Trước Khi Nâng Cấp
 
-- [ ] Create feature branch: `git checkout -b upgrade/next-15`
-- [ ] Commit current work: `git add . && git commit -m "Pre-upgrade checkpoint"`
-- [ ] Run full test suite: `npm run test`
-- [ ] Check TypeScript: `npm run typecheck`
-- [ ] Note current version: `npm ls next` (should be 14.2.35)
+- [ ] Tạo nhánh tính năng: `git checkout -b upgrade/next-15`
+- [ ] Commit công việc hiện tại: `git add . && git commit -m "Pre-upgrade checkpoint"`
+- [ ] Chạy toàn bộ bộ kiểm thử: `npm run test`
+- [ ] Kiểm tra TypeScript: `npm run typecheck`
+- [ ] Ghi chú phiên bản hiện tại: `npm ls next` (phải là 14.2.35)
 
-## 🔧 Upgrade Steps
+## 🔧 Các Bước Nâng Cấp
 
-### Step 1: Update Next.js
+### Bước 1: Cập Nhật Next.js
 ```bash
 npm install next@15 --save
 npm install
 ```
 
-### Step 2: Run Development Server
+### Bước 2: Chạy Máy Chủ Phát Triển
 ```bash
 npm run dev
 ```
-- [ ] Dev server starts without errors
-- [ ] No TypeScript errors
-- [ ] HMR (hot reload) working
+- [ ] Máy chủ dev khởi động không có lỗi
+- [ ] Không có lỗi TypeScript
+- [ ] HMR (tải lại nóng) hoạt động bình thường
 
-### Step 3: Type Checking
+### Bước 3: Kiểm Tra Kiểu Dữ Liệu
 ```bash
 npm run typecheck
 ```
-- [ ] No new type errors introduced
-- [ ] All types resolve correctly
+- [ ] Không có lỗi kiểu dữ liệu mới phát sinh
+- [ ] Tất cả kiểu dữ liệu được phân giải đúng
 
-### Step 4: Run Tests
+### Bước 4: Chạy Kiểm Thử
 ```bash
 npm run test
 ```
-- [ ] All tests pass
-- [ ] No test breakage
-- [ ] Coverage maintained
+- [ ] Tất cả các bài kiểm thử đều qua
+- [ ] Không có bài kiểm thử bị hỏng
+- [ ] Độ bao phủ được duy trì
 
-### Step 5: Production Build
+### Bước 5: Build Sản Xuất
 ```bash
 npm run build
 ```
-- [ ] Build completes successfully
-- [ ] Build size similar to before (within ±5%)
-- [ ] No build warnings
-- [ ] Check `.next` directory size: `du -sh .next/`
+- [ ] Build hoàn thành thành công
+- [ ] Kích thước build tương đương trước đây (trong khoảng ±5%)
+- [ ] Không có cảnh báo build
+- [ ] Kiểm tra kích thước thư mục `.next`: `du -sh .next/`
 
-### Step 6: Test Production Build
+### Bước 6: Kiểm Thử Build Sản Xuất
 ```bash
 npm run start
 ```
-- [ ] Production build starts
-- [ ] No runtime errors
-- [ ] Can navigate application
+- [ ] Build sản xuất khởi động được
+- [ ] Không có lỗi runtime
+- [ ] Có thể điều hướng trong ứng dụng
 
-## 🧪 Manual Testing Checklist
+## 🧪 Danh Sách Kiểm Thử Thủ Công
 
-### Public Pages
-- [ ] Home page loads and renders
-- [ ] Search page loads (with map)
-- [ ] Listing detail page loads with images
-- [ ] Image gallery works (previous/next buttons)
+### Trang Công Khai
+- [ ] Trang chủ tải và hiển thị được
+- [ ] Trang tìm kiếm tải được (có bản đồ)
+- [ ] Trang chi tiết tin đăng tải được với hình ảnh
+- [ ] Thư viện ảnh hoạt động (nút trước/tiếp theo)
 
-### Authentication
-- [ ] Login page loads
-- [ ] Register page loads
-- [ ] Auth callbacks work (Google, Zalo)
-- [ ] Cookies set/cleared correctly
-- [ ] Redirect to login works for protected pages
+### Xác Thực
+- [ ] Trang đăng nhập tải được
+- [ ] Trang đăng ký tải được
+- [ ] Callback xác thực hoạt động (Google, Zalo)
+- [ ] Cookie được thiết lập/xóa đúng cách
+- [ ] Chuyển hướng đến trang đăng nhập hoạt động với trang được bảo vệ
 
-### Internationalization (i18n)
-- [ ] English version loads: `/en/*`
-- [ ] Vietnamese version loads: `/vi/*`
-- [ ] Locale switching works
-- [ ] Language preference persists
-- [ ] Middleware locale detection works
+### Quốc Tế Hóa (i18n)
+- [ ] Phiên bản tiếng Anh tải được: `/en/*`
+- [ ] Phiên bản tiếng Việt tải được: `/vi/*`
+- [ ] Chuyển đổi ngôn ngữ hoạt động
+- [ ] Tùy chọn ngôn ngữ được lưu giữ
+- [ ] Phát hiện ngôn ngữ qua middleware hoạt động
 
-### Dashboard (Protected)
-- [ ] Dashboard page loads
-- [ ] Listings page works
-- [ ] Create new listing flow
-- [ ] Edit listing flow
-- [ ] Payments/Subscription pages load
-- [ ] Profile page loads
-- [ ] KYC page loads
-- [ ] Valuation page loads
+### Bảng Điều Khiển (Được Bảo Vệ)
+- [ ] Trang bảng điều khiển tải được
+- [ ] Trang tin đăng hoạt động
+- [ ] Luồng tạo tin đăng mới
+- [ ] Luồng chỉnh sửa tin đăng
+- [ ] Trang Thanh Toán/Đăng Ký tải được
+- [ ] Trang hồ sơ tải được
+- [ ] Trang KYC tải được
+- [ ] Trang định giá tải được
 
-### Admin Panel
-- [ ] Admin dashboard loads
-- [ ] Users page loads
-- [ ] KYC review page loads
-- [ ] Moderation page loads
+### Bảng Quản Trị
+- [ ] Bảng điều khiển quản trị tải được
+- [ ] Trang người dùng tải được
+- [ ] Trang xét duyệt KYC tải được
+- [ ] Trang kiểm duyệt tải được
 
-### Performance
-- [ ] Page load times reasonable
-- [ ] No console errors
-- [ ] No console warnings
-- [ ] No memory leaks detected
-- [ ] Network requests functioning
+### Hiệu Năng
+- [ ] Thời gian tải trang hợp lý
+- [ ] Không có lỗi trong console
+- [ ] Không có cảnh báo trong console
+- [ ] Không phát hiện rò rỉ bộ nhớ
+- [ ] Các yêu cầu mạng hoạt động bình thường
 
-### Special Features
-- [ ] Mapbox GL maps load correctly
-- [ ] Image optimization working
-- [ ] CSP headers correct
-- [ ] Sentry error tracking working
-- [ ] Web vitals reporting working
+### Tính Năng Đặc Biệt
+- [ ] Bản đồ Mapbox GL tải đúng cách
+- [ ] Tối ưu hóa hình ảnh hoạt động
+- [ ] Tiêu đề CSP đúng
+- [ ] Theo dõi lỗi Sentry hoạt động
+- [ ] Báo cáo web vitals hoạt động
 
-## 📊 Performance Baseline
+## 📊 Mốc Hiệu Năng Cơ Sở
 
-Before upgrade:
-- Build time: _____ seconds
-- Bundle size: _____ MB
+Trước khi nâng cấp:
+- Thời gian build: _____ giây
+- Kích thước bundle: _____ MB
 - First contentful paint: _____ ms
 - Time to interactive: _____ ms
 
-After upgrade:
-- Build time: _____ seconds
-- Bundle size: _____ MB
+Sau khi nâng cấp:
+- Thời gian build: _____ giây
+- Kích thước bundle: _____ MB
 - First contentful paint: _____ ms
 - Time to interactive: _____ ms
 
-Comparison: _____ (Improvement/No change/Slight increase)
+So sánh: _____ (Cải thiện / Không thay đổi / Tăng nhẹ)
 
-## 🔍 Compatibility Checks
+## 🔍 Kiểm Tra Khả Năng Tương Thích
 
-### Dependencies Status
-- [ ] @sentry/nextjs@10.47.0 → Working
-- [ ] next-intl@4.9.0 → Working
-- [ ] @tanstack/react-query@5.96.2 → Working
-- [ ] mapbox-gl@3.21.0 → Maps loading correctly
-- [ ] All other dependencies → Compatible
+### Trạng Thái Các Phụ Thuộc
+- [ ] @sentry/nextjs@10.47.0 → Hoạt động
+- [ ] next-intl@4.9.0 → Hoạt động
+- [ ] @tanstack/react-query@5.96.2 → Hoạt động
+- [ ] mapbox-gl@3.21.0 → Bản đồ tải đúng cách
+- [ ] Tất cả các phụ thuộc khác → Tương thích
 
-### Configuration Files
-- [ ] next.config.js → No warnings
-- [ ] tsconfig.json → Valid
-- [ ] tailwind.config.ts → Building correctly
-- [ ] sentry.*.config.ts → Error tracking working
+### Các Tệp Cấu Hình
+- [ ] next.config.js → Không có cảnh báo
+- [ ] tsconfig.json → Hợp lệ
+- [ ] tailwind.config.ts → Build đúng cách
+- [ ] sentry.*.config.ts → Theo dõi lỗi hoạt động
 
-## 🚀 Deployment
+## 🚀 Triển Khai
 
-### Staging Environment
-- [ ] Deploy to staging
-- [ ] Full test suite passes in staging
-- [ ] Manual smoke testing completed
-- [ ] Monitor logs for 30 minutes
-- [ ] No errors in error tracking
+### Môi Trường Staging
+- [ ] Triển khai lên staging
+- [ ] Toàn bộ bộ kiểm thử qua trên staging
+- [ ] Hoàn thành kiểm thử khói thủ công
+- [ ] Theo dõi log trong 30 phút
+- [ ] Không có lỗi trong hệ thống theo dõi lỗi
 
-### Production Environment
-- [ ] Create production deployment branch
-- [ ] Deploy to production
-- [ ] Monitor error logs
-- [ ] Monitor performance metrics
-- [ ] Check Sentry for new errors
-- [ ] Verify all features working
-- [ ] Monitor for 24 hours
+### Môi Trường Sản Xuất
+- [ ] Tạo nhánh triển khai sản xuất
+- [ ] Triển khai lên môi trường sản xuất
+- [ ] Theo dõi log lỗi
+- [ ] Theo dõi các chỉ số hiệu năng
+- [ ] Kiểm tra Sentry xem có lỗi mới không
+- [ ] Xác minh tất cả tính năng hoạt động
+- [ ] Theo dõi trong 24 giờ
 
-## ✅ Post-Upgrade Sign-Off
+## ✅ Ký Duyệt Sau Nâng Cấp
 
-- [ ] All tests passing
-- [ ] Build size acceptable
-- [ ] Performance acceptable
-- [ ] No critical errors
-- [ ] Feature parity maintained
-- [ ] Ready for production
+- [ ] Tất cả bài kiểm thử đều qua
+- [ ] Kích thước build chấp nhận được
+- [ ] Hiệu năng chấp nhận được
+- [ ] Không có lỗi nghiêm trọng
+- [ ] Tính tương đương tính năng được duy trì
+- [ ] Sẵn sàng đưa lên môi trường sản xuất
 
-## 📝 Notes & Issues Found
+## 📝 Ghi Chú & Các Vấn Đề Phát Hiện
 
 ```
-Issue 1: ___________________________________________
-Resolution: ________________________________________
+Vấn đề 1: ___________________________________________
+Giải quyết: ________________________________________
 
-Issue 2: ___________________________________________
-Resolution: ________________________________________
+Vấn đề 2: ___________________________________________
+Giải quyết: ________________________________________
 
-Issue 3: ___________________________________________
-Resolution: ________________________________________
+Vấn đề 3: ___________________________________________
+Giải quyết: ________________________________________
 ```
 
-## 🎯 Sign-Off
+## 🎯 Ký Duyệt
 
-Upgraded by: _____________________
-Date: _____________________
-Verified by: _____________________
-Production deployed: _____________________
+Nâng cấp bởi: _____________________
+Ngày: _____________________
+Xác minh bởi: _____________________
+Triển khai sản xuất: _____________________
 
 ---
 
-**If any issues occur, revert with:**
+**Nếu có sự cố xảy ra, hãy hoàn tác bằng:**
 ```bash
 git revert HEAD
 npm install