SuperAPI AI 工具集

sesion-clinic-workflow

办公与效率

查看项目

更新于 10-16 02:03

技能介绍

用途

Sesión Clinic Workflow 是一个面向阿根廷心理诊所的 SaaS 平台,目标是把诊所运营中最常见的几个环节——预约排程、患者沟通、开票、远程问诊与临床辅助——整合到同一套系统中。该技能条目为 reason-machines/devtools-skills 下的技能,来源标注为 ara.so 的 Devtools Skills 集合。

主要能力

1. 智能预约排程 后端提供 AgendaService,用于创建预约与生成可用时段。创建预约时会基于 practitionerId、startTime 与 endTime 检测排程冲突,若存在冲突则抛出 “Scheduling conflict detected”;创建成功后将状态置为 SCHEDULED,并触发 WhatsApp 确认消息。getAvailableSlots 会读取执业者的工作日排班(practitionerSchedule),按指定时长(默认 45 分钟)逐段生成可用时段,并排除与已有非取消预约重叠的区间。

2. WhatsApp 自动化(Baileys) WhatsappService 使用 @whiskeysockets/baileys 建立连接,通过 useMultiFileAuthState 保存会话凭证,支持在终端打印二维码;连接断开且非 loggedOut 时自动重连。能力包括:发送预约确认消息(含日期、时间、专业人员和地点或视频链接,提示回复 SI/NO)、发送预约提醒(可设定提前小时数)、处理患者回复的 SI/SÍ 与 NO,以及通过关键词(crisis、urgencia、emergencia、ayuda)进行危机检测并触发执业者告警。

3. AFIP 电子发票 AfipService 基于 @afipsdk/afip.js,使用 CUIT、证书与私钥路径以及生产模式开关初始化。generateInvoice 会查询上一个凭证号并递增,构造包含服务概念、CUIT 文档类型、金额与比索货币的发票数据,向 AFIP 请求 CAE(电子授权码),并在成功后将发票(含 CAE、有效期、类型与 AUTHORIZED 状态)写入数据库。支持发票类型 A、B、C(对应代码 1、6、11)。另提供 generateMonthlyReport,可按执业者与月份/年份汇总发票数量与总金额。

4. 视频问诊与 AI 辅助 平台集成 LiveKit 用于安全视频问诊(配置 API Key、Secret 与 WebSocket URL)。Claude 编排部分使用 Anthropic SDK,配置 Claude Opus 模型与 Sonnet 模型环境变量,示例能力为对临床记录(clinicalNotes)进行摘要;若会话无临床记录则抛出 “No clinical notes available”。

5. 前端界面 前端基于 SvelteKit 5,示例页面展示按日期加载预约列表、日期选择、状态加载提示,以及按预约类型(如 VIRTUAL)展示样式的预约卡片。

使用方式

前置条件:node >= 20.x、pnpm >= 8.x、postgres >= 15.x、redis >= 7.x。

安装步骤:

git clone https://github.com/fahad-hamid/psique-workflow-clinic.git cd psique-workflow-clinic pnpm install cp .env.example .env

需要配置的环境变量分组包括:数据库(DATABASE_URL)、Redis(REDIS_URL)、Anthropic(ANTHROPIC_API_KEY、CLAUDE_OPUS_MODEL、CLAUDE_SONNET_MODEL)、WhatsApp(WHATSAPP_SESSION_PATH、WHATSAPP_WEBHOOK_SECRET)、AFIP(AFIP_CUIT、AFIP_CERTIFICATE_PATH、AFIP_PRIVATE_KEY_PATH、AFIP_PRODUCTION_MODE)、支付(MERCADOPAGO_ACCESS_TOKEN、STRIPE_SECRET_KEY)、LiveKit(LIVEKIT_API_KEY、LIVEKIT_API_SECRET、LIVEKIT_WS_URL)、应用(JWT_SECRET、APP_URL、API_URL)。

数据库迁移:

pnpm prisma generate pnpm prisma migrate deploy pnpm prisma db seed

启动服务:后端在 apps/backend 下执行 pnpm dev,前端在 apps/frontend 下执行 pnpm dev。

项目结构采用 monorepo:apps/backend(NestJS,含 agenda、whatsapp、billing、video、ai、patients 模块与 prisma/schema.prisma)、apps/frontend(SvelteKit,含 routes、lib、stores)、packages/shared 与 packages/config。

适用场景

适用于在阿根廷运营的心理诊所,需要将预约管理、患者 WhatsApp 沟通、AFIP 合规开票、远程视频问诊与临床记录 AI 辅助统一到一个系统中的情况。也适合作为 NestJS + SvelteKit + Prisma 技术栈的参考实现。

限制

现有资料未说明产品的定价、商业化模式、部署托管方式、数据隐私或医疗合规认证情况,也未列出各模块的完整 API 与边界条件,这些内容暂未提供。WhatsApp 连接依赖本地会话文件路径,AFIP 需要有效的证书与私钥,实际使用前需自行准备相应凭证与运行环境。