chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/

- run.sh / deploy.sh → scripts/,任意目录可执行,自带环境兜底
- 5 个一次性历史脚本 → scripts/legacy/,补 README 说明用法与执行顺序
- 启动不再自动导入 Excel;导入脚本默认读 data/import/,去掉硬编码路径
- 配套更新 README / MEMORY / Dockerfile / compose / .dockerignore
- 验证:pytest 84 passed;空环境 run.sh 冷启动 200
main
mula.liu 2026-10-29 14:18:54 +08:00
parent 86e4c38872
commit 01a9521bc7
21 changed files with 677 additions and 231 deletions

View File

@ -15,9 +15,12 @@ data
.env.*
!.env.example
# 本机启动/部署脚本
run.sh
deploy.sh
# 本机启动/部署脚本与历史一次性脚本,镜像里都不需要
scripts/run.sh
scripts/deploy.sh
scripts/legacy
tests
requirements-dev.txt
docker-compose.yml
Dockerfile
README.md

2
.env
View File

@ -9,4 +9,4 @@ AI_API_KEY=
AI_MODEL=deepseek-chat
AI_TEMPERATURE=0.2
PORT=8770
PORT=5173

View File

@ -20,8 +20,8 @@ ADMIN_PASSWORD=admin123
# 登录态有效天数
SESSION_DAYS=30
# ---- Docker 部署(deploy.sh / docker-compose.yml 读取)----
# 对外端口。容器内部固定监听 8770,换端口只改这里(上面的 PORT 是本机 run.sh 用的)
# ---- Docker 部署(scripts/deploy.sh / docker-compose.yml 读取)----
# 对外端口。容器内部固定监听 8770,换端口只改这里(上面的 PORT 是本机 scripts/run.sh 用的)
HOST_PORT=8770
# 周期/周次/入库时间等日期按此时区计算,别留 UTC,否则整体差 8 小时
TZ=Asia/Shanghai
@ -32,7 +32,7 @@ TZ=Asia/Shanghai
# 本地是别的名字或别的 tag,就在下面钉死。别把某台机器上的前缀提交进仓库,换台机器就找不到了。
# BASE_IMAGE=python:3.12-slim
# pip 源:构建时在容器里装依赖,容器不认宿主机的代理,只能换源;
# ./deploy.sh 会在容器里真访问一次挑可用的(默认清华源),想固定就取消注释:
# ./scripts/deploy.sh 会在容器里真访问一次挑可用的(默认清华源),想固定就取消注释:
# PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
# 关掉自动探测(源已在上面配好,或机器能直连官方源):CN_MIRROR=0 ./deploy.sh up
# 跳过构建、直接用本地已有镜像(离线机器上 docker load 完之后用):NO_BUILD=1 ./deploy.sh up
# 关掉自动探测(源已在上面配好,或机器能直连官方源):CN_MIRROR=0 ./scripts/deploy.sh up
# 跳过构建、直接用本地已有镜像(离线机器上 docker load 完之后用):NO_BUILD=1 ./scripts/deploy.sh up

View File

@ -0,0 +1,23 @@
# 2026-10-29
本轮:清理 `scripts/`,启动/部署脚本统一迁入 `scripts/`,补齐环境自动安装。
## 结构调整
- `run.sh` → `scripts/run.sh`,`deploy.sh` → `scripts/deploy.sh`;脚本内部用 `BASH_SOURCE/..` 定位项目根目录,任意目录可执行。
- 历史一次性脚本迁到 `scripts/legacy/`:`migrate_custom.py`、`add_entry_date.py`、`fix_period_split.py`、`merge_project.py`、`shift_year.py`;同步修正 `sys.path`(多一层 `parents[2]`)与用法注释。
- `scripts/` 保留启动脚本 + `init_db.py` + 三个导入脚本;新增 `scripts/README.md`、`scripts/legacy/README.md`。
- 启动不再自动导入 Excel;全新库只建空表。导入脚本默认读 `data/import/`,支持 `XLSX` / `STAFF_XLSX` / `CUSTOM_LEDGER_XLSX` 覆盖,去掉了 `/Users/jiliu/...` 与 Desktop 硬编码。
- `.dockerignore` 排除 `scripts/run.sh`、`scripts/deploy.sh`、`scripts/legacy`、`tests`、`requirements-dev.txt`;README / MEMORY / Dockerfile / compose / `.env.example` 路径同步更新。
## 启动兜底
- `scripts/run.sh`:Python 3.10+ 检测(缺了按 `AUTO_INSTALL=1` 用 dnf/yum/apt/apk/brew 装)→ 项目内 `.venv` → 按 `requirements.txt` 的 cksum 判断是否装依赖(默认源失败依次切清华/阿里)→ 缺 `.env` 从示例生成 → 建 `data/{uploads,exports,import}` → 首次建库 → 端口占用检查 → 跨平台开浏览器。
- `scripts/deploy.sh`:任意目录执行;缺 docker 时优先包管理器、再退回 get.docker.com;守护进程没起来尝试 systemd / Docker Desktop;compose 缺失尝试补插件;`AUTO_INSTALL=0` 可关闭自动安装。
## 验证
- 空环境(系统 Python 3.11 无 fastapi)跑 `NO_OPEN=1 DEV=0 ./scripts/run.sh`:自动建 `.venv`、装依赖、建库、启动,`/health` 200,`/` 200。
- 已在运行时重跑:直接提示地址并 `exit 0`;`/tmp` 下执行同样正常;`DEV=1` 热更新参数启动正常。
- `./.venv/bin/python -m pytest -q` → **84 passed**。
- 本机没有 docker,`AUTO_INSTALL=0 ./scripts/deploy.sh status` 按预期打印安装指引并 `exit 1`。

View File

@ -2,15 +2,15 @@
软件部关键任务追踪看板。FastAPI 后端 + 原生 JS 前端 + SQLite。
## 运行环境(Windows)
## 运行环境
`run.sh` 是 macOS 专用(`open`、`/Users/jiliu/...` 绝对路径),Windows 上按以下方式手动跑:
启动脚本在 `scripts/` 下,macOS / Linux / Windows Git Bash 都能跑,自带环境兜底:
- Python 解释器(已装好依赖):`C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe`
- 装依赖:`<PY> -m pip install -r requirements.txt`
- 启动:`<PY> -m uvicorn app.main:app --host 127.0.0.1 --port 8770`
- 端口/配置来自 `.env`(`PORT=8770`)。DB 用 SQLite,落在 `data/board.db`,仓库里已带数据。
- 启动:`./scripts/run.sh`(自动找 Python 3.10+、建 `.venv`、缺依赖自动装、缺 `.env` 从示例生成、首次建库)
- 只检查不安装:`AUTO_INSTALL=0 ./scripts/run.sh`
- 端口/配置来自 `.env`(`PORT=8770`)。DB 用 SQLite,落在 `data/board.db`;首次启动自动建库,已有库直接复用。
- 健康检查:`GET /health`;API 文档:`/api/docs`;首页:`/`。
- Docker:`./scripts/deploy.sh up`(缺 docker / compose 时默认尝试自动安装,`AUTO_INSTALL=0` 关闭)。
## 关键结构
@ -18,7 +18,8 @@
- `app/finance.py`(定制项目财务口径**唯一入口**)、`app/audit.py`(操作日志写入)。
- `web/` 前端:`index.html` / `app.js` / `styles.css` / `icons.js`(零构建,no-cache + ETag)。
- `tests/` + `pytest.ini` + `requirements-dev.txt`:接口级测试(83 例,`./.venv/bin/python -m pytest`),`conftest.py` 把库指到临时文件,**不碰 `data/board.db`**。
- `scripts/` 运维脚本:`init_db.py`、`import_excel.py`、`import_staff.py`、`migrate_custom.py`、`shift_year.py`、`fix_period_split.py`、`merge_project.py`、`add_entry_date.py`、**`import_custom_ledger.py`**(把《定开项目.xlsx》市场台账导入 `custom_projects`,支持 `--dry-run`/`--date`,按 项目ID→名称 匹配做 upsert + 变更比对)。
- `scripts/`:启动/部署 `run.sh`、`deploy.sh`;建库 `init_db.py`;数据导入 `import_excel.py`、`import_staff.py`、**`import_custom_ledger.py`**(《定开项目.xlsx》市场台账 → `custom_projects`,支持 `--dry-run`/`--date`,按 项目ID→名称 upsert)。
- `scripts/legacy/`:历史一次性脚本(`migrate_custom.py`、`shift_year.py`、`fix_period_split.py`、`merge_project.py`、`add_entry_date.py`),不参与启动、不进镜像。
- `.workbuddy/memory/` 存每日工作日志(随仓库提交,2026-09-12 起)。
- `schema_patch.ensure_columns` 会在启动时自动给已有表补上模型里**新增的可空列**(`ALTER TABLE ... ADD COLUMN`),所以加字段只需改 `models.py`,不用写迁移脚本。

View File

