手术抗生素预防推荐咨询工具

抗生物过敏SFAR

WebApp咨询手术抗生素预防建议，基于 RFE SFAR 2024 （法国麻醉和复苏学会专家的正式建议）。

目标

• 即时搜索 ：在几秒钟内找到正确的协议（模糊搜索）
• 按专业导航 ：按外科专业浏览手术
• 聊天机器人IA ：用自然语言提问，获得原始答案
• 公共REST API ：将数据集成到其他工具中
• MCP服务器 ：将LLM客户端（Claude Desktop等）连接到结构化数据
• 研究部分 ：科学出版物的RAG与MCP比较

堆叠技术

Python 3.12·FastAPI·Jinja2·HTMX·CSS原版·Mistral AI·MCP

在线演示

托管在渲染（免费层）。如果应用程序处于待机状态，则首次加载约30秒。

状态

正在开发中。看 文档项目 有关详细信息。

安装速度快

# Prérequis : Python 3.12+, uv (https://docs.astral.sh/uv/)
git clone git@github.com:tomboulier/recos-antibioprophylaxie-SFAR.git
cd recos-antibioprophylaxie-SFAR
uv sync --extra dev
uv run pytest

启动服务器

uv run uvicorn app.main:app --reload

服务器启动于http://localhost:8000.数据 data/rfe.json （406项干预措施，21个专业）在启动时加载到内存中。

可用端点

示例：健康检查

curl http://localhost:8000/api/v1/health

{
  "status": "ok",
  "version": "0.1.0",
  "data_version": "RFE SFAR 2024",
  "specialites": 21,
  "interventions": 406
}

配置

环境变量（可选）：

部署渲染

该应用程序部署在 https://recos-antibioprophylaxie-sfar.onrender.com.

要在上部署您自己的实例： 渲染 :

自动部署（通过render.yaml）

1. 分叉或连接此repo dashboard.render.com
2. 点击 "New → 蓝图” 并选择此repo
3. 渲染自动检测 render.yaml et配置le服务

手动部署

1. New → Web服务 关于Render
2. Connecter le仓库GitHub
3. 通知：
   • 运行时间： Python 3
   • 构建命令： pip install uv && uv sync
   • 启动命令： uvicorn app.main:app --host 0.0.0.0 --port $PORT
   • 健康检查路径： /api/v1/health
4. 添加环境变量：
   • PYTHON_VERSION = 3.12.0
   • DEBUG = false
5. 保留其他默认选项（免费计划）

注： 自由层在15分钟不活动（首次充电约30秒）后进入待机状态。足以进行演示。

文档

Docker/NAS部署

快速启动

# Copier l'exemple de configuration
cp .env.example .env

# Démarrer l'application en arrière-plan
docker compose up -d

该应用程序可在http://localhost:8000.

通过Portainer在Synology NAS上

1. 打开Portainer（例如。http://synologyds224p:9000）
2. 堆栈 → 添加堆栈
3. 粘贴内容 docker-compose.yml
4. 从界面配置环境变量
5. 部署堆栈

有用的命令

docker compose logs -f      # Suivi des logs
docker compose down         # Arrêt et suppression des conteneurs
docker compose pull && docker compose up -d  # Mise à jour

历史

该项目有两个探索性原型，保存在档案分支中：

• archive/prototype-v1-windsurf --卓越原型（Windsurf，2025年火星）
• archive/prototype-v2-mcp MCP原型（2025年2月）

许可证

麻省理工学院

警告

此工具是咨询备忘录。它不能取代临床判断。资料来源：RFE SFAR 2024。