AI 驱动的全球药品可及性平台 比较全球药价 · 查询进口合法性 · AI 药品智能体 让救命药物在世界各地都触手可及、价格可负担。

MediRoute 是一个开源的 HealthTech + RegTech + AI Agent 平台，帮助患者：

这不是药房，也不是交易市场。MediRoute 是一个药品情报平台——可以把它理解为全球药价的 Bloomberg，并内置了合规监管层。

美国的一位癌症患者每月为 Imatinib 支付 9,800 美元。 而完全相同的药物、相同的分子、按 WHO-GMP 标准生产，从印度采购每月只需 208 美元。 大多数患者并不知道这一点。即使知道的人，也不清楚进口该药是否合法。 而那些查到可能合法的人，又不知道该信任哪些供应商。

方案 A —— Docker Compose（推荐，无需本地安装 Python/Node） cp .env.example .env # 至少填写 ANTHROPIC_API_KEY docker compose up --build

前端：http://localhost:5173

后端：http://localhost:8000/docs

该命令会一并启动 Postgres、Redis、后端（热重载）和前端（Vite 开发服务器）。各环境变量的作用详见 docs/ENVIRONMENT.md。

如需接近生产环境的整套服务（构建产物、nginx 反向代理、无热重载——适合测试 Render 之外的自托管部署）： cp .env.example .env # 设置真实的 SECRET_KEY / POSTGRES_PASSWORD 等 docker compose -f docker-compose.prod.yml up --build -d

所有服务通过 nginx 提供：http://localhost/

方案 B —— 仅前端（演示无需后端） cd frontend npm install npm run dev

访问 http://localhost:5173

方案 C —— 不使用 Docker 的全栈方式

后端

cd backend python -m venv venv && source venv/bin/activate pip install -r requirements.txt cp .env.example .env # 填写你的 ANTHROPIC_API_KEY uvicorn app_v3.entrypoint.app:app --reload

API 文档位于 http://localhost:8000/docs

前端（另开终端）

cd frontend cp .env.example .env npm install && npm run dev

架构 MediRoute 采用领域驱动设计（DDD）与模块化单体（Modular Monolith）模式，在规模需要时可随时拆分为微服务。 ├── modules/ │ ├── identity/ # 认证、JWT、RBAC（5 种角色） │ ├── drug_intelligence/ # 100 种药品目录、相互作用、短缺信息 │ ├── compliance/ # 20 条双边进口规则（5×4 国家组合） │ ├── market_intelligence/# 价格比较、供应商信任评分 │ ├── order_workflow/ # 订单状态机 + 托管逻辑 │ └── ai_agent/ # 由 Claude 驱动的咨询 + OCR └── shared/ ├── security/ # JWT、RBAC、不可篡改的审计日志 └── infrastructure/ # 事件总线、缓存（已适配 Redis）、工作单元 完整架构蓝图：docs/10_production_architecture_blueprint.md

mediroute/ ├── backend/ │ ├── app_v3/ # ← 实际运行的后端（DDD 模块化单体） │ ├── alembic/ # 数据库迁移 │ ├── Dockerfile │ └── .env.example ├── frontend/ │ ├── Dockerfile # 生产构建，通过 nginx 提供 │ ├── nginx.conf # 打包进前端镜像的 nginx 配置 │ └── .env.example ├── docker/ │ └── nginx/nginx.conf # 自托管 docker-compose.prod.yml 使用的反向代理 ├── docs/ # 架构、API 设计、环境变量参考 ├── docker-compose.yml # 本地开发栈（热重载） ├── docker-compose.prod.yml # 自托管生产栈（nginx + 构建产物） ├── render.yaml # Render Blueprint（用于托管部署） └── .env.example

MVP 范围（当前） 维度 当前 路线图 国家/地区 5 个（US、CA、IN、SG、GB） 100 个国家/地区 药品目录 8 种旗舰药品 100,000 种药品 合规规则 20 条双边通道 2,000+ 条通道 语言 英语、中文、日语 20+ 种语言 缓存 内存（免费） Redis（付费） 搜索 PostgreSQL 全文检索 Qdrant 向量检索

如何贡献 我们尤其需要以下方面的帮助： ⚠️ 医疗/监管类贡献必须引用来源。无来源的合规规则将被拒绝——错误的进口规则可能伤害患者。

医疗：本平台仅提供信息，不构成医疗建议。在做出用药决定前，请务必咨询执业医师。 监管：进口法规会变化。在进口药品前，请务必向官方机构和持牌报关行核实当前规则。 价格：价格仅供参考。下单前请务必直接与供应商确认当前价格。

层级 技术 前端 React 19、Vite、Tabler Icons 后端 Python 3.12、FastAPI、SQLAlchemy 2.0 数据库 PostgreSQL 16（多 schema DDD） AI Anthropic Claude（Sonnet）、工具调用架构 认证 JWT HS256 → 可升级至 RS256，RBAC + 审计日志 缓存 内存（接口已适配 Redis） 部署 Render（免费套餐）→ 可迁移至 Kubernetes，本地/自托管使用 Docker Compose

完整环境变量参考：docs/ENVIRONMENT.md CI/CD 流水线（GitHub Actions → Render）及其配置方法：docs/CI_CD.md 安全特性（JWT 刷新、限流、密钥管理）——Sprint 3 总结：docs/SPRINT3_SECURITY.md 监控（日志、Prometheus/Grafana、Sentry、可用性告警）——Sprint 4 总结：docs/MONITORING.md 测试（单元/集成/E2E、覆盖率，以及测试发现的两个真实 bug）——Sprint 5 总结：docs/SPRINT5_TESTING.md 国际化（12 个 locale、日期/货币/单位格式化、hreflang）——Sprint 6 总结：docs/SPRINT6_I18N.md API 参考（每个端点、curl 示例、错误码）——Sprint 7：docs/API.md · 交互式文档位于 /docs · SDK：Python、JavaScript · docs/SPRINT7_API_DOCS.md 生产环境评审（发现并修复了一个真实的数据丢失 bug、安全加固、如实列出的已知缺口清单）——Sprint 8：docs/SPRINT8_PRODUCTION_REVIEW.md 国际化（12 个 locale、货币/日期格式化、hreflang）——Sprint 6 总结：docs/SPRINT6_I18N.md

本项目开源，欢迎贡献。这项使命比任何一家公司都更宏大：让救命药物在世界各地都触手可及。

用 ❤️ 打造，献给值得更好对待的患者 文档 · API 参考 · 贡献指南 · 安全