@ -1,6 +1,6 @@
# 部门关键任务追踪看板 · 运行镜像
#
# 构建:docker build -t unis-board . (日常部署建议用 ./deploy.sh up)
# 构建:docker build -t unis-board . (日常部署建议用 ./scripts/deploy.sh up)
# 跑: docker run -d -p 8770:8770 -v $PWD/data:/app/data unis-board
#
# 镜像里只有依赖和代码,数据库/附件都在 data/,靠 bind mount 挂进来。
@ -8,7 +8,7 @@
#
# 基础镜像。国内直连 docker.io 会在 load metadata 阶段 TLS 超时,所以支持指成本地已有的镜像:
# docker pull python:3.12-slim && docker build --build-arg BASE_IMAGE=python:3.12-slim .
# ./deploy.sh 会优先用本地已有的同名镜像,不会去联网试各种加速站。
# ./scripts/deploy.sh 会优先用本地已有的同名镜像,不会去联网试各种加速站。
ARG BASE_IMAGE=python:3.12-slim
FROM ${BASE_IMAGE}
@ -28,7 +28,7 @@ COPY requirements.txt ./
# pip 源:默认清华源(国内直连 pypi.org 基本超时,而且换基础镜像/代理都救不了它,
# 构建容器里的请求只能靠这里换源)。境外机器或内网自建源就覆盖:
# docker build --build-arg PIP_INDEX_URL=https://pypi.org/simple .
# ./deploy.sh up 会自动探测可用源并写进 .env,正常不用手工传。
# ./scripts/deploy.sh up 会自动探测可用源并写进 .env,正常不用手工传。
ARG PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
RUN pip install --retries 5 --timeout 60 -i "$PIP_INDEX_URL" -r requirements.txt
# 用 MySQL 部署时放开下面这行(与 requirements.txt 的注释一致)

127
README.md
View File

