How netizen-om/pravya-ai works
Pravya AI is a multi-service interview-practice and resume-analysis platform, with a separate admin console. The primary workflow runs from interview setup through live voice interaction to persisted transcripts and asynchronous AI feedback; the parallel resume workflow uploads and analyzes a resume, then supports contextual chat. The README documents these stages and the service boundaries. Sampled worker code confirms interview-question generation and resume-chat dependencies; unsampled service internals are represented only where documented, so some links are dashed.
Main entry points: db PostgreSQL data · resume.controller.ts Resume processing and chat · index.ts Live interview server · interview.controller.ts Question generation
Components 27
User application
- Pravya app
apps/pravya - Interview experience
apps/pravya/src/app/interview - Resume workspace
apps/pravya/src/app/resume
Interview services
- Live interview server
apps/ws-server/src/index.ts - Speech transcription
apps/ws-server/src/lib/deepGramClient.ts - Interview AI
apps/ws-server/src/lib/gemini.ts - Background worker
apps/worker/src/index.ts - Interview job routes
apps/worker/src/routes/interview.routes.ts - Question generation
apps/worker/src/controller/interview.controller.ts - Feedback analysis
apps/worker/src/utils/analyseInterview.ts
Resume services
- Resume upload API
apps/pravya/src/app/api/upload/resume-upload/route.ts - Resume job routes
apps/worker/src/routes/resume.routes.ts - Resume processing and chat
apps/worker/src/controller/resume.controller.ts - PDF parsing
apps/worker/src/utils/parseResume.ts - Text embeddings
apps/worker/src/lib/embedding.ts - Vector search
apps/worker/src/lib/qdrant.ts
Billing and administration
- Checkout and subscription
apps/pravya/src/app/api/checkout/route.ts - Payment webhook
apps/pravya/src/app/api/webhook/dodopayment/route.ts - Admin console
apps/admin/app/admin - Admin APIs
apps/admin/app/api/admin - Email webhooks
apps/webhooks/src/index.ts
Shared platform
- User authentication
packages/auth/index.ts - PostgreSQL data
packages/db - Qdrant
Other components
- Candidate
- Deepgram
- DodoPayments
Connections 36
- Candidate → Pravya app: uses
- Pravya app → User authentication: authenticates with
packages/auth/index.ts - Pravya app → Interview experience: offers
- Interview experience → Live interview server: starts live session
- Live interview server → Speech transcription: transcribes audio
apps/ws-server/src/index.ts - Speech transcription → Deepgram: uses
- Live interview server → Interview AI: streams AI interaction
apps/ws-server/src/index.ts - Live interview server → PostgreSQL data: persists transcript
- Live interview server → Background worker: queues analysis
- Background worker → Interview job routes: mounts routes
- Interview job routes → Question generation: dispatches
apps/worker/src/routes/interview.routes.ts - Question generation → PostgreSQL data: reads and writes
apps/worker/src/controller/interview.controller.ts - Question generation → Feedback analysis: analyzes results
- Question generation → Interview AI: generates questions
apps/worker/src/controller/interview.controller.ts - Interview experience → Feedback analysis: shows feedback
- Candidate → Resume workspace: uploads resume
- Resume workspace → Resume upload API: sends PDF
- Resume upload API → Background worker: submits processing job
- Background worker → Resume job routes: mounts routes
- Resume job routes → Resume processing and chat: dispatches
apps/worker/src/routes/resume.routes.ts - Resume processing and chat → PDF parsing: parses resume
- Resume processing and chat → Text embeddings: creates embeddings
apps/worker/src/controller/resume.controller.ts - Resume processing and chat → Vector search: searches vectors
apps/worker/src/controller/resume.controller.ts - Text embeddings → Qdrant: stores vectors
- Resume processing and chat → PostgreSQL data: reads analysis
apps/worker/src/controller/resume.controller.ts - Resume workspace → Resume processing and chat: chats with resume
- Candidate → Checkout and subscription: subscribes
- Checkout and subscription → User authentication: checks session
apps/pravya/src/app/api/checkout/route.ts - Checkout and subscription → PostgreSQL data: reads user
apps/pravya/src/app/api/checkout/route.ts - Checkout and subscription → DodoPayments: creates checkout
apps/pravya/src/app/api/checkout/route.ts - DodoPayments → Payment webhook: sends events
- Payment webhook → PostgreSQL data: updates payments
apps/pravya/src/app/api/webhook/dodopayment/route.ts - Candidate → Admin console: administers platform
- Admin console → Admin APIs: manages records
- Admin APIs → PostgreSQL data: reads and writes
apps/admin/app/api/admin/create/route.ts - Email webhooks → PostgreSQL data: uses data
apps/webhooks/src/index.ts