How itzzgaurav7/sage-zingguru works
Project Type & Purpose
• Full-stack, AI-powered learning ecosystem
• Frontend: React & Vite (web app) + optional browser extension
• Backend/API Gateway: Node.js + Express
• AI/ML microservices: Python FastAPI (RAG pipelines) & ML-API (video summarizer)
• Data: PostgreSQL, Redis cache, AWS S3, Firebase
File Structure
Top-level directories
– Frontend/ : React-Vite app, components, Redux slices, Firebase config
– Backend/ : Node.js Express server, db.js, REST endpoints
– Fast-API/ : Python apps for Retrieval-Augmented Generation (RAG)
– ML-API/ : Python video summarizer service
– extension/ : Browser extension assets, background.js, popup.js
– data/ : Static JSON for career paths
Config & infra
– .env files in each service
– package.json at root for monorepo scripts
– Vercel config in Frontend/vercel.json
README Insights
• System Architecture snippet: “User ➝ Frontend ➝ API Gateway ➝ Backend ➝ DB ➝ AI Services ➝ Caching ➝ Storage”
• Tech stack table: React, Node/Express, GraphQL API, OpenAI, LangChain, PostgreSQL, Redis, AWS S3, Firebase
1. Presentation Layer
• Web App (React)
• Browser Extension
2. API Layer
• API Gateway / Node.js (Express + GraphQL)
3. Service Layer
• FastAPI RAG Service
• ML-API Video Summarizer
4. Data Layer
• PostgreSQL (persistent storage)
• Redis (caching)
• AWS S3 (blob storage)
• Firebase (Auth, Firestore/Realtime)
5. External AI Services
• OpenAI / LangChain
• Google Cloud ML
6. Hosting & CI/CD
• Vercel (frontend)
• Docker/Kubernetes (optional backend)
• User → React UI (HTTPS)
• React → API Gateway (REST/GraphQL)
• Extension → API Gateway (REST)
• API Gateway → PostgreSQL (queries)
• API Gateway ↔ Redis (get/set cache)
• API Gateway → AWS S3 (upload/download media)
• API Gateway → FastAPI RAG (HTTP/gRPC) → OpenAI/LangChain
• API Gateway → ML-API (HTTP) for video summarization
• API Gateway → Firebase Auth & Firestore
• Optional: FastAPI/ML-API also call external AI services directly
c. Architectural Patterns & Principles
• Layered Architecture: clear separation of Presentation, API, Services, Data
• Microservices: independent RAG & ML services
• Cache‐Aside: Redis for hot data
• Serverless/static hosting for frontend (Vercel), containerized backend/services
• State Management: Redux slices in frontend
d. Technologies & Frameworks to Call Out
• React.js + Vite + Tailwind (UI)
• Express.js + GraphQL (API Gateway)
• FastAPI (Python RAG), Streamlit (optional UI)
• Python video summarizer (ML-API)
• PostgreSQL, Redis, AWS S3
• Firebase (Auth, Firestore)
• OpenAI / LangChain
Final Checklist
✔ All layers & components represented
✔ Data flows & dependencies clearly arrowed
✔ Key technologies called out in component labels