@ -67,57 +67,68 @@
历史数据的年份口径需要整体调整时:
```bash
python scripts/shift_year.py --dry-run # 先预演,看清楚了再执行
python scripts/shift_year.py # 全部 +1 年
python scripts/shift_year.py --years -1 # 反向回滚
python scripts/legacy/shift_year.py --dry-run # 先预演,看清楚了再执行
python scripts/legacy/shift_year.py # 全部 +1 年
python scripts/legacy/shift_year.py --years -1 # 反向回滚
```
> 历史一次性修数脚本统一收在 `scripts/legacy/`,不参与启动流程。
> 内部按年份从大到小更新,避免 2024→2025 撞上尚未更新的 2025;执行后会校验 sort_key 无重复,有重复则整体回滚。
> 执行前建议手动备份:`cp data/board.db data/board.db.bak`
## 快速开始
```bash
cd /Users/jiliu/WorkSpace/unis_manager
./run.sh
cd /path/to/unis_manager
./scripts/run.sh
```
打开 <http://127.0.0.1:8770>
首次运行 `run.sh` 会自动完成:选择带依赖的 Python 解释器 → 缺依赖则安装 → 建库 → 导入历史 Excel → 拆分定制项目,然后启动并打开浏览器。
首次运行 `scripts/run.sh` 会自动完成:检查 Python 3.10+ → 建项目内 `.venv` → 缺依赖自动安装(默认源失败会依次切国内镜像)→ 缺 `.env` 时从 `.env.example` 生成 → 建库 → 启动并打开浏览器。已有 `data/board.db` 时直接复用,不会覆盖数据。
### 启动方式与排错
| 场景 | 命令 |
|---|---|
| 正常启动 | `./run.sh` |
| 报 `permission denied` | `chmod +x run.sh` 后重试(**不要用 sudo**) |
| 不想改权限 | `bash run.sh` |
| 换端口 | `PORT=8771 ./run.sh` |
| 关闭热加载 | `DEV=0 ./run.sh`(默认是开着的) |
| 不自动开浏览器 | `NO_OPEN=1 ./run.sh` |
| 正常启动 | `./scripts/run.sh` |
| 报 `permission denied` | `chmod +x scripts/run.sh` 后重试(**不要用 sudo**) |
| 不想改权限 | `bash scripts/run.sh` |
| 缺 Python / 依赖 | 脚本自动安装;不想自动装就设 `AUTO_INSTALL=0`,脚本只打印命令 |
| 换端口 | `PORT=8771 ./scripts/run.sh` |
| 关闭热加载 | `DEV=0 ./scripts/run.sh`(默认是开着的) |
| 不自动开浏览器 | `NO_OPEN=1 ./scripts/run.sh` |
| 提示"端口已被占用" | 原窗口 `Ctrl+C`,或 `lsof -ti:8770 \| xargs kill` 后重跑 |
| 用 Docker 部署(不装 Python) | `./deploy.sh up`,见下面「Docker 部署」 |
| 用 Docker 部署(不装 Python) | `./scripts/deploy.sh up`,见下面「Docker 部署」 |
> ⚠️ 不要用 `sudo` 启动:数据库文件会变成 root 属主,后续写入会失败。
> **热更新(默认开启)**:uvicorn 除 `*.py` 外还会监听 `web/**` 的 js/css/html 与 `.env`,改动即重启;
> 页面里的 `web/livereload.js` 每秒读一次 `/health` 的启动代际,发现服务重启后自动刷新浏览器。
> 也就是说改完代码**不用手动重启、也不用手动刷新**。`DEV=0 ./run.sh` 可关掉(关闭后该脚本首轮即自行停止)。
> 也就是说改完代码**不用手动重启、也不用手动刷新**。`DEV=0 ./scripts/run.sh` 可关掉(关闭后该脚本首轮即自行停止)。
> `data/*.db` 的写入不会触发重启。
### 手动分步执行(等价于 run.sh 干的事)
### 手动分步执行(等价于 scripts/run.sh 干的事)
```bash
pip install -r requirements.txt
python scripts/init_db.py
python scripts/import_excel.py "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
python scripts/migrate_custom.py
python -m uvicorn app.main:app --port 8770
python3 -m venv .venv
./.venv/bin/pip install -r requirements.txt
./.venv/bin/python scripts/init_db.py
./.venv/bin/python -m uvicorn app.main:app --port 8770
```
> 重新导入:`python scripts/import_excel.py <xlsx> --reset` 之后再跑一次 `python scripts/migrate_custom.py`
> (迁移脚本会删除常规表里的「定制开发」容器,重复执行前请先 reset)
> Windows 把 `.venv/bin/` 换成 `.venv/Scripts/`。
**从旧 Excel 还原历史数据**(一次性,相关脚本已归档到 `scripts/legacy/`):
```bash
./.venv/bin/python scripts/import_excel.py "<软件开发部管理工作执行表.xlsx>" --reset
./.venv/bin/python scripts/legacy/migrate_custom.py
./.venv/bin/python scripts/import_staff.py "<软件开发部人员名单.xlsx>"
```
> 现在 `scripts/run.sh` 首次启动**只建空库**,不再自动导入 Excel。已有数据库的机器直接把 `data/board.db` 带过去即可。
### Docker 部署(换机器 / 上服务器)
@ -125,7 +136,7 @@ python -m uvicorn app.main:app --port 8770
```bash
cd /path/to/unis_manager
./deploy.sh up # 构建镜像 + 后台启动 + 等健康检查
./scripts/deploy.sh up # 构建镜像 + 后台启动 + 等健康检查
```
打开 <http://127.0.0.1:8770>。首次启动自动建表、预置分类,并创建内置角色与 `admin` 账号(密码见 `.env`)。
@ -134,20 +145,20 @@ cd /path/to/unis_manager
|---|---|
| `Dockerfile` | 运行镜像:装依赖 + 拷 `app/ web/ scripts/`;启动时先跑 `init_db.py`(幂等)再起 uvicorn |
| `docker-compose.yml` | 编排:`./data` 挂进容器存数据库、`HOST_PORT` 控对外端口、`restart: unless-stopped` 随 Docker 自启 |
| `deploy.sh` | 命令封装:`up` / `update` / `restart` / `down` / `logs` / `status` / `backup` / `mirror`,顺带检查 docker 是否在跑、`.env` 与 `data/` 是否存在,并在构建前定好基础镜像与 pip 源 |
| `scripts/deploy.sh` | 命令封装:`up` / `update` / `restart` / `down` / `logs` / `status` / `backup` / `mirror`,顺带检查 docker 是否在跑、`.env` 与 `data/` 是否存在,并在构建前定好基础镜像与 pip 源 |
| `.dockerignore` | 保证 `data/`、`.env`、`.git` 不会被烤进镜像 |
| 场景 | 命令 |
|---|---|
| 改完代码上线 | `./deploy.sh update`(重建镜像并替换容器) |
| 改了 `.env`(AI Key / 端口) | `./deploy.sh restart` |
| 看日志排错 | `./deploy.sh logs` |
| 看状态与健康检查 | `./deploy.sh status` |
| 停止(数据保留) | `./deploy.sh down` |
| 换对外端口 | `.env` 里 `HOST_PORT=8080`,再 `./deploy.sh up` |
| 改完代码上线 | `./scripts/deploy.sh update`(重建镜像并替换容器) |
| 改了 `.env`(AI Key / 端口) | `./scripts/deploy.sh restart` |
| 看日志排错 | `./scripts/deploy.sh logs` |
| 看状态与健康检查 | `./scripts/deploy.sh status` |
| 停止(数据保留) | `./scripts/deploy.sh down` |
| 换对外端口 | `.env` 里 `HOST_PORT=8080`,再 `./scripts/deploy.sh up` |
| 裸 compose 命令 | `docker compose up -d --build` / `docker compose down` |
| 构建时基础镜像 / pip 下载超时 | `./deploy.sh mirror` 重探,或手工指定 `PIP_INDEX_URL=... BASE_IMAGE=... ./deploy.sh up`(见下「国内网络加速」) |
| 把现有数据带到新机器 | `./deploy.sh backup` → 拷到目标机 `data/board.db` → `./deploy.sh up` |
| 构建时基础镜像 / pip 下载超时 | `./scripts/deploy.sh mirror` 重探,或手工指定 `PIP_INDEX_URL=... BASE_IMAGE=... ./scripts/deploy.sh up`(见下「国内网络加速」) |
| 把现有数据带到新机器 | `./scripts/deploy.sh backup` → 拷到目标机 `data/board.db` → `./scripts/deploy.sh up` |
#### 国内网络加速(docker.io / pypi.org 连不上时)
@ -158,15 +169,15 @@ cd /path/to/unis_manager
| ① 守护进程拉基础镜像 | `failed to resolve source metadata for docker.io/library/python:3.12-slim: ... TLS handshake timeout` | 用本地已有的镜像(`BASE_IMAGE=` 指定),或先 `docker pull` / 给守护进程配 registry-mirrors |
| ② 构建容器里装依赖 | `[4/8] RUN pip install ... -i https://pypi.org/simple` 非零退出 | 换 pip 源 `PIP_INDEX_URL`(清华 / 阿里 / 腾讯) |
`./deploy.sh up` 构建前把这两道都定下来,原则是**能本地解决就不联网**:
`./scripts/deploy.sh up` 构建前把这两道都定下来,原则是**能本地解决就不联网**:
- 基础镜像只看本地有没有:`BASE_IMAGE` 指定的镜像在本地 → 直接用;只有同名 tag(如 `python:3.12-slim`)→ 也用(仓库前缀只是当初从哪儿拉的,镜像是同一份)。本地确实没有才试拉一次(守护进程配的 registry-mirrors 在这一步生效),还拉不到就**直接报错停下**并打印补救命令——不去逐个试加速站,那种循环只会白等几分钟。
- pip 源:在构建用的容器里真 `urlopen` 一次逐个试(容器网络 = 构建网络,比宿主机 curl 准),默认清华源。
- 定下来的值只 export 给本次构建,**不写回 `.env`**(`.env` 在 git 里,把某台机器的地址带到另一台机器正是故障源)。
```bash
./deploy.sh up # 定源(本地有镜像就不联网)→ 构建 → 等健康检查
./deploy.sh mirror # 重探一次 pip 源,并打印可写进 .env 的两行
./scripts/deploy.sh up # 定源(本地有镜像就不联网)→ 构建 → 等健康检查
./scripts/deploy.sh mirror # 重探一次 pip 源,并打印可写进 .env 的两行
```
> **别把某台机器上的 `BASE_IMAGE` 前缀提交进仓库。** 换机器后那个前缀对应的镜像本地不存在,构建就会卡在 `load metadata`;这行留空或写裸 `python:3.12-slim`,让每台机器自己的镜像说了算。
@ -184,32 +195,32 @@ docker compose up -d
- **基础镜像拉成功 ≠ 构建能过**:`docker pull` 只治①,容器里的 `pip install` 照旧撞 pypi.org,必须另外给②换源。
- **shell 里的 `HTTP(S)_PROXY` 对构建没用**:Docker 守护进程和构建容器都不读宿主机的代理变量。要走代理得在 Docker Desktop → Settings → Resources → Proxies 里配 `http://host.docker.internal:7897`(端口换成你本机代理的)。
- **境外机器 / 内网有自建源**:`CN_MIRROR=0 ./deploy.sh up` 跳过 pip 探测,源完全由 `.env` 说了算。
- **目标机完全不能上网**:走离线路。`docker save -o unis-board.tar unis-board:latest` → 拷过去 `docker load -i unis-board.tar` → `NO_BUILD=1 ./deploy.sh up`(跳过构建直接用本地镜像)。
- 构建失败时脚本会自己打印一份排查清单(`deploy.sh` 的 `build_hint`),照抄命令即可。
- **境外机器 / 内网有自建源**:`CN_MIRROR=0 ./scripts/deploy.sh up` 跳过 pip 探测,源完全由 `.env` 说了算。
- **目标机完全不能上网**:走离线路。`docker save -o unis-board.tar unis-board:latest` → 拷过去 `docker load -i unis-board.tar` → `NO_BUILD=1 ./scripts/deploy.sh up`(跳过构建直接用本地镜像)。
- 构建失败时脚本会自己打印一份排查清单(`scripts/deploy.sh` 的 `build_hint`),照抄命令即可。
几个坑:
- **数据只落在 `./data`**:重建镜像、`down` 再 `up` 都不动数据;备份依旧是拷走 `data/board.db`。
- **时区必须设**:容器默认 UTC,而周期/周次/入库时间都按本地日期算,所以 compose 固定传 `TZ=Asia/Shanghai`,别删。
- **容器内端口固定 8770**:`.env` 的 `PORT` 是本机 `run.sh` 用的,compose 里覆盖成 8770;要换端口只改 `HOST_PORT`。
- **别和 `run.sh` 同时跑**:一是 SQLite 是文件库,同一份 `board.db` 不要同时被本机进程和容器读写;二是本机进程绑的是 `127.0.0.1:8770`,比 Docker 发布的 `*:8770` 更精确,浏览器和 `curl 127.0.0.1:8770` 会全打到本机服务上(症状:`/health` 里 `dev` 是 `true`,而容器是 `false`)。两者要共存就给容器换端口:`HOST_PORT=8899 ./deploy.sh up`。
- **容器内端口固定 8770**:`.env` 的 `PORT` 是本机 `scripts/run.sh` 用的,compose 里覆盖成 8770;要换端口只改 `HOST_PORT`。
- **别和 `scripts/run.sh` 同时跑**:一是 SQLite 是文件库,同一份 `board.db` 不要同时被本机进程和容器读写;二是本机进程绑的是 `127.0.0.1:8770`,比 Docker 发布的 `*:8770` 更精确,浏览器和 `curl 127.0.0.1:8770` 会全打到本机服务上(症状:`/health` 里 `dev` 是 `true`,而容器是 `false`)。两者要共存就给容器换端口:`HOST_PORT=8899 ./scripts/deploy.sh up`。
- **换 MySQL**:放开 `Dockerfile` 里 `pymysql` 那行重新 build,再把 `.env` 的 `DATABASE_URL` 指过去(见「迁移到 MySQL」)。
### 带着现有数据部署
镜像里**故意不含数据**(`.dockerignore` 排除了 `data/`),容器读的是宿主机挂载进来的 `./data/board.db`,所以:
- **就在本机这个目录部署** → 什么都不用做,`./deploy.sh up` 起来读的就是当前这份库;连 `user_sessions` 里的登录态都延续,别人不用重新登录。
- **就在本机这个目录部署** → 什么都不用做,`./scripts/deploy.sh up` 起来读的就是当前这份库;连 `user_sessions` 里的登录态都延续,别人不用重新登录。
- **换一台机器部署** → 先把数据取出来,落到目标机的 `./data/board.db`:
```bash
./deploy.sh backup # 一致性快照 → data/backups/board-YYYYmmdd_HHMMSS.db
./scripts/deploy.sh backup # 一致性快照 → data/backups/board-YYYYmmdd_HHMMSS.db
scp data/backups/board-*.db user@host:/srv/unis_manager/data/board.db
ssh user@host 'cd /srv/unis_manager && ./deploy.sh up'
ssh user@host 'cd /srv/unis_manager && ./scripts/deploy.sh up'
```
> - `data/board.db` 本身在 git 里,`git clone` 也会带一份,但那是**最后一次提交**的状态;要「当前最新」请用 `./deploy.sh backup` 的快照(走 SQLite 备份 API,本机服务正在写也能拿到一致的库)。
> - 数据库不在 git 里(`data/` 已忽略),`git clone` 不会带数据;要迁移请用 `./scripts/deploy.sh backup` 的快照(走 SQLite 备份 API,本机服务正在写也能拿到一致的库)。
> - 启动时的 `init_db.py` 和 `ensure_seed` 只会**补**缺失的表 / 分类 / 内置角色,`users` 非空就不再创建 `admin`,不会覆盖或清空任何数据。实测:拿当前生产库快照起容器,启动前后逐表行数完全一致,123 个定制项目、22 名人员、老 token 全部照常可用。
> - 目标机上的 `./data` 属主要和运行容器的人对得上(compose 以 root 跑则无此顾虑);SQLite 是文件库,同一份库别让两个实例同时写。
@ -255,8 +266,8 @@ ssh user@host 'cd /srv/unis_manager && ./deploy.sh up'
把两个项目合并成一个(例如把「智空无人机平台」并入「智飞无人机平台」):
```bash
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
```
- 子任务同名 → 归并到目标项目的同名子任务,执行记录一并转挂
@ -321,9 +332,11 @@ python scripts/merge_project.py --from "智空无人机平台" --to "智飞无
python scripts/import_staff.py --dry-run # 只看解析结果
python scripts/import_staff.py # 增量导入(同名跳过,不覆盖页面上的编辑)
python scripts/import_staff.py --reset # 清空后重新导入
python scripts/import_staff.py <xlsx> # 指定别的文件;首次运行 ./run.sh 会自动导入
python scripts/import_staff.py <xlsx> # 指定别的文件(不会随启动自动导入)
```
> 不传路径时默认读 `data/import/软件开发部人员名单.xlsx`,也可以用 `STAFF_XLSX` 环境变量指定。
**负责人下拉**(`ownerSelectHtml`)在项目新建/详情、定制项目新建/详情、工作看板等位置统一使用,选项来自花名册:
已归档的人不再作为可选项出现,只有他本来就是这条记录的负责人时才带「(已归档)」标注出现一次;
历史数据里花名册没有的人名同样补一个「(不在花名册)」选项,保证打开老项目不会把负责人改没。
@ -343,9 +356,9 @@ python scripts/import_staff.py <xlsx> # 指定别的文件;首次运行 .
字段可在明细表中直接改,也可在抽屉里改;重新计算用:
```bash
python scripts/add_entry_date.py --dry-run # 预演
python scripts/add_entry_date.py # 回填(跳过已有值)
python scripts/add_entry_date.py --force # 全部重算
python scripts/legacy/add_entry_date.py --dry-run # 预演
python scripts/legacy/add_entry_date.py # 回填(跳过已有值)
python scripts/legacy/add_entry_date.py --force # 全部重算
```
### 区域(省级行政区)
@ -534,7 +547,7 @@ AuditLog(用户, 动作 create|update|delete|login|logout|deny, 菜单, 方法,
```
DATABASE_URL=mysql+pymysql://user:password@127.0.0.1:3306/unis_board?charset=utf8mb4
```
3. 重启服务(表结构自动创建),再依次执行 `import_excel.py --reset` 与 `migrate_custom.py`。
3. 重启服务(表结构自动创建)。全新库如果要从旧 Excel 还原历史数据,再依次执行 `scripts/import_excel.py --reset` 与 `scripts/legacy/migrate_custom.py`。
数据访问层全部使用 SQLAlchemy ORM,无原生 SQL、无 SQLite 专有语法,切换方言无需改业务代码。
@ -556,12 +569,18 @@ app/
projects · custom(定制项目 + 财务) · focus · staff · ai · export
web/ index.html · styles.css · app.js · icons.js(零依赖,无构建步骤)
tests/ pytest 接口测试(conftest 用临时库,绝不碰 data/board.db)
scripts/ init_db.py · import_excel.py · import_custom_ledger.py · migrate_custom.py · import_staff.py
add_entry_date.py · fix_period_split.py · merge_project.py · shift_year.py
scripts/
run.sh 本地启动:Python / venv / 依赖 / .env / 建库自动兜底
deploy.sh Docker 部署命令封装:up / update / restart / down / logs / status / backup / mirror
init_db.py 建表 + 预置分类(启动时幂等)
import_excel.py 历史 Excel(周工作情况总结 / 项目明细表)导入
import_staff.py 人员名单导入
import_custom_ledger.py 定开项目市场台账导入
legacy/ 一次性历史修数脚本(shift_year · merge_project · migrate_custom ·
add_entry_date · fix_period_split),不参与启动流程
data/board.db SQLite 数据库
Dockerfile 运行镜像(依赖 + 代码,启动时自动补表/预置分类)
docker-compose.yml 部署编排(./data 持久化、HOST_PORT、健康检查)
deploy.sh 部署命令封装:up / update / restart / down / logs / status
.dockerignore 排除 data/ 与 .env,不把数据和密钥打进镜像
```

