内容
DentalPin
](https://img.shields.io/badge/lang-en-red.svg)](./[](./README.es.md)
](https://img.shields.io/badge/lang-fr-blue.svg)](.fr.md)
开源牙科诊所管理系统。采用模块化架构，具有可扩展性。
## 为什么选择DentalPin？
世界各地的牙科诊所都有相同的基本需求：管理患者、安排预约、跟踪治疗以及高效地经营诊所。然而，软件环境却被分割成数十种本地化、闭源的解决方案，这些方案将诊所锁定在昂贵的合同和过时的技术中。
**我们相信是时候**
DentalPin 建立在一个简单的理念上：**为全球牙科诊所提供的平台**。不是，而是一个全球，任何诊所都可以采用都可以扩展，任何社区化。
### 为什么
人工智能已经从根本了小型团队可以构建需要大型开发部门的功能现在可以在几天内实现开源牙科软件期——在诊所无法逃脱的之前。
### 我们的- **开源** —诊所数据属于您，应该如此。
- **模块化** — 简单开始功能。无需支付不会使用的功能费用。
全球设计** — 从就为本地化而设计。相同的核心，任何语言。
- **API优先每个功能都是一个任何系统集成，自动化所有操作。
- **AI就绪** — 为AI时代构建。适用于智能调度、临床决策支持和工作流自动化。
### 愿景
我们不仅仅是在构建软件——我们正在为一个生态系统构建基础。一个开发者贡献模块、诊所共享改进、整个牙科社区从集体创新中平台。
诊所理比过去十年封闭、软件更好的选择。D是开放的替代方案。
## ✨ AI 副驾驶
DentalPin 配备了一个**智能AI助手**可以将整个诊所变成对话的实体。要求它查找患者、腾出时间、追踪未回复的预算或当天的日程安排纯西班牙语或英语会根据您的数据。
## 网站
访问 [**dentalpin.com**](https://www.dentalpin.com) 获取产品信息、功能和商业详情。
## 社加入我们的 [**Telegram ://t.me/dentalpin) 获取支持、安装帮助和问题解答。
##
### AI 副驾驶AI 副驾驶/screenshots/ia.png 仪表盘
盘](docs/screenshots)
### 患者管理患者](docs/screenshots.png)
### 每周日
### 付款图表
图表](docs/sments-chart.png)
## 安装构建镜像，无需克需构建。在任何的服务器上：
curl -O https.githubusercontent.com/martinezon/dentalpin-compose.prod.yml
curl https://raw.githubusercontent.cominezsalmeron/d/main/Caddyfile
o .env https.githubusercontent.com/martinezon/dentalpin/main.example
# 在设置PUBLIC_URL、_PASSWORD和SECRET_KEY，然后 compose -f docker-compose up -d
```
将域名指向服务器，设置_URL=https://your-domain并且在首次启动时 — Caddy上支持两种服务CORS，也无需续。设置 `SEEDUP=1`演示诊所并在查看。
镜像：[`pin-backend`](https.com/martinezsal/dentalpin/pkentalpin-backend[`dentalpin-frontend`](https://github.com/martinezsalmeron/dkgs/container/dend)
## （开发）
代码构建并热重
```bash
#
docker-compose up# 种子演示默认为英语）
./scripts.sh
#西班牙语数据
./-demo.sh --lang es
```
打开 http://0
###
所有用户的密码均为：`demo1234`
| 邮箱 | 角色 | 姓名（英文） | 姓名（西班牙语） |
|-------|------|-----------|-----------|
| admin@demo.clinic | 管理员 | Admin Demo | Admin Demo |
| dentist@demo.clinic | 牙医 | Dr. Sarah Johnson | Dra. María García López |
| hygienist@demo.clinic | 卫生师 | | Carlos López Martínez |
@demo.clinic | 助理 | Emily Davis | Ruiz |
| receptionist@demo.clinic | 前台 Brown | Laura Sánchez Pérez |
详见 [docs/user-manual/demo.md](docsual/demo.md)。
##
| 层 |
|-------|-----------|
端 | FastAPI 3.11+) 前端 | Nu3 + Nuxt UI | PostgreSQL |
| 认证 | refresh tokens |
## 功能
### AI 副驾驶 **智能代理** —，计划并患者、日程、提醒、付款和报告任务，通过调用真实操作 **RBAC 对 每个操作都会权限重新检查；代理用户通过 UI 可以，限定在其诊所- **PHI 删除 患者标识符在 提供商之前化；自由文本临床云路径。默认启用
- **确认写入 更改数据的操作中暂停以供明确- **工作流** — 一键式（每日简报访问、填充间隙的主动每日电子邮件摘要
- **双无关** — 支持西班牙语和英语；可 提供商、每个诊所的令### 临床- **患者记录**患者资料，包括联系信息、病史- **牙（牙科图）交互式牙齿跟踪每个牙齿/表
- **历** — 周视图，带有拖列和冲突检测- **治疗目录 可自定义的目录，、价格、增值税类别
### 财务 **预算/ — 创建治疗审批流程（草 待审批 → 已拒绝），患者签名PDF 生成
-** — 从预算或独立发票中生成，自动多种支付方式，PDF 导出
- **付款踪部分付款，付款历史，余额计算
管理
-角色的访问控制** — 五种角色（管理员、牙医、卫生师、助理、前台）具有粒度权限
- **诊室/房间管理** — 定义治疗房间及其日程和颜色
- **专业人员管理** — 将预约分配给特定的牙医/卫生师
### 用户体验
- **器** — 智能下拉菜单，显示患者和热门治疗 **双语界面** — 完整的西班牙语和英语本地化
暗黑模式** — 系统感知主题切换
响应式设计** —台式机和
### 技术特性
- **模块化架构**的系统，易
- **事件总 — 模块间通信，用于通知和集成
- **REST API** — 具有 OpenAPI 文档的完整 API
- **实时更新** — 具有乐观更新的响应式 UI
## 开发
### 先决条件
- Docker 和 Docker Compose
- Python 3.11+（用于本地后端开发）
- Node.js 18+（用于本地前端开发）
### 本地运行
```bash
# 启动所有服务
docker-compose up
# 或单独运行后端
cd backend
pip install -e ".[dev]"
uvicorn app.main:app --reload
# 或单独运行前端
cd frontend
npm install
npm run dev
```
### 数据库管理
```bash
# 重置数据库并运行迁移
./scripts/reset-db.sh
# 数据（默认为英语）
./scripts/seed-demo# 种子演示数据（西班牙语）
./scripts-demo.sh --lang es
# 完整设置 + 种子）
./scripts/setup-demo.sh
```
```bash
# 后端单元测试测试（在 Docker 中）
docker-compose exec backend python -m pytest -v
# 慢速 Alembic 往返测试（按需，参见 docs/technical/creating-modules.md）
docker-compose exec backend python -m pytest -v -m alembic_roundtrip
# 前端单元测试（vitest）
cd frontend
npm run test
```
**浏览器端到端测试（Playwright）位于 `frontend/tests/e/`，驱动整个栈在 `localhost:3000` → `:8000`。在 Alpine 前端容器 Chromium。
```bash次性设置 frontend && npm installpx playwright install chromium)
保栈已启动并 seeded
docker-compose up -d
./scripts/.sh
# 到端测试套件 + RBAC + 患者详细信息烟雾测试）
./scripts/e2e.sh
# 单个文件
./scripts/e2e.sh rbac
# 交互式 UI
./scripts/e2e.sh --ui
```
完整的运行手册 + 固定装置参考： [docs/technical/e2e-testing.md](docs/technical/e2e-testing## 架构entalPin 使用架构。每个自包含的- 声明其 SQLAlchemy 模型
- 提供由
- 可以订阅其他模块的事件
详见 [docs/architecture.md](docs/architecture## 许可证
商业源代码许可证 1.1（BSL 1
**使用限制：** 您不得将 作为商业 SaaS 提供给牙科诊所管理。
**更改日期：** 发行日期起 4 年
**更改许可证：** Apache 2.0
详见 [LICENSE](LICENSE) 获取完整条款。
## 贡献
详见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
---
由 [Dentaltix](https://www.dentaltix.com) 支持
MCP 市场