feat(dev): scripts/dev_up.sh 一键启动本地后端与页面测试

- 迁移 → 管理员初始化 → 前端构建 → API+worker 后台启动 → 健康检查 → 自动打开页面 - 支持 --stop 停止、--no-open 跳过打开浏览器；端口已在服务时直接复用 - 未设 DATABASE_URL 时使用 SQLite 轻量库并给出验收提示 - 修复 bash 3.2（macOS 自带）将紧贴 $VAR 的多字节字符并入变量名的问题：全角括号内的变量一律用 ${VAR} 显式界定 - README 本地运行章节补充快速启动说明
2026-09-26 07:32:27 +08:00
parent 0ac0c4eb56
commit 0739bcc4fb
2 changed files with 132 additions and 0 deletions
@@ -33,6 +33,14 @@

 需要 Node.js 22、uv、Python 3.12、PostgreSQL 17。所有示例从仓库根目录执行。

+快速启动本地页面（迁移、管理员初始化、前端构建、API 与导入 worker 一条命令完成，健康检查通过后自动打开 `http://127.0.0.1:8000`；`Ctrl-C` 或 `scripts/dev_up.sh --stop` 停止，`--no-open` 跳过自动打开浏览器）：
+
+```bash
+scripts/dev_up.sh
+```
+
+未设置 `DATABASE_URL` 时该脚本使用 SQLite 轻量开发库 `var/db.sqlite3`，仅限页面测试与开发回归；金额聚合与财务验收需按下方配置 PostgreSQL。手动分步流程如下：
+
 ```bash
 uv sync --frozen --python 3.12
 npm ci --registry=https://registry.npmjs.org