View File

@ -1,10 +1,10 @@
# 部门关键任务追踪看板 · 部署编排
#
# 常用命令(推荐用封装脚本,会顺带检查 docker/.env/data 目录并等健康检查):
# ./deploy.sh up 构建 + 后台启动
# ./deploy.sh update 改完代码重建并替换容器
# ./deploy.sh logs # 看日志
# ./deploy.sh down # 停止(数据留在 ./data)
# ./scripts/deploy.sh up 构建 + 后台启动
# ./scripts/deploy.sh update 改完代码重建并替换容器
# ./scripts/deploy.sh logs # 看日志
# ./scripts/deploy.sh down # 停止(数据留在 ./data)
#
# 等价的裸 compose 命令:docker compose up -d --build
@ -13,7 +13,7 @@ services:
build:
context: .
args:
# 基础镜像仓库前缀 + pip 源,都由 deploy.sh 探测后写进 .env(也可手工在 .env 里钉死)
# 基础镜像仓库前缀 + pip 源,都由 scripts/deploy.sh 探测后写进 .env(也可手工在 .env 里钉死)
BASE_IMAGE: "${BASE_IMAGE:-python:3.12-slim}"
PIP_INDEX_URL: "${PIP_INDEX_URL:-https://pypi.tuna.tsinghua.edu.cn/simple}"
image: unis-board:latest

100
run.sh
View File

@ -1,100 +0,0 @@
#!/usr/bin/env bash
# DMS管理平台 · 启动脚本
# 用法: ./run.sh 正常启动(默认开热更新)
# PORT=8771 ./run.sh 换端口启动
# DEV=0 ./run.sh 关闭热更新(改代码不自动重启、页面不自动刷新)
# NO_OPEN=1 ./run.sh 启动后不自动打开浏览器
set -euo pipefail
cd "$(dirname "$0")"
# 热更新默认开启:改 Python / 前端 / .env 自动重启服务,页面发现重启后自动刷新。
# 需要 DEV 也传给 app.config(/health 的 dev 标记决定页面是否轮询),所以这里 export 出去。
DEV="${DEV:-1}"
export DEV
PORT="${PORT:-8770}"
XLSX="${XLSX:-/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx}"
STAFF_XLSX="${STAFF_XLSX:-/Users/jiliu/WorkSpace/unissense/部门管理/软件开发部人员名单.xlsx}"
echo "==> DMS管理平台"
# ---------- 1. 选择带依赖的 Python 解释器 ----------
CANDIDATES=(
"./.venv/bin/python"
"/Users/jiliu/.workbuddy/binaries/python/envs/default/bin/python"
"$(command -v python3 2>/dev/null || true)"
"/usr/bin/python3"
)
PY=""
FALLBACK=""
for c in "${CANDIDATES[@]}"; do
[ -n "$c" ] && [ -x "$c" ] || continue
[ -z "$FALLBACK" ] && FALLBACK="$c"
if "$c" -c "import fastapi, uvicorn, sqlalchemy" >/dev/null 2>&1; then
PY="$c"; break
fi
done
if [ -z "$PY" ]; then
PY="$FALLBACK"
if [ -z "$PY" ]; then
echo "!! 没有找到 Python 3,请先安装后再运行。" >&2
exit 1
fi
echo "==> 缺少依赖,正在安装到 $PY"
"$PY" -m pip install -r requirements.txt || {
echo "!! 依赖安装失败,请手动执行:" >&2
echo " $PY -m pip install -r requirements.txt" >&2
exit 1
}
fi
echo " 使用解释器:$PY"
# ---------- 2. 端口占用检查(已在运行就直接给出地址) ----------
if curl -s -o /dev/null --max-time 2 "http://127.0.0.1:${PORT}/health" 2>/dev/null; then
echo "==> 端口 ${PORT} 上已有服务在运行"
echo " 看板地址: http://127.0.0.1:${PORT}"
echo " (要重启请先在原窗口按 Ctrl+C,或执行:lsof -ti:${PORT} | xargs kill)"
exit 0
fi
# ---------- 3. 首次运行:建库 + 导入历史数据 ----------
if [ ! -f data/board.db ]; then
echo "==> 首次运行,初始化数据库"
"$PY" scripts/init_db.py
if [ -f "$XLSX" ]; then
echo "==> 导入历史数据:$XLSX"
"$PY" scripts/import_excel.py "$XLSX"
echo "==> 拆分定开项目"
"$PY" scripts/migrate_custom.py
else
echo " (未找到 Excel 源文件,跳过历史数据导入:$XLSX)"
fi
if [ -f "$STAFF_XLSX" ]; then
echo "==> 导入人员名单:$STAFF_XLSX"
"$PY" scripts/import_staff.py "$STAFF_XLSX"
else
echo " (未找到人员名单,跳过人力库导入:$STAFF_XLSX)"
fi
fi
# ---------- 4. 启动 ----------
# uvicorn 默认只监听 *.py,这里补上前端文件与 .env
RELOAD_ARGS=()
if [ "$DEV" = "1" ]; then
RELOAD_ARGS=(--reload
--reload-include "*.js" --reload-include "*.css" --reload-include "*.html"
--reload-include ".env")
fi
URL="http://127.0.0.1:${PORT}"
echo "==> 启动服务: $URL"
echo " API 文档: $URL/api/docs"
echo " 停止服务: Ctrl+C"
echo
if [ "${NO_OPEN:-0}" != "1" ]; then
( sleep 3; open "$URL" >/dev/null 2>&1 || true ) &
fi
exec "$PY" -m uvicorn app.main:app --host 127.0.0.1 --port "$PORT" ${RELOAD_ARGS[@]+"${RELOAD_ARGS[@]}"}

36
scripts/README.md 100644
View File

