How duydev/rao-vat works
Main Components
A. Frontend Layer (Next.js):
• Client-side Components
• Server-side Components (Next.js Pages)
• API Integration Layer
• Routing System
B. Backend Layer (Go):
• HTTP Server
• Domain Layer
• Use Cases Layer
• Repository Layer
• Infrastructure Layer
C. Database:
• Firestore (Firebase)
D. Cloud Infrastructure:
• Vercel (Frontend Hosting)
• Google Cloud Run (Backend Hosting)
[Client Browser] → [Frontend (Vercel)] → [Backend (Cloud Run)] → [Firestore]
Key Relationships to Highlight
• Frontend to Backend API calls (via articles-api.js)
• Backend Clean Architecture layers interaction
• Database operations flow
• Cloud platform integration points
Specific Implementation Details
Frontend Flow:
[Pages] → [Components] → [API Layer] → [Backend Requests]
Backend Flow:
[HTTP Handlers] → [Use Cases] → [Domain] → [Repository] → [Firestore]
Additional Notes
• Clean architecture boundaries in the backend
• Stateless nature of the services
• Deployment flows
• Error handling paths
Implementation Recommendations
• Version information
• Notes for important architectural decisions
• Scaling points
This system design should emphasize: