How satishreddysr777/fynvic-api works
Fynvic API is the HTTP backend and gateway for an AI mock-interview platform. A candidate authenticates, creates and runs an interview session, submits voice or coding activity, then receives asynchronously scored results and can share a report. The API owns session lifecycle, billing, LiveKit integration, discovery, media, operations, audit, and persistence; assessment materialization and scoring are companion services accessed over authenticated HTTP. The graph reflects documented boundaries and excerpted calls; some major subsystems are represented at module level because their implementation was not sampled.
Main entry points: client.ts Postgres · server.ts HTTP API · routes.ts Session routes · assessment.client.ts Assessment client
Components 31
API runtime
- HTTP API
src/app/server.ts - Route registry
src/lib/router.ts
Identity and commerce
- Authentication
src/modules/auth/routes.ts - Auth guard
src/middleware/auth.ts - User repository
src/modules/auth/services/repository/users.repository.ts - Billing
src/modules/billing/routes.ts - Dodo payments
src/modules/billing/payments/dodo-provider.ts
Interview experience
- Session routes
src/modules/sessions/routes.ts - Session lifecycle
src/modules/sessions/services/sessions.service.ts - Voice rooms
src/modules/livekit/routes.ts - Coding interviews
src/modules/sessions/coding.routes.ts - Share reports
src/modules/sessions/share.routes.ts
Companion services
- Assessment service
- Assessment client
src/clients/assessment.client.ts - Scoring service
- Scoring client
src/clients/scoring.client.ts - Scoring callbacks
src/modules/internal/scoring-persist.service.ts - Service HTTP
src/clients/service-request.ts
Data and operations
- Candidate discovery
src/modules/discovery/discovery.service.ts - Operations tools
src/modules/ops/routes.ts - Retention jobs
src/modules/retention/reaper.ts - Postgres
src/db/client.ts - Auth schema
src/db/schema/auth.ts - Billing schema
src/db/schema/billing.ts - Session schema
src/db/schema/sessions.ts - Assessment schema
src/db/schema/assessments.ts - Audit schema
src/db/schema/audit.ts - Shared enums
src/db/schema/enums.ts
Other components
- Candidate
- Business user
- Voice agent
Connections 35
- Candidate → HTTP API: uses HTTP
README.md - Business user → HTTP API: uses HTTP
README.md - Voice agent → HTTP API: calls callbacks
README.md - HTTP API → Route registry: mounts routes
src/app/server.ts - HTTP API → Authentication: mounts
src/app/server.ts - HTTP API → Billing: mounts
src/app/server.ts - HTTP API → Session routes: mounts
src/app/server.ts - HTTP API → Voice rooms: mounts
src/app/server.ts - Authentication → Auth guard: guards access
- Auth guard → User repository: checks account
src/middleware/auth.ts - Billing → Auth guard: guards checkout
src/modules/billing/routes.ts - Billing → Dodo payments: initiates payment
- Session routes → Session lifecycle: handles lifecycle
src/modules/sessions/routes.ts - Session routes → Assessment client: lists blueprints
- Session routes → Voice rooms: streams recording
src/modules/sessions/routes.ts - Candidate → Session routes: starts interview
README.md - Voice agent → Session routes: posts events
README.md - Candidate → Coding interviews: submits code
README.md - Candidate → Share reports: shares report
README.md - Session lifecycle → Postgres: reads session data
src/modules/sessions/services/sessions.service.ts - Assessment client → Service HTTP: uses HTTP
src/clients/assessment.client.ts - Scoring client → Service HTTP: uses HTTP
src/clients/scoring.client.ts - Assessment client → Assessment service: requests materialization
README.md - Operations tools → Assessment client: proxies authoring
src/modules/ops/routes.ts - Scoring client → Scoring service: requests scoring
README.md - Scoring service → Scoring callbacks: posts results
README.md - Scoring callbacks → Postgres: persists results
- Candidate discovery → Postgres: queries candidates
- Retention jobs → Postgres: purges retained data
- Postgres → Auth schema: uses schema
src/db/client.ts - Postgres → Billing schema: uses schema
src/db/client.ts - Postgres → Session schema: uses schema
src/db/client.ts - Postgres → Assessment schema: uses schema
src/db/client.ts - Postgres → Audit schema: uses schema
src/db/client.ts - Postgres → Shared enums: uses schema
src/db/client.ts