@ -0,0 +1,36 @@
# scripts/ 目录说明
运维 / 启动脚本统一收在这里。所有脚本都自带 `cd 项目根目录`,在哪个目录执行都可以。
## 启动与部署
| 文件 | 用途 |
|---|---|
| `run.sh` | 本地启动。自动检查 Python 3.10+、创建 `.venv`、缺依赖自动 `pip install`(默认源失败会切国内镜像)、缺 `.env` 从 `.env.example` 生成、首次运行建库,然后起 uvicorn |
| `deploy.sh` | Docker 部署。`up` / `update` / `restart` / `down` / `logs` / `status` / `backup` / `mirror`;缺 docker / compose 时按 `AUTO_INSTALL=1` 尝试安装并拉起守护进程 |
```bash
./scripts/run.sh # 本地启动(默认热更新)
PORT=8771 ./scripts/run.sh # 换端口
AUTO_INSTALL=0 ./scripts/run.sh # 只检查环境,不自动安装
./scripts/deploy.sh up # Docker 构建 + 后台启动
./scripts/deploy.sh logs # 跟踪日志
```
## 数据导入(按需手动执行)
| 文件 | 用途 |
|---|---|
| `init_db.py` | 建表 + 预置分类(幂等,`run.sh` / 容器启动会自动调用) |
| `import_excel.py` | 导入《软件开发部管理工作执行表.xlsx》 |
| `import_staff.py` | 导入《软件开发部人员名单.xlsx》 |
| `import_custom_ledger.py` | 导入《定开项目.xlsx》市场台账(`--dry-run` 预演) |
> 导入脚本不传路径时,默认读 `data/import/` 下的同名文件;
> 也可以用 `XLSX` / `STAFF_XLSX` / `CUSTOM_LEDGER_XLSX` 环境变量或命令行参数指定。
## legacy/(历史一次性脚本)
旧数据修复 / 迁移脚本,**不参与启动流程**,也不需要放进 Docker 镜像。
只有遇到对应的历史数据问题时才手动执行,详见 [`legacy/README.md`](legacy/README.md)。

View File

@ -1,30 +1,132 @@
#!/usr/bin/env bash
# 部门关键任务追踪看板 · Docker 部署脚本
# 用法: ./deploy.sh up 构建镜像并后台启动(默认命令)
# ./deploy.sh update 改完代码后重建镜像并替换容器
# ./deploy.sh restart 重启容器(不换镜像)
# ./deploy.sh down 停止并删除容器,数据留在 ./data
# ./deploy.sh logs 跟踪日志(Ctrl+C 退出)
# ./deploy.sh backup 导出数据库快照(部署到新机器时带走数据)
# ./deploy.sh status 容器状态 + 健康检查 + 访问地址
# ./deploy.sh mirror 重新探测可用的 pip 源(基础镜像只认本地已有的,不去试加速站)
# 环境变量:CN_MIRROR=0 跳过加速探测;NO_BUILD=1 不构建、直接用本地镜像
# 用法: ./scripts/deploy.sh up 构建镜像并后台启动(默认命令)
# ./scripts/deploy.sh update 改完代码后重建镜像并替换容器
# ./scripts/deploy.sh restart 重启容器(不换镜像)
# ./scripts/deploy.sh down 停止并删除容器,数据留在 ./data
# ./scripts/deploy.sh logs 跟踪日志(Ctrl+C 退出)
# ./scripts/deploy.sh backup 导出数据库快照(部署到新机器时带走数据)
# ./scripts/deploy.sh status 容器状态 + 健康检查 + 访问地址
# ./scripts/deploy.sh mirror 重新探测可用的 pip 源(基础镜像只认本地已有的,不去试加速站)
# 环境变量:CN_MIRROR=0 跳过加速探测;NO_BUILD=1 不构建、直接用本地镜像;
# AUTO_INSTALL=0 缺 docker / compose 时不尝试自动安装,只打印安装命令
set -euo pipefail
cd "$(dirname "$0")"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT"
CONTAINER=unis-board
AUTO_INSTALL="${AUTO_INSTALL:-1}"
# ---------- 0. 前置检查 ----------
command -v docker >/dev/null 2>&1 || { echo "!! 没有 docker 命令,请先安装 Docker / Docker Desktop" >&2; exit 1; }
docker info >/dev/null 2>&1 || { echo "!! docker 守护进程没起来(Docker Desktop 是否没运行?)" >&2; exit 1; }
log() { printf '%s\n' "$*"; }
warn() { printf '!! %s\n' "$*" >&2; }
run_root() {
if [ "$(id -u)" = "0" ]; then
"$@"
elif command -v sudo >/dev/null 2>&1; then
# 交互式终端允许 sudo 提示密码;非交互时不要卡住等密码
if [ -t 0 ] || sudo -n true 2>/dev/null; then
sudo "$@"
else
return 1
fi
else
return 1
fi
}
# 装 docker:优先系统包管理器,再退回官方安装脚本(仅 Linux;macOS 需 Docker Desktop)
install_docker() {
[ "$AUTO_INSTALL" = "1" ] || return 1
[ "$(uname -s)" = "Linux" ] || return 1
log "==> 未找到 docker,尝试自动安装"
if command -v dnf >/dev/null 2>&1; then
run_root dnf install -y docker docker-compose-plugin 2>/dev/null ||
run_root dnf install -y docker docker-compose 2>/dev/null || true
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y docker docker-compose-plugin 2>/dev/null ||
run_root yum install -y docker docker-compose 2>/dev/null || true
elif command -v apt-get >/dev/null 2>&1; then
run_root apt-get update 2>/dev/null || true
run_root apt-get install -y docker.io docker-compose-plugin 2>/dev/null ||
run_root apt-get install -y docker.io docker-compose 2>/dev/null || true
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache docker docker-cli-compose 2>/dev/null || true
fi
if ! command -v docker >/dev/null 2>&1 && command -v curl >/dev/null 2>&1; then
log "==> 系统包管理器没装上,改用 Docker 官方脚本(get.docker.com)"
curl -fsSL https://get.docker.com | run_root sh || true
fi
command -v docker >/dev/null 2>&1
}
# 守护进程没起来时尝试拉起(Linux systemd / macOS Docker Desktop)
start_docker_daemon() {
if command -v systemctl >/dev/null 2>&1; then
log "==> 尝试启动 docker 服务"
run_root systemctl enable --now docker 2>/dev/null || run_root systemctl start docker 2>/dev/null || true
elif [ "$(uname -s)" = "Darwin" ] && [ -d "/Applications/Docker.app" ]; then
log "==> 尝试启动 Docker Desktop"
open -a Docker >/dev/null 2>&1 || true
fi
local i
for i in $(seq 1 30); do
docker info >/dev/null 2>&1 && return 0
sleep 2
done
return 1
}
# 装 compose 插件(docker compose / 独立 docker-compose 二选一)
install_compose() {
[ "$AUTO_INSTALL" = "1" ] || return 1
[ "$(uname -s)" = "Linux" ] || return 1
log "==> 未找到 docker compose,尝试自动安装"
if command -v dnf >/dev/null 2>&1; then
run_root dnf install -y docker-compose-plugin 2>/dev/null || run_root dnf install -y docker-compose 2>/dev/null || true
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y docker-compose-plugin 2>/dev/null || run_root yum install -y docker-compose 2>/dev/null || true
elif command -v apt-get >/dev/null 2>&1; then
run_root apt-get install -y docker-compose-plugin 2>/dev/null || run_root apt-get install -y docker-compose 2>/dev/null || true
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache docker-cli-compose 2>/dev/null || true
fi
return 0
}
# ---------- 0. 前置检查(缺什么补什么) ----------
if ! command -v docker >/dev/null 2>&1; then
if ! install_docker; then
warn "没有 docker 命令。请先安装 Docker / Docker Desktop:
macOS : 安装 Docker Desktop https://www.docker.com/products/docker-desktop/
Ubuntu/Debian : sudo apt install -y docker.io docker-compose-plugin
RHEL/openEuler : sudo dnf install -y docker docker-compose-plugin
(脚本默认已尝试自动安装;设了 AUTO_INSTALL=0 时可去掉该变量重试)"
exit 1
fi
fi
if ! docker info >/dev/null 2>&1; then
if ! start_docker_daemon; then
warn "docker 守护进程没起来(Docker Desktop 是否没运行?)"
exit 1
fi
fi
if docker compose version >/dev/null 2>&1; then
COMPOSE=(docker compose)
elif command -v docker-compose >/dev/null 2>&1; then
COMPOSE=(docker-compose)
else
echo "!! 没找到 docker compose,也没找到 docker-compose" >&2
exit 1
install_compose
if docker compose version >/dev/null 2>&1; then
COMPOSE=(docker compose)
elif command -v docker-compose >/dev/null 2>&1; then
COMPOSE=(docker-compose)
else
warn "没找到 docker compose,也没找到 docker-compose。请安装 docker-compose-plugin 后重试。"
exit 1
fi
fi
# 对外端口:命令行环境变量 > .env 里的 HOST_PORT > 8770
@ -92,10 +194,10 @@ configure_mirror() {
echo "==> 基础镜像已从当前配置的源拉取:$BASE_IMAGE"
else
echo "!! 本地没有 ${BASE_IMAGE},25 秒内也没拉到;这一步过不去,构建必然失败,先解决基础镜像:" >&2
echo " 1) 本地有别的 python 镜像 → 指定它:BASE_IMAGE=$(docker images --format '{{.Repository}}:{{.Tag}}' | grep -m1 python || echo python:3.12-slim) ./deploy.sh up" >&2
echo " 1) 本地有别的 python 镜像 → 指定它:BASE_IMAGE=$(docker images --format '{{.Repository}}:{{.Tag}}' | grep -m1 python || echo python:3.12-slim) ./scripts/deploy.sh up" >&2
echo " 2) 手工拉一次(守护进程配的 registry-mirrors 在这一步生效):docker pull $tag" >&2
echo " 3) 机器不能上网 → 从别处拷:docker save -o py.tar $tag && scp py.tar 目标机 && docker load -i py.tar" >&2
echo " 4) 已经构建过本项目镜像 → 跳过构建直接起:NO_BUILD=1 ./deploy.sh up" >&2
echo " 4) 已经构建过本项目镜像 → 跳过构建直接起:NO_BUILD=1 ./scripts/deploy.sh up" >&2
return 1
fi
@ -113,7 +215,7 @@ configure_mirror() {
if [ -z "${PIP_INDEX_URL:-}" ]; then
PIP_INDEX_URL="https://pypi.org/simple"
echo "!! 构建容器里访问不到任何国内 pip 源,先用官方源;超时就手工指定:" >&2
echo " PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./deploy.sh up" >&2
echo " PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/deploy.sh up" >&2
fi
fi
@ -135,16 +237,16 @@ build_hint() {
!! 构建失败。国内环境最常见的两个原因:
1) 基础镜像拉不到(failed to resolve source metadata / TLS handshake timeout)
docker images | grep python # 看看本地有哪个可用
BASE_IMAGE=python:3.12-slim ./deploy.sh up # 显式指定本地已有的镜像
BASE_IMAGE=python:3.12-slim ./scripts/deploy.sh up # 显式指定本地已有的镜像
docker pull python:3.12-slim # 或手工拉一次
也可以给 Docker 守护进程配 registry-mirrors(服务器改 /etc/docker/daemon.json,
桌面端 Settings → Docker Engine),保存并重启 Docker 后再 ./deploy.sh up
桌面端 Settings → Docker Engine),保存并重启 Docker 后再 ./scripts/deploy.sh up
2) pip 装依赖超时
PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./deploy.sh up
PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/deploy.sh up
完全不能上网的机器:在能上网的机器上构建后拷镜像过去
docker save -o unis-board.tar unis-board:latest && scp unis-board.tar host:/srv/unis_manager/
ssh host 'docker load -i /srv/unis_manager/unis-board.tar'
然后在目标机 NO_BUILD=1 ./deploy.sh up
然后在目标机 NO_BUILD=1 ./scripts/deploy.sh up
HINT
}
@ -165,12 +267,12 @@ wait_ready() {
state="$(docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$CONTAINER" 2>/dev/null || echo missing)"
case "$state" in
healthy) echo; echo "==> 已就绪:$URL"; return 0 ;;
unhealthy) echo; echo "!! 容器不健康,执行 ./deploy.sh logs 看原因" >&2; return 1 ;;
unhealthy) echo; echo "!! 容器不健康,执行 ./scripts/deploy.sh logs 看原因" >&2; return 1 ;;
esac
echo -n "."
sleep 2
done
echo; echo "!! 等待超时(当前状态:${state}),执行 ./deploy.sh logs 看原因" >&2
echo; echo "!! 等待超时(当前状态:${state}),执行 ./scripts/deploy.sh logs 看原因" >&2
return 1
}
@ -234,7 +336,7 @@ with dst:
src.backup(dst)
print(f"[ok] 已导出 {sys.argv[1]}({os.path.getsize(sys.argv[1]) // 1024} KB)")
PYEOF
echo "==> 部署到新机器:把这个文件放到目标机的 data/board.db,再执行 ./deploy.sh up"
echo "==> 部署到新机器:把这个文件放到目标机的 data/board.db,再执行 ./scripts/deploy.sh up"
;;
mirror)
prepare
@ -246,7 +348,7 @@ PYEOF
status)
"${COMPOSE[@]}" ps
echo -n "==> /health:"
curl -s --max-time 3 "$URL/health" 2>/dev/null || echo " 无响应(容器未启动?./deploy.sh up)"
curl -s --max-time 3 "$URL/health" 2>/dev/null || echo " 无响应(容器未启动?./scripts/deploy.sh up)"
echo
echo "==> 访问地址:$URL"
;;

View File

@ -36,10 +36,13 @@
python scripts/import_custom_ledger.py # 实际写入
python scripts/import_custom_ledger.py --date 2026-09-17 # 指定「更新时间」
python scripts/import_custom_ledger.py --xlsx "D:/定开项目.xlsx"
不传 --xlsx 时依次取:环境变量 CUSTOM_LEDGER_XLSX → data/import/定开项目.xlsx。
"""
from __future__ import annotations
import argparse
import os
import re
import sys
from datetime import date, datetime
@ -53,7 +56,9 @@ from app.constants import normalize_region # noqa: E402
from app.db import SessionLocal # noqa: E402
from app.models import CustomProject # noqa: E402
DEFAULT_XLSX = str(Path.home() / "Desktop" / "定开项目.xlsx")
DEFAULT_XLSX = os.environ.get("CUSTOM_LEDGER_XLSX") or str(
Path(__file__).resolve().parent.parent / "data" / "import" / "定开项目.xlsx"
)
# 表格列名 → 数据库字段
COLMAP = {
@ -184,8 +189,12 @@ def main() -> None:
args = ap.parse_args()
xlsx = Path(args.xlsx)
if not xlsx.exists():
raise SystemExit(f"[x] 找不到文件:{xlsx}")
if not xlsx.is_file():
raise SystemExit(
f"[x] 找不到文件:{xlsx}\n"
" 用法:python scripts/import_custom_ledger.py [--xlsx <file>] [--dry-run]\n"
" 也可以把文件放到 data/import/定开项目.xlsx,或设置环境变量 CUSTOM_LEDGER_XLSX"
)
rows = read_rows(str(xlsx))
print(f"==> 读取 {xlsx}")

View File

@ -3,6 +3,8 @@
用法:
python scripts/import_excel.py [excel路径] [--reset]
不传路径时依次取:环境变量 XLSX → data/import/软件开发部管理工作执行表.xlsx。
解析规则:
- 「周工作情况总结」:时间(周期) → 工作内容(项目) → 内容说明(子任务) → 完成情况(执行记录)
* 三列均为稀疏填充,逐级向下继承(forward fill)
@ -11,6 +13,7 @@
"""
from __future__ import annotations
import os
import re
import sys
from pathlib import Path
@ -34,7 +37,9 @@ from app.models import ( # noqa: E402
Update,
)
DEFAULT_XLSX = "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
DEFAULT_XLSX = os.environ.get("XLSX") or str(
Path(__file__).resolve().parent.parent / "data" / "import" / "软件开发部管理工作执行表.xlsx"
)
# 重点工作流(自动打上重点标记)
KEY_PROJECTS = {"NEX云桌面", "AI Agent", "智飞无人机平台", "定制开发", "云屏"}
@ -61,6 +66,14 @@ def main():
ap.add_argument("--reset", action="store_true", help="清空业务表后重新导入")
args = ap.parse_args()
xlsx = Path(args.xlsx)
if not xlsx.is_file():
raise SystemExit(
f"[x] 找不到 Excel:{xlsx}\n"
" 用法:python scripts/import_excel.py <xlsx> [--reset]\n"
" 也可以把文件放到 data/import/软件开发部管理工作执行表.xlsx,或设置环境变量 XLSX"
)
Base.metadata.create_all(bind=engine)
db = SessionLocal()
@ -72,7 +85,7 @@ def main():
cats = {c.name: c for c in db.query(Category).all()}
wb = openpyxl.load_workbook(args.xlsx, data_only=True, read_only=True)
wb = openpyxl.load_workbook(xlsx, data_only=True, read_only=True)
# ---------------------------------------------------------- 周工作情况总结
ws = wb["周工作情况总结"]

View File

