Files
goodgo-platform/docs
Ho Ngoc Hai 1e9ef567a9
Some checks failed
CI / AI Services (Python) — Smoke (push) Failing after 35s
Deploy / Build Web Image (push) Failing after 30s
Deploy / Build AI Services Image (push) Failing after 11s
E2E Tests / Playwright E2E (push) Failing after 37s
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 11m1s
Deploy / Build API Image (push) Failing after 10m40s
Backup Verification / Backup Restore Verification (push) Failing after 14s
Deploy / Deploy to Staging (push) Has been cancelled
Deploy / Smoke Test Staging (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Deploy / Rollback Staging (push) Has been cancelled
Deploy / Deploy to Production (push) Has been cancelled
Deploy / Smoke Test Production (push) Has been cancelled
Deploy / Rollback Production (push) Has been cancelled
Security Scanning / Dependency Audit (pnpm) (push) Failing after 6s
Security Scanning / Trivy Scan — API Image (push) Failing after 42s
Security Scanning / Trivy Scan — Web Image (push) Failing after 27s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 26s
Security Scanning / Trivy Filesystem Scan (push) Failing after 23s
Security Scanning / Security Gate (push) Failing after 1s
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 49s
docs(osm): note 2025 VN admin reform — vn_districts now holds ward/commune layer
Vietnam dropped the district administrative level in the 2025 reform
(Nghị quyết về sắp xếp đơn vị hành chính). Only two levels remain:
province (level=4) and ward/commune (level=6).

OSM has updated tagging accordingly: every former xã/phường/thị trấn
that survived the merge is now `admin_level=6`, no `admin_level=8`
features for VN. Our sync confirmed this — 3,189 level=6 units inserted
across 33 provinces, level=8 returns zero.

The schema column "vn_districts" stays as-is to avoid a cascade-rename
across IndustrialPark / ProjectDevelopment / Property FKs. Documented
the semantic shift in osm-data-model.md so future ops don't think
something is broken when wards are empty.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 13:13:26 +07:00
..

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):

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)

Listings

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.md
  • FRONTEND_EXPLORATION_REPORT.md, INDEX_frontend_exploration.md, NOTIFICATIONS_EXPLORATION.md
  • README_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 .md dự án ở repo root (ngoài README.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 trong docs/….
  • Đặt file audit theo mẫu AUDIT_<topic>_<YYYY_MM_DD>.md trong docs/audits/.
  • Đặt exploration theo <MODULE>_<TOPIC>.md trong docs/explorations/.