@crvouga/mockingbird-service-pharmetika (中文(简体) )

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

国家模拟器 法尔梅蒂卡 测试套房的复合药剂供应商门户: 诊所和病人的检查、病人的创造、药物订单验证/EPCS准备/提交/ 检查,v7取消, 药物模式目录, 状态网点药店 邮递员 命令只当测试时才移动( 管理过渡或自动推进路径) 模拟时钟.

• 行动范围: 支助
• 供应商不公布具体内容:合同openapi.yaml)是从线上手写的 塑造我们的消费者阅读和写作(pharmetika-fulfillment.adapter.ts, (中文(简体) ), pharmetika-live.client.ts,以及适配器谱中记录的遗体).
• 成功法则. 每具尸体都带着Pharmetika的 success 旗帜。 仅 true 或者说 1 实值 成功:模拟器回答商业故障(未知病人,提交控制物质, 重复使用的命令 id,...) HTTP 200 带 success: 0 财务报告和审定财务报表 messages: [{message, type}],则 我们的适配器卫兵会反对.

安装

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

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

使用量

点 PHARMETIKA_API_URL 在模拟器上给应用程序任何 PHARMETIKA_API_TOKEN (或一针) 与 --api-token) (中文(简体) ). 设定 PHARMETIKA_WEBHOOK_SECRET 在应用程序中传递与 --webhook-secret。 。 。 . PHARMETIKA_PRACTITIONER_IDENTIFIER 可以是任意字符串; PHARMETIKA_CLINIC_NAME=Acme 选择种子诊所.

npx mockingbird-pharmetika serve --port 8801 \
  --webhook-url http://127.0.0.1:3000/prescriptions/webhooks/pharmetika \
  --webhook-secret "$PHARMETIKA_WEBHOOK_SECRET" \
  --auto-advance "2000:data_entry,shipped,completed"

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

// Test setup: a local Pharmetika that posts its status webhooks to the app.
const server = await createServer({
  webhooks: { url: "http://127.0.0.1:3000/prescriptions/webhooks/pharmetika", secret: "whsec" },
})
const baseUrl = server.url // the app's PHARMETIKA_API_URL

// Application code: the order it submits to Pharmetika.
const id = "0192f0c8-7a3e-7cc1-9f5d-3b2a1c4d5e6f"
await fetch(`${baseUrl}/api/v5/provider_portal/medication_order/id/${id}/submit`, {
  method: "PUT",
  headers: { "x-pmk-authentication-token": "pmk_test", "content-type": "application/json" },
  body: JSON.stringify({
    clinic_identifier: "clinic-acme-0001",
    medication_order_identifier: id,
    patient: { identification: { patient_id: 1 } },
    medication_requests: [
      { product_identification: { product_identifier: "PMK-ENCLO-25" }, quantity_authorized: 1, sig: "daily" },
    ],
  }),
})

// Test control: move the order the way the pharmacy would; each step posts the status webhook.
const transition = (body: unknown) =>
  fetch(`${baseUrl}/__admin/orders/${id}/transition`, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify(body),
  })
await transition({ to: "data_entry" })
await transition({ to: "shipped", tracking_id: "1Z999" })
await transition({ to: "completed" })

await server.close()

路线

所有供应商-门户路线都需要 x-pmk-authentication-token (任何非空相,除非 tokens ; 缺少或拒绝的符号是 401 {success: 0, messages}。 。 。 .

网络呼号

每个地位员额改为: --webhook-url 有页眉 x-pharmetika-webhook-secret: <secret> (方言平等,作为我们的接受者检查). 身体形状跟随命名空间 webhookVariant,每个球场一个倒下 我们的接收器说:

ID两个字段都带有我们的UUIDv7(接收器从它那里得到付款)。 非-2xx的答案是: 重审(即即时取出5 s,5 min,30 min,2 h). GET /__admin/webhooks 清单, GET /__admin/webhooks/events 载荷, POST /__admin/webhooks/flush 运行等待重试, PUT /__admin/webhook-endpoints 每个名称空间接收器.

状态图

已设定的过渡 workflow_status 逐字记录,所以任何字符串都有效。 那些我们的地图员知道:

装运或后期状态产生 tracking_id 当未给出时; 跟踪标识促进 提交/处理后运入接收器.

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}· ; GET /__admin/faults/presets:

命名空间

我们的后端 fetch 无法添加信头,所以可以选择三个方式: x-mockingbird-namespace页:1 /__admin/ns/<name> 前缀在 PHARMETIKA_API_URL,或证书: PUT /__admin/credentials {"credentials": {"<PHARMETIKA_API_TOKEN>": "<namespace>"}} (基本法) 用户名对目录客户端同样有效.

故意不模拟

• 真正的完成时间和药房的内部排队:除非 autoAdvance 已经设定.
• EPCS签署本身(两个要素,DEA检查):向 signed 代表着它.
• Sigs,根据订单,文件和理由整理的人口统计被验证,从未被存储 或重复;只有名册保留人口统计 patient_list 返回.
• 活目录: 默认模板在活客户端剖析的字段中合成 (没有沙盒记录);通过 templates 或者说 PUT /__admin/templates 以装入已记录行.
• 复取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取出取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取.

API 密码

部分 嘲笑鸟。 。 。 .