@ -6,12 +6,15 @@
python scripts/import_staff.py --reset # 清空后重新导入
python scripts/import_staff.py --dry-run # 只看解析结果,不落库
不传路径时依次取:环境变量 STAFF_XLSX → data/import/软件开发部人员名单.xlsx。
表头按名称匹配:序号 / 姓名 / 归属小组 / 人员归属 / 说明。
同名人员默认跳过(不动已有记录,避免覆盖页面上的后续编辑)。
"""
from __future__ import annotations
import argparse
import os
import sys
from pathlib import Path
@ -22,7 +25,9 @@ from app.db import Base, engine, SessionLocal # noqa: E402
from app.models import Staff # noqa: E402
from app.schema_patch import ensure_columns # noqa: E402
DEFAULT_XLSX = "/Users/jiliu/WorkSpace/unissense/部门管理/软件开发部人员名单.xlsx"
DEFAULT_XLSX = os.environ.get("STAFF_XLSX") or str(
Path(__file__).resolve().parent.parent / "data" / "import" / "软件开发部人员名单.xlsx"
)
COLUMNS = {"序号": "sort_order", "姓名": "name", "归属小组": "group", "人员归属": "affiliation", "说明": "note"}
@ -76,8 +81,12 @@ def main():
args = ap.parse_args()
path = Path(args.xlsx)
if not path.exists():
raise SystemExit(f"文件不存在:{path}")
if not path.is_file():
raise SystemExit(
f"[x] 文件不存在:{path}\n"
" 用法:python scripts/import_staff.py <xlsx> [--reset] [--dry-run]\n"
" 也可以把文件放到 data/import/软件开发部人员名单.xlsx,或设置环境变量 STAFF_XLSX"
)
Base.metadata.create_all(bind=engine)
ensure_columns(engine, Base.metadata)

View File

@ -0,0 +1,22 @@
# scripts/legacy/ 历史一次性脚本
这些脚本只服务于**过去某次**数据迁移或修复,不参与启动、不被应用调用,也不打进 Docker 镜像。
保留它们是为了历史可追溯、需要时还能复现;日常部署不需要执行。
> 执行前先备份:`cp data/board.db data/board.db.bak-$(date +%Y%m%d_%H%M%S)`
> 大多数脚本支持 `--dry-run`,务必先预演。
| 文件 | 用途 | 用法 |
|---|---|---|
| `migrate_custom.py` | 把旧「定制开发」从通用项目表拆成独立的 `custom_projects` / `custom_updates` | `python scripts/legacy/migrate_custom.py --dry-run` |
| `add_entry_date.py` | 回填定开项目的「入库时间」字段 | `python scripts/legacy/add_entry_date.py --dry-run` |
| `fix_period_split.py` | 修复「8月第4周 / 9月第1周」内容粘连的周期错位 | `python scripts/legacy/fix_period_split.py --dry-run` |
| `merge_project.py` | 把项目 A 的全部数据合并到项目 B 后删除 A | `python scripts/legacy/merge_project.py --from A --to B` |
| `shift_year.py` | 全部周期年份整体平移(默认 +1 年) | `python scripts/legacy/shift_year.py --dry-run` |
## 与当前流程的关系
- 全新库默认**只建空表**,不再自动导入旧 Excel;已有数据请直接带 `data/board.db`。
- 确实要从旧 Excel 全量还原时,顺序是:
`import_excel.py --reset` → `legacy/migrate_custom.py` → `import_staff.py`。
- 迁移到 MySQL 时同样先建表,再按需执行上面的还原链路。

View File

@ -13,18 +13,19 @@
- Excel 里是平移前的年份,这里按 (月, 周) 匹配现有周期并取最早的一年,避免年份口径耦合。
用法:
python scripts/add_entry_date.py --dry-run
python scripts/add_entry_date.py
python scripts/add_entry_date.py --force
python scripts/legacy/add_entry_date.py --dry-run
python scripts/legacy/add_entry_date.py
python scripts/legacy/add_entry_date.py --force
"""
from __future__ import annotations
import argparse
import os
import sys
from collections import defaultdict
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
import openpyxl # noqa: E402
from sqlalchemy import inspect, text # noqa: E402
@ -38,7 +39,9 @@ from app.models import ( # noqa: E402
Period,
)
DEFAULT_XLSX = "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
DEFAULT_XLSX = os.environ.get("XLSX") or str(
Path(__file__).resolve().parents[2] / "data" / "import" / "软件开发部管理工作执行表.xlsx"
)
COLUMN = "entry_date"

View File

@ -18,19 +18,20 @@
用法
----
python scripts/fix_period_split.py --dry-run # 预演
python scripts/fix_period_split.py # 执行
python scripts/legacy/fix_period_split.py --dry-run # 预演
python scripts/legacy/fix_period_split.py # 执行
"""
from __future__ import annotations
import argparse
import os
import shutil
import sys
from datetime import datetime
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
ROOT = Path(__file__).resolve().parents[2]
sys.path.insert(0, str(ROOT))
import openpyxl # noqa: E402
@ -46,7 +47,7 @@ from app.models import ( # noqa: E402
Update,
)
XLSX = "/Users/jiliu/WorkSpace/定开管理/软件开发部管理工作执行表.xlsx"
XLSX = os.environ.get("XLSX") or str(ROOT / "data" / "import" / "软件开发部管理工作执行表.xlsx")
# --------------------------------------------------------------------------- #

View File

@ -13,8 +13,8 @@
- 删除源项目前要 expire_all(),避免 identity map 里的旧关系对象被级联误删。
用法:
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
python scripts/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台" --dry-run
python scripts/legacy/merge_project.py --from "智空无人机平台" --to "智飞无人机平台"
"""
from __future__ import annotations
@ -22,7 +22,7 @@ import argparse
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
from app.db import SessionLocal # noqa: E402
from app.models import Project, Task, Update # noqa: E402

View File

@ -7,14 +7,14 @@
产出:custom_projects + custom_updates 两张独立表;
原 projects / tasks / updates 中的「定制开发」整体移除,常规看板只留平台产品类项目。
用法:python scripts/migrate_custom.py [--dry-run]
用法:python scripts/legacy/migrate_custom.py [--dry-run]
"""
from __future__ import annotations
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
import argparse # noqa: E402

View File

@ -10,9 +10,9 @@
- 执行前会校验 sort_key 是否出现重复,有重复则整体回滚。
用法:
python scripts/shift_year.py --dry-run # 预演
python scripts/shift_year.py # 全部 +1 年
python scripts/shift_year.py --years -1 # 反向:全部 -1 年
python scripts/legacy/shift_year.py --dry-run # 预演
python scripts/legacy/shift_year.py # 全部 +1 年
python scripts/legacy/shift_year.py --years -1 # 反向:全部 -1 年
"""
from __future__ import annotations
@ -21,7 +21,7 @@ import re
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
from app.db import SessionLocal # noqa: E402
from app.models import CustomProject, Period # noqa: E402
@ -101,7 +101,7 @@ def main():
print(f"[ok] 已平移 {changed} 个周期({args.years:+d} 年),日期字段 {date_changed} 个")
latest = db.query(Period).order_by(Period.sort_key.desc()).first()
print(f"[ok] 当前最新周期:{latest.year}年{latest.month}月第{latest.week}周")
print(" 提示:如需回滚,执行 python scripts/shift_year.py --years " + f"{-args.years}")
print(" 提示:如需回滚,执行 python scripts/legacy/shift_year.py --years " + f"{-args.years}")
finally:
db.close()

305
scripts/run.sh 100755
View File

