3705193f97
Extract shared `verifyWithRotation` helper and `makeSecretOrKeyProvider` into `jwt-rotation.ts` so both REST (passport-jwt strategy) and WebSocket (TokenService.verifyAccessToken) paths honour JWT_SECRET_PREVIOUS during secret rotation. Add env-validation for optional previous secrets and document the rotation policy for WebSocket sessions. Resolves GOO-237 Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>
Tài liệu GoodGo Platform
Mục lục tổng hợp cho toàn bộ tài liệu dưới docs/. Sau đợt consolidate ở TEC-3094, mọi exploration / audit / design-system đã được gom vào đây, không còn file .md dự án ở repo root ngoài 4 file chuẩn (README.md, CHANGELOG.md, CONTRIBUTING.md, CLAUDE.md) hoặc ngoài workspace (~/Desktop).
Bắt đầu
| Tài liệu | Mô tả |
|---|---|
| Môi trường phát triển | Cài đặt Docker, dịch vụ cục bộ, xử lý sự cố |
| Kiến trúc | Thiết kế hệ thống, luồng dữ liệu, cấu trúc module |
| Quick Start Reference | Lối đi nhanh cho dev mới |
| Quick Reference | Quy ước, path alias, command phổ biến |
Tham chiếu API
| Tài liệu | Mô tả |
|---|---|
| Các endpoint API | Tài liệu tham chiếu đầy đủ các endpoint REST API |
| Mã lỗi API | Định dạng phản hồi lỗi và tất cả mã lỗi |
| api/market-index-ticker-contract.md | Contract sàn giao dịch (TEC-3043) |
Vận hành
| Tài liệu | Mô tả |
|---|---|
| Triển khai | Hướng dẫn triển khai sản xuất |
| Sao lưu & Khôi phục | Quy trình DR |
| Runbook | Runbook vận hành |
| Production Readiness | Checklist sẵn sàng production |
| Production Readiness Assessment | Báo cáo đánh giá |
| Project Tracker | Theo dõi milestone tổng |
Audit
Xem audits/README.md. Các báo cáo audit chính (post-consolidate):
- AUDIT_INDEX, AUDIT_SUMMARY, README_AUDIT_FILES
- AUDIT_REPORT_2026_04_21
- AUDIT_LISTINGS_PROPERTY_MANAGEMENT
- BACKEND_API_AUDIT_EXCHANGE_UI + quick reference
Design System
Tokens/mockup bàn giao bởi UX/UI Designer nằm trong document của issue TEC-3037 (tokens, mockup).
Exploration & Module Deep Dives
Toàn bộ exploration report được gom dưới docs/explorations/:
Analytics
API surface
Frontend (Next.js)
- FRONTEND_DOCUMENTATION_INDEX
- NEXTJS_FRONTEND_STRUCTURE
- NEXTJS_QUICK_REFERENCE
- NEXTJS_VISUAL_FLOWCHART
- UI_MAPPING_QUICK_GUIDE
Listings
- LISTINGS_MODULE_EXPLORATION
- LISTINGS_DATA_SCHEMA
- LISTINGS_QUICK_REFERENCE
- EXPLORATION_SUMMARY_LISTINGS
- README_LISTINGS_EXPLORATION
Tổng hợp
Recovered from ~/Desktop
Trước đây các sub-agent exploration đã ghi nhầm ra ~/Desktop. Tất cả đã được gom về explorations/from-desktop/:
00_SUMMARY.md,01_analytics_architecture_guide.md,02_quick_reference.md,03_file_paths_reference.mdFRONTEND_EXPLORATION_REPORT.md,INDEX_frontend_exploration.md,NOTIFICATIONS_EXPLORATION.mdREADME_analytics_package.md(vốn là Desktop/README.md)ARCHITECTURE_OVERVIEW.txt,FRONTEND_QUICK_REFERENCE.txt,README_EXPLORATION.txt
Frontend docs (bản cũ)
Quy ước
- Không tạo file
.mddự án ở repo root (ngoàiREADME.md,CHANGELOG.md,CONTRIBUTING.md,CLAUDE.md). - Không ghi file dự án ra ngoài workspace (ví dụ
~/Desktop). Mọi output của exploration/audit phải relative trongdocs/…. - Đặt file audit theo mẫu
AUDIT_<topic>_<YYYY_MM_DD>.mdtrongdocs/audits/. - Đặt exploration theo
<MODULE>_<TOPIC>.mdtrongdocs/explorations/.