How ivanslavinskyi/callassist works
SHPROHLI is a multilingual call-assistance application: people prepare and approve a plan, conduct a supported phone conversation, then review saved transcript and optional AI results. The web app initiates user and admin actions through the API; API services coordinate preparation, call execution, persistence, and result delivery. Separate branches cover authentication, credits, safety review, public content, and operational telemetry. Some subsystem links rely on README capability descriptions because their source was not sampled; these are cited to the README rather than presented as inspected call sites.
Main entry points: call-service.ts Call orchestration · app.ts HTTP API · admin-calls-console.tsx Admin console · create-call-form.tsx User web app
Components 18
Web experience
- User web app
apps/web/components/create-call-form.tsx - Admin console
apps/web/components/admin-calls-console.tsx
API workflows
- HTTP API
apps/api/src/app.ts - Accounts and auth
apps/api/src/auth/auth-service.ts - Localized content
apps/api/src/content/content-service.ts - Plan compilation
apps/api/src/brief-compiler/brief-compiler.ts - Call orchestration
apps/api/src/call-service.ts
Call execution
- Live voice session
apps/api/src/voice/unified-live-call.ts - Phone provider
apps/api/src/telephony/telephony-provider.ts - Transcript capture
apps/api/src/storage/native-transcript.ts
Persistence and results
- AI text results
apps/api/src/text-processing/text-artifact-service.ts - Call records
apps/api/src/storage/postgres-call-repository.ts - Credit accounting
apps/api/src/credits/credit-service.ts - Result notifications
apps/api/src/notifications/user-call-notifications.ts
Administration and operations
- Safety review
apps/api/src/safety/plan-review-service.ts - Telemetry exports
apps/api/src/telemetry-export/service.ts - Beta controls
apps/api/src/beta/beta-controls.ts
Other components
- Caller
Connections 19
- Caller → User web app: uses
README.md - User web app → HTTP API: requests
README.md - Admin console → HTTP API: admin requests
README.md - HTTP API → Accounts and auth: authenticates
apps/api/src/app.ts - HTTP API → Localized content: serves content
apps/api/src/app.ts - HTTP API → Plan compilation: compiles plans
- HTTP API → Call orchestration: routes calls
apps/api/src/app.ts - Call orchestration → Live voice session: runs session
README.md - Call orchestration → Phone provider: places calls
apps/api/src/call-service.ts - Live voice session → Transcript capture: captures transcript
README.md - Call orchestration → Call records: persists call
apps/api/src/call-service.ts - Call orchestration → Credit accounting: accounts usage
README.md - Call orchestration → AI text results: creates results
README.md - AI text results → Call records: saves artifacts
- Call orchestration → Result notifications: sends result email
README.md - Admin console → Safety review: reviews plans
- Admin console → Telemetry exports: requests exports
- HTTP API → Beta controls: applies controls
apps/api/src/app.ts - Beta controls → Credit accounting: manages allowances
apps/api/src/beta/beta-controls.ts