添加Docker自包含部署分支

- 新增 Seg_Server_Docker 自包含部署内容,包含前后端、FastAPI、Celery、PostgreSQL、Redis、MinIO、演示视频和 DICOM 数据。

- 保留 demo 数据以支持恢复演示出厂设置,排除 SAM 2.1 .pt 权重并在 README 中补充下载命令。

- 补充 GPU 部署、backend/worker 镜像复用、frpc/frps + NPM 公网域名反代部署说明。

- 在 .env/.env.example 中用 # XXXX 标注局域网和公网域名部署需要修改的配置项。

- 添加部署分支 .gitignore,忽略本地模型权重、构建产物、缓存和日志。
This commit is contained in:
2026-05-07 19:06:07 +08:00
commit b5413066a0
396 changed files with 32742 additions and 0 deletions

34
doc/README.md Normal file
View File

@@ -0,0 +1,34 @@
# 项目文档索引
本目录用于记录当前代码库的真实状态、目标设计与实现差距。文档依据包括:
- 根目录 Word 文档:`语义分割系统构建方案.docx`
- 前端源码:`src/App.tsx``src/components/*.tsx``src/lib/api.ts``src/store/useStore.ts`
- 后端源码:`backend/main.py``backend/routers/*.py``backend/schemas.py``backend/models.py`
- 运行时 OpenAPI`http://localhost:8000/openapi.json`
## 文档结构
| 文档 | 内容 |
|------|------|
| [01-purpose-and-word-summary.md](./01-purpose-and-word-summary.md) | 为什么要做这个系统Word 方案中的目标,以及当前代码的落地程度 |
| [02-current-implementation-map.md](./02-current-implementation-map.md) | 当前系统怎么运行,前后端、存储、数据流具体怎么串起来 |
| [03-frontend-element-audit.md](./03-frontend-element-audit.md) | 前端逐页面/逐元素审计真实可用、半可用、Mock/UI-only、接口不通 |
| [04-api-contracts.md](./04-api-contracts.md) | 前端 API 封装、后端 FastAPI 接口、已完成对齐项和剩余接口问题 |
| [05-implementation-plan.md](./05-implementation-plan.md) | 后续要把 Mock 变成真实功能的建议实施顺序 |
| [06-fastapi-docs-explained.md](./06-fastapi-docs-explained.md) | `http://192.168.3.11:8000/docs` 是什么,怎么看和怎么用 |
| [07-current-requirements-freeze.md](./07-current-requirements-freeze.md) | 当前版本需求冻结,测试以此为准 |
| [08-current-design-freeze.md](./08-current-design-freeze.md) | 当前版本设计冻结,记录模块、数据流和接口边界 |
| [09-test-plan.md](./09-test-plan.md) | 需求到测试文件的覆盖矩阵和运行命令 |
| [10-installation.md](./10-installation.md) | 系统安装部署指南,覆盖 PostgreSQL、Redis、MinIO、后端、Celery、前端和 SAM 2.1 权重 |
| [11-frontend-interaction-state-machines.md](./11-frontend-interaction-state-machines.md) | 前端 UI 交互细节、键盘规则、工具/范围/确认弹窗状态机和对应测试 |
## 状态标记
| 标记 | 含义 |
|------|------|
| 真实可用 | 已接真实前端状态或后端 API按当前代码能完成主要动作 |
| 部分可用 | 有真实数据或真实 UI但存在关键缺口例如只读、不能持久化、缺少错误处理 |
| Mock / UI-only | 只有展示或本地状态变化,没有真实业务效果 |
| 接口不通 | 前端调用和后端接口契约不一致,按当前代码大概率失败 |
| 目标设计 | Word 方案中提出,但当前代码尚未实现 |