How ijunaidkhan/medical-ai-frontdesk works
AI Medical Front Desk is a multi-tenant receptionist platform with an Angular practice-management app and NestJS API. Staff sign in, manage practice and approved knowledge, configure the receptionist, and test it in chat; the API also supports conversation review, tasks, audit, and phone-number administration. PostgreSQL enforces tenant isolation. The graph follows documented routes and sampled/indexed references; some subsystem internals and web-to-API client calls were not excerpted, so those links are omitted.
Main entry points: agent.service.ts Test receptionist · app.routes.ts Practice console · knowledge.page.ts Knowledge editor · knowledge.service.ts Knowledge management
Components 22
Practice web app
- Practice console
apps/web/src/app/app.routes.ts - Session state
apps/web/src/app/core/auth/auth.service.ts - Knowledge editor
apps/web/src/app/features/knowledge/knowledge.page.ts - AI settings
apps/web/src/app/features/ai-settings/ai-settings.page.ts - Test chat
apps/web/src/app/features/test-chat/test-chat.page.ts - Activity review
apps/web/src/app/features/activity/activity.page.ts
API and receptionist
- Authentication
apps/api/src/auth/auth.service.ts - Knowledge management
apps/api/src/knowledge/knowledge.service.ts - Receptionist setup
apps/api/src/ai/ai.service.ts - Test receptionist
apps/api/src/agent/agent.service.ts - Language model
apps/api/src/agent/model/language-model.ts - Safety controls
apps/api/src/agent/safety - Conversation review
apps/api/src/agent/conversations.service.ts - Callback tasks
apps/api/src/tasks/tasks.service.ts - Team access
apps/api/src/members/members.service.ts - Practice profile
apps/api/src/practices/practices.service.ts - Audit trail
apps/api/src/audit/audit.service.ts - Phone administration
apps/api/src/voice/phone-numbers.service.ts
Tenant data
- PostgreSQL
apps/api/src/database/database.module.ts
External systems
- Twilio
- Model provider
Other components
- Practice staff
Connections 26
- Practice staff → Practice console: uses
README.md - Practice console → Session state: restores session
apps/web/src/app/app.config.ts - Practice console → Knowledge editor: routes to
apps/web/src/app/app.routes.ts - Practice console → AI settings: routes to
apps/web/src/app/app.routes.ts - Practice console → Test chat: routes to
apps/web/src/app/app.routes.ts - Practice console → Activity review: routes to
apps/web/src/app/app.routes.ts - Practice staff → Authentication: signs in
README.md - Knowledge editor → Knowledge management: manages knowledge
- AI settings → Receptionist setup: configures
- Test chat → Test receptionist: tests receptionist
- Test receptionist → Language model: uses model
apps/api/src/agent/agent.service.ts - Test receptionist → Safety controls: applies safety
apps/api/src/agent/agent.service.ts - Test receptionist → Receptionist setup: loads settings
apps/api/src/agent/agent.service.ts - Test receptionist → Callback tasks: creates tasks
apps/api/src/agent/agent.service.ts - Test receptionist → PostgreSQL: stores conversations
apps/api/src/agent/agent.service.ts - Test receptionist → Model provider: requests completions
- Knowledge editor → Knowledge management: requests service
- Activity review → Conversation review: reviews calls
- Practice staff → Callback tasks: manages callbacks
README.md - Practice staff → Team access: manages team
README.md - Practice staff → Practice profile: updates practice
README.md - Practice staff → Audit trail: reviews activity
README.md - Practice staff → Phone administration: connects numbers
README.md - Phone administration → Twilio: configures numbers
- Authentication → PostgreSQL: reads sessions
apps/api/src/auth/auth.service.ts - Knowledge management → PostgreSQL: stores approved sources