feat: 移除运行时代码中的数据库初始化与分区维护逻辑
- 新增备份 SQL 脚本 `01_init_schema.sql` 和 `02_create_partitions.sql`,用于数据库结构初始化和分区预创建。 - 新增 Node.js 脚本 `run_init.js` 和 `run_ensure_partitions.js`,支持通过外部程序调用进行数据库初始化和分区维护。 - 确保数据库初始化脚本支持幂等重复执行。 - 更新文档,说明新的执行顺序和使用方法。 - 移除运行时相关的数据库初始化和分区维护配置,简化服务职责。 - 保留写入失败时的缺分区兜底逻辑,确保服务稳定性。
This commit is contained in:
28
openspec/changes/remove-runtime-db-bootstrap/proposal.md
Normal file
28
openspec/changes/remove-runtime-db-bootstrap/proposal.md
Normal file
@@ -0,0 +1,28 @@
|
||||
# Change: Remove runtime DB bootstrap from service
|
||||
|
||||
## Why
|
||||
当前服务进程同时承担了“业务消费写入”和“数据库建库/分区维护”两类职责,导致部署耦合、运维边界不清晰,且难以被其他程序复用。
|
||||
|
||||
本次变更将建库与分区维护彻底外部化,服务进程只保留 Kafka → 处理 → 写库主链路。
|
||||
|
||||
## What Changes
|
||||
- 从运行时代码中移除启动建表、建函数、建索引、定时分区维护逻辑。
|
||||
- 移除运行时相关开关配置(`DB_INIT_AND_PARTITION_ENABLED`、`DB_PARTITION_*`)。
|
||||
- 在仓库根目录新增 `SQL_Script/`,提供可由外部程序调用的 SQL/JS 脚本:
|
||||
- `01_init_schema.sql`
|
||||
- `02_create_partitions.sql`
|
||||
- `run_init.js`
|
||||
- `run_ensure_partitions.js`
|
||||
- 保留写入失败时“缺分区”兜底:按批次时间范围调用 `heartbeat.ensure_partitions` 后重试(前提是外部初始化已部署函数)。
|
||||
|
||||
## Impact
|
||||
- Affected specs: `db`
|
||||
- Affected code:
|
||||
- `src/db/databaseManager.js`
|
||||
- `src/config/config.js`
|
||||
- `src/config/config.example.js`
|
||||
- `.env`
|
||||
- `.env.example`
|
||||
- `SQL_Script/*`
|
||||
- Operational impact:
|
||||
- **BREAKING (运维流程层面)**:首次部署或升级后,需先执行 `SQL_Script` 初始化脚本,再启动服务。
|
||||
@@ -0,0 +1,29 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 服务运行时不得承担建库与定时分区维护
|
||||
系统 MUST 仅负责数据库连接与业务写入,不在服务启动时执行数据库结构初始化,也不在进程内执行定时分区维护。
|
||||
|
||||
#### Scenario: 服务启动仅建立连接
|
||||
- **WHEN** 服务进程启动并连接 PostgreSQL
|
||||
- **THEN** 系统应只创建连接池并完成连通性检测
|
||||
- **AND** 不应在运行时执行表/索引/函数等 DDL 初始化
|
||||
- **AND** 不应在进程内启动分区维护定时任务
|
||||
|
||||
#### Scenario: 写入遇到缺分区时的运行时兜底
|
||||
- **WHEN** 批量写入 `heartbeat.heartbeat_events` 遇到缺分区错误
|
||||
- **THEN** 系统应基于该批次的时间范围调用 `heartbeat.ensure_partitions`
|
||||
- **AND** 调用后应重试当前批次写入
|
||||
- **AND** 系统不应在运行时创建或替换数据库 schema 对象
|
||||
|
||||
### Requirement: 建库与分区维护能力必须以外部脚本提供
|
||||
系统 MUST 在仓库根目录 `SQL_Script/` 提供可被外部程序调用的建库/分区维护脚本。
|
||||
|
||||
#### Scenario: 提供初始化脚本
|
||||
- **WHEN** 运维或其他程序需要初始化数据库结构
|
||||
- **THEN** 应可使用 `SQL_Script/01_init_schema.sql` 或 `SQL_Script/run_init.js`
|
||||
- **AND** 脚本应支持幂等重复执行
|
||||
|
||||
#### Scenario: 提供分区预创建脚本
|
||||
- **WHEN** 运维或外部调度需要预创建分区
|
||||
- **THEN** 应可使用 `SQL_Script/02_create_partitions.sql` 或 `SQL_Script/run_ensure_partitions.js`
|
||||
- **AND** 无需启动主服务进程即可执行分区维护
|
||||
6
openspec/changes/remove-runtime-db-bootstrap/tasks.md
Normal file
6
openspec/changes/remove-runtime-db-bootstrap/tasks.md
Normal file
@@ -0,0 +1,6 @@
|
||||
## 1. Implementation
|
||||
- [x] 1.1 新增根目录 `SQL_Script/`,提供建库与分区预创建 SQL/JS 脚本。
|
||||
- [x] 1.2 删除运行时服务中的建表、建函数、建索引与定时分区维护逻辑。
|
||||
- [x] 1.3 删除运行时配置中的初始化/分区维护开关字段。
|
||||
- [x] 1.4 保留缺分区写入兜底:基于批次时间范围调用 `heartbeat.ensure_partitions` 后重试。
|
||||
- [x] 1.5 执行构建验证,确保主服务可正常打包。
|
||||
Reference in New Issue
Block a user