unis_manager/scripts
mula.liu 01a9521bc7 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
2026-10-29 14:18:54 +08:00
..
legacy chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
README.md chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
deploy.sh chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
import_custom_ledger.py chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
import_excel.py chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
import_staff.py chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00
init_db.py 第一个发布版 2026-09-24 16:17:01 +08:00
run.sh chore(scripts): 启动/部署脚本统一迁入 scripts/,历史修数脚本归档 legacy/ 2026-10-29 14:18:54 +08:00

README.md

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 尝试安装并拉起守护进程
./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。