@ -0,0 +1,305 @@
#!/usr/bin/env bash
# DMS管理平台 · 本地启动脚本(macOS / Linux / Windows Git Bash 均可)
#
# 用法:
# ./scripts/run.sh 正常启动(默认开热更新)
# PORT=8771 ./scripts/run.sh 换端口
# DEV=0 ./scripts/run.sh 关闭热更新
# NO_OPEN=1 ./scripts/run.sh 启动后不打开浏览器
# AUTO_INSTALL=0 ./scripts/run.sh 缺环境时不尝试自动安装,只打印安装命令
#
# 环境要求由脚本自动兜底:
# 1. 找 Python 3.10+(找不到时按 AUTO_INSTALL=1 尝试用系统包管理器安装)
# 2. 建项目内 .venv,缺依赖时自动 pip install -r requirements.txt(多源重试)
# 3. 缺 .env 时从 .env.example 生成,建好 data/ 目录,首次运行自动建库
# 4. 端口已被占用时直接提示访问地址,不重复起进程
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT"
log() { printf '%s\n' "$*"; }
warn() { printf '!! %s\n' "$*" >&2; }
die() { printf '!! %s\n' "$*" >&2; exit 1; }
# 读取 .env 里的单值配置(不 source,避免特殊字符被执行)
env_get() {
[ -f .env ] || return 0
sed -n "s/^[[:space:]]*$1[[:space:]]*=//p" .env | tail -1 | sed 's/[[:space:]]*$//'
}
is_windows() {
case "$(uname -s)" in
MINGW*|MSYS*|CYGWIN*) return 0 ;;
*) return 1 ;;
esac
}
run_root() {
if [ "$(id -u)" = "0" ]; then
"$@"
elif command -v sudo >/dev/null 2>&1; then
# 交互式终端允许 sudo 提示密码;非交互(systemd / CI)时不要卡住等密码
if [ -t 0 ] || sudo -n true 2>/dev/null; then
sudo "$@"
else
return 1
fi
else
return 1
fi
}
# ---------- 配置 ----------
PORT="${PORT:-$(env_get PORT)}"
PORT="${PORT:-8770}"
DEV="${DEV:-$(env_get DEV)}"
DEV="${DEV:-1}"
export DEV
NO_OPEN="${NO_OPEN:-0}"
AUTO_INSTALL="${AUTO_INSTALL:-1}"
PIP_INDEX_URL="${PIP_INDEX_URL:-$(env_get PIP_INDEX_URL)}"
echo "==> DMS管理平台"
# ---------- 1. 找一个可用的 Python 3.10+ ----------
PY_SYS=""
find_python() {
local c
for c in "${PYTHON:-}" python3 python; do
[ -n "$c" ] || continue
command -v "$c" >/dev/null 2>&1 || continue
if "$c" -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)' >/dev/null 2>&1; then
PY_SYS="$(command -v "$c")"
return 0
fi
done
return 1
}
# 自动装 Python:只在明确缺解释器时触发,且需要包管理器 / 管理员权限
install_python() {
[ "$AUTO_INSTALL" = "1" ] || return 1
log "==> 未找到 Python 3.10+,尝试自动安装"
case "$(uname -s)" in
Darwin)
if command -v brew >/dev/null 2>&1; then
brew install python@3.12 && return 0
fi
warn "macOS 需要先装 Homebrew(https://brew.sh)或从 python.org 安装 Python 3.10+"
;;
Linux)
if command -v dnf >/dev/null 2>&1; then
run_root dnf install -y python3 python3-pip && return 0
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y python3 python3-pip && return 0
elif command -v apt-get >/dev/null 2>&1; then
run_root apt-get update && run_root apt-get install -y python3 python3-venv python3-pip && return 0
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache python3 py3-pip && return 0
fi
;;
*)
;;
esac
return 1
}
if ! find_python; then
if install_python; then
find_python || die "Python 安装后仍不可用,请手动安装 Python 3.10+ 后重试"
else
die "没有找到 Python 3.10+。请先安装:
macOS : brew install python@3.12 或 https://www.python.org/downloads/
Ubuntu/Debian : sudo apt install -y python3 python3-venv python3-pip
RHEL/openEuler : sudo dnf install -y python3 python3-pip
然后重新执行:./scripts/run.sh"
fi
fi
log " 系统 Python:$PY_SYS ($("$PY_SYS" -V 2>&1))"
# ---------- 2. 端口占用检查(已在运行就直接给地址,省得重复启动) ----------
port_busy() {
"$PY_SYS" - "$PORT" <<'PY' >/dev/null 2>&1
import socket, sys
s = socket.socket()
s.settimeout(1.5)
sys.exit(0 if s.connect_ex(("127.0.0.1", int(sys.argv[1]))) == 0 else 1)
PY
}
health_url="http://127.0.0.1:${PORT}/health"
if port_busy; then
if command -v curl >/dev/null 2>&1 && curl -fsS --max-time 2 "$health_url" >/dev/null 2>&1; then
echo "==> 端口 ${PORT} 上已有 DMS 服务在运行"
echo " 看板地址: http://127.0.0.1:${PORT}"
echo " (要重启请先在原窗口按 Ctrl+C,或执行:lsof -ti:${PORT} | xargs kill)"
exit 0
fi
die "端口 ${PORT} 已被其他程序占用。换一个端口:PORT=8771 ./scripts/run.sh
或找出占用进程:lsof -ti:${PORT} | xargs kill"
fi
# ---------- 3. .env 与数据目录 ----------
if [ ! -f .env ]; then
cp .env.example .env
log "==> 已从 .env.example 生成 .env(AI Key、管理员密码按需修改)"
fi
mkdir -p data/uploads data/exports data/import
# ---------- 4. 项目内虚拟环境(缺依赖自动安装) ----------
VENV_DIR="$ROOT/.venv"
if is_windows; then
VENV_PY="$VENV_DIR/Scripts/python.exe"
else
VENV_PY="$VENV_DIR/bin/python"
fi
# 兼容在另一种 shell 下建好的 .venv
if [ ! -x "$VENV_PY" ]; then
for cand in "$VENV_DIR/bin/python" "$VENV_DIR/Scripts/python.exe"; do
if [ -x "$cand" ]; then VENV_PY="$cand"; break; fi
done
fi
install_venv_support() {
[ "$AUTO_INSTALL" = "1" ] || return 1
case "$(uname -s)" in
Linux)
if command -v apt-get >/dev/null 2>&1; then
run_root apt-get update && run_root apt-get install -y python3-venv
elif command -v dnf >/dev/null 2>&1; then
run_root dnf install -y python3-pip
elif command -v yum >/dev/null 2>&1; then
run_root yum install -y python3-pip
elif command -v apk >/dev/null 2>&1; then
run_root apk add --no-cache python3 py3-pip
else
return 1
fi
;;
*) return 1 ;;
esac
}
if [ ! -x "$VENV_PY" ]; then
log "==> 创建虚拟环境:.venv"
if ! "$PY_SYS" -m venv "$VENV_DIR" >/tmp/dms_venv.log 2>&1; then
warn "创建虚拟环境失败,尝试补齐 python3-venv ..."
install_venv_support || true
# 删掉半成品再重试,否则 venv 会认为目录已存在但不可用
case "$VENV_DIR" in
*/.venv)
if [ -d "$VENV_DIR" ]; then rm -rf "$VENV_DIR"; fi
;;
esac
if ! "$PY_SYS" -m venv "$VENV_DIR"; then
warn "虚拟环境创建失败,日志见 /tmp/dms_venv.log"
die "请手动安装 venv 支持后重试:
Ubuntu/Debian : sudo apt install -y python3-venv
RHEL/openEuler : sudo dnf install -y python3-pip
或者删掉 .venv 后重跑 ./scripts/run.sh"
fi
fi
if is_windows; then VENV_PY="$VENV_DIR/Scripts/python.exe"; else VENV_PY="$VENV_DIR/bin/python"; fi
fi
log " 虚拟环境:$VENV_PY"
DEPS_CHECK='import fastapi, uvicorn, sqlalchemy, pydantic, httpx, openpyxl, multipart'
deps_ok() { "$VENV_PY" -c "$DEPS_CHECK" >/dev/null 2>&1; }
install_deps() {
local indexes=() idx args
if ! "$VENV_PY" -m pip --version >/dev/null 2>&1; then
log "==> 虚拟环境里没有 pip,尝试 ensurepip 补齐"
"$VENV_PY" -m ensurepip --upgrade >/dev/null 2>&1 ||
die "虚拟环境缺少 pip,请删掉 .venv 后重跑 ./scripts/run.sh"
fi
if [ -n "$PIP_INDEX_URL" ]; then
indexes=("$PIP_INDEX_URL")
else
# 先尊重本机 pip 配置,失败再换国内镜像
indexes=("" "https://pypi.tuna.tsinghua.edu.cn/simple" "https://mirrors.aliyun.com/pypi/simple")
fi
for idx in "${indexes[@]}"; do
args=(install --disable-pip-version-check --timeout 20 --retries 2 -r requirements.txt)
if [ -n "$idx" ]; then
args+=(-i "$idx")
log "==> 安装依赖:$idx"
else
log "==> 安装依赖(pip 默认源)"
fi
if "$VENV_PY" -m pip "${args[@]}"; then
return 0
fi
warn "该源安装失败,换下一个源重试"
done
return 1
}
REQ_HASH="$(cksum requirements.txt 2>/dev/null | awk '{print $1 "-" $2}')"
DEPS_STAMP="$VENV_DIR/.requirements.cksum"
NEED_INSTALL=0
if ! deps_ok; then
NEED_INSTALL=1
elif [ ! -f "$DEPS_STAMP" ] || [ "$(cat "$DEPS_STAMP" 2>/dev/null)" != "$REQ_HASH" ]; then
# requirements.txt 变过(新增/升级依赖)时重装一次;pip 本身是幂等的
NEED_INSTALL=1
fi
if [ "$NEED_INSTALL" = "1" ]; then
log "==> 安装/更新运行依赖(首次约 1~2 分钟)"
if ! install_deps; then
die "依赖安装失败。可以手动执行:
$VENV_PY -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
或指定镜像:PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple ./scripts/run.sh"
fi
deps_ok || die "依赖装完仍无法 import,请检查 requirements.txt 与 Python 版本"
printf '%s\n' "$REQ_HASH" > "$DEPS_STAMP"
fi
log " 依赖检查:OK"
# ---------- 5. 首次运行:建表 + 预置分类 ----------
if [ ! -f data/board.db ]; then
log "==> 首次运行,初始化数据库"
"$VENV_PY" scripts/init_db.py
fi
# ---------- 6. 启动 ----------
RELOAD_ARGS=()
if [ "$DEV" = "1" ]; then
RELOAD_ARGS=(--reload
--reload-include "*.js" --reload-include "*.css" --reload-include "*.html"
--reload-include ".env")
fi
open_url() {
local url="$1"
[ "$NO_OPEN" = "1" ] && return 0
case "$(uname -s)" in
Darwin)
open "$url" >/dev/null 2>&1 || true
;;
Linux)
if [ -n "${DISPLAY:-}${WAYLAND_DISPLAY:-}" ] && command -v xdg-open >/dev/null 2>&1; then
xdg-open "$url" >/dev/null 2>&1 || true
fi
;;
MINGW*|MSYS*|CYGWIN*)
cmd.exe /c start "" "$url" >/dev/null 2>&1 || true
;;
esac
}
URL="http://127.0.0.1:${PORT}"
echo "==> 启动服务: $URL"
echo " API 文档: $URL/api/docs"
echo " 热更新: $([ "$DEV" = "1" ] && echo 开启 || echo 关闭)"
echo " 停止服务: Ctrl+C"
echo
if [ "$NO_OPEN" != "1" ]; then
( sleep 3; open_url "$URL" ) &
fi
exec "$VENV_PY" -m uvicorn app.main:app --host 127.0.0.1 --port "$PORT" \
${RELOAD_ARGS[@]+"${RELOAD_ARGS[@]}"}