How bharathkulal/bimba-ai works
Bimba AI is a full-stack resume and career platform. Its central user workflow is to upload or build a resume, extract and normalize its content, assess its ATS readiness and health, then use job matching and templates to improve and export it. The repository also includes job discovery, skill-gap guidance, AI assistance, and administrative and placement portals. The graph reflects documented modules and sampled call ownership; unsampled frontend-to-endpoint wiring and some storage interactions are left out.
Main entry points: resumes_routes.py Resume endpoints · ResumeBuilderFlow.tsx Resume builder · AppRoutes.tsx Application routes · api.ts API client
Components 22
User experience
- Resume builder
frontend/src/components/resume-builder/ResumeBuilderFlow.tsx - Application routes
frontend/src/routes/AppRoutes.tsx - API client
frontend/src/services/api.ts - Administration
frontend/src/pages/admin - Placement portal
frontend/src/pages/placement
Resume processing
- Upload service
backend/app/services/upload_service.py - Document pipeline
backend/app/services/resume_pipeline/pipeline.py - Resume normalization
backend/app/services/zero_loss_engine.py - Template service
backend/app/services/template_service.py - PDF rendering
backend/pdf_renderer/server.mjs
Career intelligence
- ATS analysis
backend/app/services/ats/ats_engine.py - Resume intelligence
backend/app/services/resume_intelligence/resume_intelligence_engine.py - Job matching
backend/app/services/job_matching/job_match_engine.py - Skill gap guidance
backend/app/services/skill_gap/skill_gap_engine.py
API and persistence
- Resume endpoints
backend/app/api/v1/resumes/resumes_routes.py - Job endpoints
backend/app/api/jobs.py - Template endpoints
backend/app/api/v1/templates/templates_routes.py - AI endpoints
backend/app/api/v1/ai/ai_routes.py - MongoDB
backend/app/core/mongodb.py
External services
- Job providers
backend/app/services/job_provider/base.py - AI gateway
backend/app/services/ai_gateway.py
Other components
- Resume user
Connections 14
- Resume user → Application routes: opens app
- Application routes → Resume builder: routes to
- Resume builder → API client: requests API
- API client → Resume endpoints: HTTP requests
- Resume endpoints → Upload service: processes upload
- Upload service → Document pipeline: extracts document
- Document pipeline → Resume normalization: normalizes content
- Resume endpoints → ATS analysis: analyzes resume
- Resume endpoints → Resume intelligence: requests analysis
- Resume intelligence → Job matching: parses job needs
- Job endpoints → Job providers: retrieves listings
- Skill gap guidance → Job matching: parses requirements
- Template endpoints → Template service: uses templates
- AI endpoints → AI gateway: generates responses