How yogeshkanwade21/project_intelligence works
Project type and purpose
• This is a full-stack, microservices-style application with three main containers:
• Frontend (React + Vite + Tailwind SPA)
• Auth service (FastAPI + Zoho integration)
• Backend orchestrator service (FastAPI + intent extraction + JQL generation + Jira API)
• It uses Docker Compose for local orchestration and communicates with two external APIs (Zoho for authentication, Jira for data).
File structure
• Root: docker-compose.yml, .env template for Jira credentials
• /frontend: React/Vite code (TSX components, API client, tests)
• /auth: Python FastAPI microservice (routers/zoho, config, constants, utils)
• /backend: Python FastAPI microservice (orchestrator modules, Jira service, routes)
• CI pipeline: .github/workflows/frontend-tests.yml
README for insights
• Docker-based local setup, environment variables for Jira
• No internal database—state is ephemeral or managed by external systems
Main components
a. Frontend Client
• React SPA served via Vite (port via Docker)
• Components: ChatWindow, LoginPage, service.ts API client
b. Auth Service
• FastAPI app (auth/main.py)
• Zoho Auth router (auth/routers/zoho/auth.py)
• Config & constants (auth/config.py, status codes, messages)
c. Orchestrator (Backend Service)
• FastAPI app (backend/app/main.py)
• Intent Extractor (backend/app/orchestrator/intent_extractor.py)
• JQL Generator (backend/app/orchestrator/jql_generator.py)
• Jira Service (backend/app/services/jira_service.py)
• Routes (backend/app/routes/jira.py)
d. External Services
• Zoho OAuth API
• Jira REST API
1. User ↔ Frontend (HTTP in browser)
2. Frontend → Auth Service (/auth/zoho/login) → Zoho OAuth → Auth Service
3. Auth Service → Frontend (JWT or session token)
4. Frontend → Backend Service (/jira/query) with token
5. Backend Service → Intent Extractor → JQL Generator → Jira Service
6. Jira Service → Jira REST API → Backend Service → Frontend
Highlighted architectural patterns
• Microservice separation (Auth vs. Orchestrator)
• Orchestrator pattern in backend to chain intent extraction & JQL generation
• External-integration pattern (Zoho, Jira)
• Clear separation between UI (React), API layer (FastAPI), and external APIs
Technologies & frameworks
• Frontend: React, Vite, TypeScript, Tailwind CSS, Vitest, ESLint
• Auth & Backend: Python 3.x, FastAPI, Pydantic, Uvicorn (implied), pip requirements
• Deployment: Docker, Docker Compose