Docker 与 SQLite 持久化实现计划

面向 AI 代理的工作者： 必需子技能：使用 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（- [ ]）语法来跟踪进度。

目标： 构建可升级的 Docker 服务，并保证 SQLite 始终由宿主机 ./data 持久保存。

架构： 多阶段 Dockerfile 生成包含前端静态资源的 Spring Boot JAR；Compose 通过 bind mount 将 ./data 映射到 /app/data。启动脚本只准备目录，由应用现有初始化器区分首次建库和增量升级。

技术栈： Docker、Docker Compose、Node 20、Maven 3.9、Eclipse Temurin 17、Spring Boot、SQLite。

镜像名称： emoon-okr。

任务 1：建立 Docker 配置契约

文件：

创建：scripts/test-docker-config.sh
[ ] 编写断言：Dockerfile 多阶段构建、Compose 使用 ./data:/app/data、数据源及备份目录指向 /app/data、.dockerignore 排除运行数据。
[ ] 运行 bash scripts/test-docker-config.sh，确认因文件缺失而失败。
[ ] 保留该脚本作为后续 Docker 配置回归测试。

任务 2：实现镜像与启动边界

文件：

创建：Dockerfile
创建：docker/entrypoint.sh
创建：.dockerignore
[ ] 使用 Node 阶段执行 npm ci && npm run build。
[ ] 使用 Maven 阶段复制前端产物并执行 mvn package -DskipTests。
[ ] 使用 JRE 阶段安装 gosu，启动时创建并检查 /app/data，再以非 root 用户运行 JAR。
[ ] 运行配置契约测试，确认通过。

任务 3：提供 Compose 部署配置

文件：

创建：compose.yaml
创建：.env.example
创建：docs/docker-deployment.md
[ ] 将宿主机 ./data 绑定到 /app/data，显式配置 SQLite URL 和备份目录。
[ ] 提供 JWT、管理员密码和 CORS 必填环境变量示例。
[ ] 记录首次部署、升级、备份和恢复命令，明确禁止删除 ./data。
[ ] 运行 docker compose config 验证配置可解析。

任务 4：真实验证初始化和升级持久性

文件：

创建：scripts/test-docker-persistence.sh
[ ] 在临时宿主机目录启动容器，确认自动生成 SQLite 文件。
[ ] 向数据库写入哨兵数据，重建同一镜像的容器。
[ ] 确认数据库文件和哨兵数据仍存在，随后清理测试容器和临时目录。
[ ] 运行前后端全量测试与 git diff --check。