@crvouga/ mockingbird-service-vpi (英语)

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

[尖叫声] 我们的应用程序 VPI_API_URL 默认生产 (单位:千美元)https://api.vpicompounding.net,参见 apps/backend/src/modules/erx/clients/vpi-api.client.ts) (中文(简体) ). 未设置的变量发送真实 给真正的药店开处方 堆叠 必须 设定 VPI_API_URL 给此模拟器( 例如 ). http://127.0.0.1:8802只要VPI铁路可以到达.

国家模拟器 妇女 我们的后端驱动器是一个 只有草案的eRx铁路:JWT认证,产品分类/细节/折扣,日用品, 运输状况和费率、诊所地点、提供者、病人名册和详细情况, 供应商签名重复检查, saveNewPrescription,以及三页处方 状况列表 我们的传票人读取。 处方只在测试时才移动( 管理员) 页:1 我们的后端民意调查第1页(限制5).

• 行动范围: 支助
• 供应商不公布具体内容:合同openapi.yaml)是从我们的客户手取出 佐德计划( zod schemas )vpi-api.contracts.ts 外加客户端- 本地策略 vpi-api.client.ts) (中文(简体) ). 接收测试用这些图案的逐字端口来分析每个模拟器的反应.

安装

npm install -D @crvouga/mockingbird-service-vpi

仅限无害环境管理。 节点 22或 Bun 1.2. 无土生属地. 给它服务 npx mockingbird-vpi serve, (中文(简体) ), createServer 从 ./server (节点),或 createRuntime 带有任意 获取服务器 .

使用量

将应用程序指向模拟器并给予其任何证书(任何对日志,除非 accounts 已设定 :

npx mockingbird-vpi serve --port 8802
# app env:
#   VPI_API_URL=http://127.0.0.1:8802           (REQUIRED: the default is production)
#   [email protected]  VPI_API_PASSWORD=anything
#   VPI_CLINIC_LOCATION_ID=65a1c0de00000000000000d1

import { createServer } from "@crvouga/mockingbird-service-vpi/server"

// Test setup: a local VPI.
const server = await createServer()
const baseUrl = server.url // the app's VPI_API_URL
const post = (path: string, body: unknown, headers: Record<string, string> = {}) =>
  fetch(`${baseUrl}${path}`, {
    method: "POST",
    headers: { "content-type": "application/json", ...headers },
    body: JSON.stringify(body),
  })

// Application code: the requests it sends to VPI.
const { jwtToken } = (await (
  await post("/accounts/authenticate", { email: "[email protected]", password: "x" })
).json()) as { jwtToken: string }
// …then POST /clinic/rxOrdering/saveNewPrescription (Bearer jwtToken) saves a draft…

// Test control: move it the way the pharmacy would; our poller maps each status.
await post("/__admin/prescriptions/66b200000000000000000001/transition", {
  to: "Order Completed",
  trackingNumber: "1Z999",
})

await server.close()

种子数据

每个命名空间开始于: 用户 65a1c0de00000000000000a1 (每个登录都决定,除非 accounts 诊所 65a1c0de00000000000000c1,诊所位置 65a1c0de00000000000000d1 ("Acme Main"),供货商格蕾丝·霍珀(NPI) 1234567893编号 65a1c0de00000000000000e1)和艾伦·图灵(NPI) 1987654320),患者艾达·洛芙蕾丝 (单位:千美元)65a1c0de00000000000000f1, DOB 1985-02-14, 1 Main St, Phoenix AZ 8504,并有4个产品: 睾丸酮 丙酮酸64f1c2a9e4b0a1b2c3d4e5f6 编号 : 2185_INJ(a) 无菌,10%的门诊折扣, Se/ B6 特罗切(3097_POW,冷运), Enclomiphene(4410_CAP没有复合 和南德罗罗内(5120_INJ, (中文(简体) ), 控制: 被拒绝 saveNewPrescription) (中文(简体) ). 将其中任何一项替换为 createRuntime({ data: { products, providers, clinicLocations, patients } })。 。 。 .

路线

生命周期和状况清单

我们的消费者 无已交付状态 vPI和铁路草案开始于 processing,所以一个 (b) 支付这种铁路运输的加工/发运(或取消).

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}· ; GET /__admin/faults/presets: token_expired (401次授权电话 count: 1 我们的客户重新认证准确 一次复试成功, unauthorized_twice (重试也失败了), auth_rejected, (中文(简体) ), server_error, (中文(简体) ), duplicate_prescription, (中文(简体) ), save_ambiguous_409 (保存草案,然后409:我们) 分类员说需要审查, save_rate_limited (429,未保存:需要 审查),, save_400 (通过浏览器代理重试), response_drift (分类和产品细节字段更改类型: 我们的zod剖析失败关闭.

命名空间

x-mockingbird-namespace页:1 /__admin/ns/<name> 前缀在 VPI_API_URL,或者通过登录电子邮件: PUT /__admin/credentials {"credentials": {"<VPI_API_EMAIL>": "<namespace>"}} (JWT携带 电子邮件。 认证本身在默认名称空间( 或 /__admin/ns/ 1); 符号 在每个命名空间进行校验.

故意不模拟

• Webhooks:VPI没有;我们的后端民调.
• 患者创建、诊所违约卡计费(encryptedBillingInfo)和提供者签名: 我们的客户没有抓住这些合同, 通过行政API的种子病人.
• 刷新交换(我们的客户端用电子邮件/密码重新认证) .
• 实际定价、税费和运费率表:每名冷冻/消毒/冲刷的费率固定不变.
• 活目录:种子被合成到我们的客户端的域名中(没有沙盒记录).

API 密码

部分 嘲笑鸟。 。 。 .