GGHut DocsTài liệu hệ thống GGHut

Kiến trúc · Lộ trình · Vận hành — source of truth duy nhất cho mọi service

Kiến trúc tổng thể

Lộ trình 6 phases

Tổng quan (Shared)

Kiến trúc tổng thể, lộ trình MVP → SaaS, luồng groupbuy, contract API giữa BE và FE.

Frontend

Next.js Storefront & Admin — kiến trúc FE, routing, API layer, styling.

Backend (Go)

Core architecture Phase 0, project structure, hướng dẫn deploy Cloud Run.

Status

Service theo dõi trạng thái hệ thống.

🔗 Bio tree

Mọi link của hệ thống — từ URL public tới repo GitHub và console tài nguyên.

🌐 Public

🛍️StorefrontTrang groupbuy cho khách đặt cọc · gghut-storefront.pages.dev↗

🛠️AdminQuản lý kèo, đơn hàng, settle · gghut-admin.gghutvn.workers.dev↗

📚Docs (online)Chính trang này, bản deploy · gghut-docs.pages.dev↗

⚙️APIBackend base URL · Cloud Run asia-southeast1↗

🐙 GitHub — gghutvn-founder

🖥️gghutFE monorepo: nextjs-storefront + nextjs-admin↗

🐹gghut-coreBackend Go: chi + otel + Neon, deploy Cloud Run↗

📝gghut-docsRepo này — source of truth của docs↗

📡gghut-statusService theo dõi trạng thái hệ thống↗

🧰 Tài nguyên / Console

☁️Cloud Run — gghut-coreService backend trên GCP · project gghut-505509↗

🪵Logs ExplorerLog request BE (slog JSON) · lọc theo trace id↗

🔭Trace ExplorerDistributed traces FE → BE → SQL↗

🟠CloudflarePages: storefront + docs · Workers: admin↗

🐘NeonPostgres serverless (DATABASE_URL của BE)↗

🖼️R2 publicBucket ảnh campaign (banner + gallery)↗

Quy tắc: repo này là nơi duy nhất sửa docs. Các repo service (gghut, gghut-core, gghut-status) nhận bản sync tự động qua scripts/docs-sync.sh sau mỗi git pull — xem README.