pnascimento9596/biotraxiq-overview


一条证据链——从源文件到规范化分析、建模风险以及可审计的定标决策。

BiotraxIQ 帮助医院的财务、供应链和临床工程团队自信地评估医疗设备服务策略。它将 RFP 回复、设备库存、CMMS 工单、支出提取数据、合同、基准证据和供应商资料整合到一个受管理的分析工作流中。 该平台是为应对严峻的现实而构建的：服务投标很少以相同的计量单位描述相同的范围。Pass-through 定价、固定费用、资金池、免责条款、覆盖缺口以及不完整的源数据，可能会使表面上看似最低的投标与五年期最低风险决策存在实质性的差异。 BiotraxIQ 是一款私有的、受访问控制的产品。本仓库是其公开的产品概述；应用源代码和操作文档均为私下维护。 ## 功能 BiotraxIQ 将四个智能模块和一个受管理的 Agent 工作区构建在共享的设备目录、证据模型和分析 pipeline 之上。 | 模块 | 证据输入 | 决策输出 | |---|---|---| | **RFP 分析** | 供应商提案、定价表、库存和辅助说明材料 | 投标规范化、隐藏成本标记、加权评分、Monte Carlo 模拟、五年期 TCO 以及谈判优先级 | | **库存智能** | 设备库存和设备属性 | 三级服务分类、父子映射、幽灵资产检测、模态视图、风险评分和混合服务场景 | | **设备智能** | CMMS 工单和受维护设备记录 | 设备匹配、PM 合规性、可靠性信号、服务历史记录和单设备成本分析 | | **财务智能** | AP/PO 提取数据、基准费率、合同和覆盖范围映射 | 受管理的支出范围、基准比较、推导的成本方案、续订可见性以及有据可查的节省机会 | | **Agent 工作区** | 经授权的 RFP、库存、设备、支出、合同、基准和 TCO 证据 | 工作区范围内的提问、具备来源感知的答案卡片、持久化的咨询记忆、每日简报以及受管理的 PDF/XLSX 制品 | ### 受管理的分析工作流 1. **确定性摄取。** 解析文件类型、列、供应商身份和源结构，而无需在接入路径中引入 LLM。 2. **规范化证据。** 将定价基础、设备身份、覆盖范围和供应商结构转换为类型化的、可比较的合同。 3. **分类资产群。** 将设备评估为依赖 OEM、专业服务、一般生物医学，或在证据不足时明确将其标记为未分类。 4. **分析成本与风险。** 28 阶段 pipeline 应用隐藏成本检测、评分、模拟、基准比较、模态分析和 TCO 预测。 5. **保留溯源。** 源制品、准入输入、绑定、修订和派生输出在整个决策过程中保持可追溯。 6. **提供决策就绪的输出。** 操作员将获得交互式分析，以及面向客户的 PDF 和 Excel 报告。 ### 合同智能 服务合同工作流涵盖文档摄取、章节与条款提取、SLA 与期限分析、覆盖范围审查、缺口检测、风险分析、合同比对、成本估算以及基于来源的修订工作流。 该产品不能替代法律审查。如果无法获取底层的合同证据，生产工作流将直接失败，而不是返回套话。 ## Agent 工作区 Agent 工作区将 BiotraxIQ 受管理的分析服务转化为一个具备证据感知的操作平面。Ask BiotraxIQ 可以跨 RFP 结果、设备库存、CMMS 历史、AP/PO 支出、合同、基准机会和 TCO 调查采购问题，而不会使答案脱离当前的工作区或产生该答案的证据。 | 功能 | 启用的能力 | 控制边界 | |---|---|---| | **受管理的工具使用** | 选择专用的读取工具用于分析摘要、库存、设备、支出、合同、设备/OEM/供应商查询、基准机会以及期限/TCO 视图 | 服务器推导工作区、医院、设施和用户范围；prompt 文本无法扩大该范围 | | **证据优先的答案** | 流式输出叙述性和结构化的答案卡片，包含确切的来源、数据截止日期、安全的深层链接以及可见的“已提取/已计算/AI 生成”信任层级 | 缺失、模棱两可、未经授权或无支持的证据将明确保持不可用状态 | | **工作区记忆与技能** | 可以将明确的用户偏好保留为咨询记忆，并加载有限的产品技能以提供更具相关性的辅助 | 记忆仅限于工作区范围内，可审查、可删除，且永远不会凌驾于源证据之上 | | **决策制品** | 生成绑定来源的 PDF 和 XLSX 输出，以及涵盖续订、近期分析和未决基准机会的按需每日报告 | 制品数值复制自受管理的工具结果；缺失字段将呈现为不可用 | | **共享 Agent 工具层** | 通过产品内助手和经过身份验证的 MCP endpoint 公开相同的经授权分析工具 | 角色和单视图功能限制两个接口中的发现和执行 | ``` flowchart LR Question["Operator question"] --> Scope["Server-derived Workspace and role scope"] Scope --> Tools["Governed analytical tools"] Tools --> Evidence["Typed facts, provenance, and availability"] Evidence --> Answers["Answer cards and source links"] Evidence --> Artifacts["PDF, XLSX, and daily reports"] Memory["Advisory memory and product skills"] -. context only .-> Tools ``` 这种设计使得助手在真正的运营跟进中非常有用，同时保持分析系统——而非模型生成的文字——作为事实和财务数值的权威。 ## 设计上的可审计性 BiotraxIQ 将证据质量视为产品契约的一部分，而不是报告中的脚注。 - **没有捏造的确定性。** 缺失或不可用的证据仍被类型化为不可用；真正的测量零值仍保持为零。 - **确定性摄取。** 数据加载、列映射和供应商识别不依赖于模型可用性。 - **明确的溯源。** 面向用户的数值都与源证据、计算基础或明确标记的演示来源相关联。 - **分离的财务视角。** 基准对比投标、实际对比投标以及归因分析永远不会混合成一个综合的“总节省”数值。 - **读取时财务推导。** 计算出的成本是在服务器端推导和缓存的，而不是持久化存储到分析快照中。 - **受管理的修订。** 更正仅采用追加方式，具有前序感知能力，并受数据库约束和审计记录的保护。 - **租户安全的访问。** 医院、工作区、设施、角色和视图边界由 API 和持久层强制执行。 - **诚实失败行为。** 合同缺口、格式错误的 payload、部分提取和模型不可用性将被明确暴露出来，而不是静默地应用默认值。 ## 架构 | 层 | 实现 | |---|---| | **Web 应用程序** | Next.js 16 App Router, React 19, TypeScript, Tailwind CSS v4, shadcn/ui, Recharts | | **API** | Python 3.11, FastAPI, Pydantic v2, SQLAlchemy, 带有 HttpOnly cookie 的 JWT 身份验证 | | **数据** | 兼容 PostgreSQL 16 的 schema, Alembic 迁移，受管理的快照和源制品模型 | | **分析** | 用于摄取、规范化、分类、风险检测、评分、模拟和报告的类型化 28 阶段 pipeline | | **模型路由** | 通过任务感知路由器调用 Anthropic 模型，用于有限的下游分类和分析；确定性摄取保持无模型状态 | | **报告** | 使用 FPDF2 生成 PDF，使用 openpyxl 生成带有品牌的 Excel 工作簿 | | **生产环境** | Vercel 前端，Render API，Neon PostgreSQL 以及兼容 S3 的快照存储 | API 和前端共享生成的 OpenAPI 契约。生产就绪状态独立于进程活跃度，它验证数据库、迁移和对象存储依赖项，而不会将这些依赖项转变为重启健康检查。 ## 方法论概览 ### 三级设备分类 | 级别 | 服务姿态 | 典型示例 | |---|---|---| | **依赖 OEM** | 通常需要制造商提供服务 | 手术机器人、直线加速器、导管室系统、PET/CT | | **专业服务** | 需要高级专业知识；合格的 ISO 可能参与竞争 | CT、MRI、高端超声、麻醉机、呼吸机 | | **一般生物医学** | 标准 BMET 能力即可支持设备 | 输液泵、患者监护仪、除颤器、病床、秤 | 分类使用受管理的 YAML 规则和 Fennigkoh-Smith 风格的 EM 风险输入。证据不足的设备将明确保持未分类状态，并排除在基于级别的成本分配之外。 ### RFP 评分 评分模型评估成本、技术能力、过渡规划、运营准备情况、参考与经验、创新、网络安全和法规合规性。痛点调整重新分配权重而不改变总权重，并且不可比较的定价将从成本评分中剔除，而不是强制纳入合成的排名中。 ## 访问 [打开 BiotraxIQ](https://biotraxiq.vercel.app/) · [请求演示](mailto:paulo@pnascimento.dev) 这是一个公开的展示仓库。应用源代码为私下维护。 ## 许可证 BiotraxIQ 是专有软件。保留所有权利。 *专利申请中。* ## 作者 **[Paulo Nascimento](https://github.com/pnascimento9596)**

标签：AV绕过, FastAPI, PostgreSQL, 医疗设备管理, 成本预测, 漏洞探索, 财务分析, 采购分析