- 前端栈换成 React 19 + TS + Vite + AntD 6 + Tailwind v4 + Zustand + React Router 7 + Axios,八个视图全部迁完;旧版留在 web/legacy/ - 新增 / 修改表单统一右侧侧滑(components/FormDrawer.tsx,12 处);删除等破坏性确认仍保持弹窗 - 录入字段与「更新录入」口径对齐;长文本录入位统一富文本编辑器(内核 Tiptap 3,颜色存语义名 data-c 而非 hex,跟着主题 token 走) - 展示端用 RichText 渲染 + 两行 clamp;app/export.py 的 plain() 在出表时统一降级成纯文本,三端换行口径一致(一个块级 = 一个换行) - tests: 富文本存储契约与出表断言入契约测试;pytest 104 passed |
||
|---|---|---|
| .. | ||
| README.md | ||
| add_entry_date.py | ||
| fix_period_split.py | ||
| merge_project.py | ||
| migrate_custom.py | ||
| shift_year.py | ||
README.md
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 时同样先建表,再按需执行上面的还原链路。