mirror of
https://dev.azure.com/globalhealthx/EMR/_git/helix-engage-server
synced 2026-04-11 18:08:16 +00:00
Phase 1 of hospital onboarding & self-service plan
(docs/superpowers/plans/2026-04-06-hospital-onboarding-self-service.md).
Backend foundations to support the upcoming staff-portal Settings hub and
6-step setup wizard. No frontend in this phase.
New config services (mirroring ThemeService / WidgetConfigService):
- SetupStateService — tracks completion of 6 wizard steps; isWizardRequired()
drives the post-login redirect
- TelephonyConfigService — Ozonetel + Exotel + SIP, replaces 8 env vars,
seeds from env on first boot, masks secrets on GET,
'***masked***' sentinel on PUT means "keep existing"
- AiConfigService — provider, model, temperature, system prompt addendum;
API keys remain in env
New endpoints under /api/config:
- GET /api/config/setup-state returns state + wizardRequired flag
- PUT /api/config/setup-state/steps/:step mark step complete/incomplete
- POST /api/config/setup-state/dismiss dismiss wizard
- POST /api/config/setup-state/reset
- GET /api/config/telephony masked
- PUT /api/config/telephony
- POST /api/config/telephony/reset
- GET /api/config/ai
- PUT /api/config/ai
- POST /api/config/ai/reset
ConfigThemeModule is now @Global() so the new sidecar config services are
injectable from AuthModule, OzonetelAgentModule, MaintModule without creating
a circular dependency (ConfigThemeModule already imports AuthModule for
SessionService).
Migrated 11 env-var read sites to use the new services:
- ozonetel-agent.service: exotel API + ozonetel did/sipId via read-through getters
- ozonetel-agent.controller: defaultAgentId/Password/SipId via getters
- kookoo-ivr.controller: sipId/callerId via getters
- auth.controller: OZONETEL_AGENT_PASSWORD (login + logout)
- agent-config.service: sipDomain/wsPort/campaignName via getters
- maint.controller: forceReady + unlockAgent
- ai-provider: createAiModel and isAiConfigured refactored to pure factories
taking AiProviderOpts; no more ConfigService dependency
- widget-chat.service, recordings.service, ai-enrichment.service,
ai-chat.controller, ai-insight.consumer, call-assist.service: each builds
the AI model from AiConfigService.getConfig() + ConfigService API keys
Hot-reload guarantee: every consumer reads via a getter or builds per-call,
so admin updates take effect without sidecar restart. WidgetChatService
specifically rebuilds the model on each streamReply().
Bug fix bundled: dropped widget.json.hospitalName field (the original
duplicate that started this whole thread). WidgetConfigService now reads
brand.hospitalName from ThemeService at the 2 generateKey call sites.
Single source of truth for hospital name is workspace branding.
First-boot env seeding: TelephonyConfigService and AiConfigService both
copy their respective env vars into a fresh data/*.json on onModuleInit if
the file doesn't exist. Existing deployments auto-migrate without manual
intervention.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
54 lines
1.8 KiB
TypeScript
54 lines
1.8 KiB
TypeScript
import { Controller, Get, Query, Logger, Header } from '@nestjs/common';
|
|
import { TelephonyConfigService } from '../config/telephony-config.service';
|
|
|
|
@Controller('kookoo')
|
|
export class KookooIvrController {
|
|
private readonly logger = new Logger(KookooIvrController.name);
|
|
|
|
constructor(private telephony: TelephonyConfigService) {}
|
|
|
|
private get sipId(): string {
|
|
return this.telephony.getConfig().ozonetel.sipId || '523590';
|
|
}
|
|
private get callerId(): string {
|
|
return this.telephony.getConfig().ozonetel.did || '918041763265';
|
|
}
|
|
|
|
@Get('ivr')
|
|
@Header('Content-Type', 'application/xml')
|
|
handleIvr(@Query() query: Record<string, any>): string {
|
|
const event = query.event ?? '';
|
|
const sid = query.sid ?? '';
|
|
const cid = query.cid ?? '';
|
|
const status = query.status ?? '';
|
|
|
|
this.logger.log(`Kookoo IVR: event=${event} sid=${sid} cid=${cid} status=${status}`);
|
|
|
|
// New outbound call — customer answered, put them in a conference room
|
|
// The room ID is based on the call SID so we can join from the browser
|
|
if (event === 'NewCall') {
|
|
this.logger.log(`Customer ${cid} answered — dialing DID ${this.callerId} to route to agent`);
|
|
return `<?xml version="1.0" encoding="UTF-8"?>
|
|
<response>
|
|
<dial record="true" timeout="30" moh="ring">${this.callerId}</dial>
|
|
</response>`;
|
|
}
|
|
|
|
// Conference event — user left with #
|
|
if (event === 'conference' || event === 'Conference') {
|
|
this.logger.log(`Conference event: status=${status}`);
|
|
return `<?xml version="1.0" encoding="UTF-8"?>
|
|
<response>
|
|
<hangup/>
|
|
</response>`;
|
|
}
|
|
|
|
// Dial or Disconnect
|
|
this.logger.log(`Call ended: event=${event}`);
|
|
return `<?xml version="1.0" encoding="UTF-8"?>
|
|
<response>
|
|
<hangup/>
|
|
</response>`;
|
|
}
|
|
}
|