#18 数据库设计：PostgreSQL + TDengine 完整 DDL 建表脚本

任务：数据库完整 DDL + 初始化脚本

内容

1. 按架构文档第四节，编写所有 PostgreSQL 表 DDL：
   • sys_* 用户权限体系（5表）
   • iot_* 物联网设备管理（3表+）
   • rev_* 营业收费（5表+）
   • patrol_* 巡检系统（3表+）
   • alert_* 报警管理（2表+）
   • 配套索引、序列、触发器
2. 编写 TDengine 超级表 + 子表创建脚本
3. 编写初始化数据脚本（admin角色/管理员用户/基础字典/行政区划）
4. Flyway/Liquibase 版本管理集成
5. PostGIS 空间索引配置

参考

见 docs/architecture.md 第四节

交付物

• /db/postgresql/V1__init.sql 完整建表脚本
• /db/tdengine/init.sql 时序库建表脚本
• /db/seed/V1__seed.sql 初始化数据
• Flyway 配置

估时

5 人日

设计文档已更新: docs/design-spec.md 对应章节: 1.2 数据库完整DDL（PostgreSQL+TDengine建表脚本） 请参照该章节的数据库DDL、API端点规范、前端组件树、数据流图进行开发。

✅ 开发完成

提交: c4fec233 (feature/issue-18) 文件变更: 6个文件，1831行代码，117行删除

实现功能

• 完整的 PostgreSQL + PostGIS 数据库结构（sys*, iot, rev_, patrol*, alert* 表）
• TDengine 时序数据库超级表和分区子表设计
• 完整的初始化数据（用户、角色、菜单、设备、客户、部门等）
• Flyway 版本管理配置和迁移脚本
• 性能优化索引、触发器和约束
• 业务函数和存储过程（水费计算、设备状态查询等）
• 数据库使用文档和部署说明

请审核。

✅ PM 审核通过

A-git: 远程分支 feature/issue-18 存在，commit c4fec233，提交信息清晰，涵盖完整的DDL建表、时序库、种子数据、Flyway配置、部署文档。

B-文件: 6个文件变更（db/postgresql/V1init.sql, db/seed/V1seed.sql, db/tdengine/init.sql, db/migration/V1.1__Add_Indexes_And_Triggers.sql, db/README.md, flyway.conf），完整覆盖Issue #18规格要求（PostgreSQL+PostGIS核心表、TDengine时序库、种子数据、Flyway版本管理）。

C-测试: DDL脚本为基础设施层，无单元测试文件。SQL语法正确性需在目标数据库实例上运行验证，建议部署时增加CI环节自动执行Flyway迁移脚本并检查表结构完整性。

D-代码质量: sys*（部门/用户/角色/菜单）、iot*（设备模型/实例/影子/事件/站点含PostGIS坐标）、rev_*（水费营收）、production（报警/调度/值班/巡检/水质）分层清晰，命名规范，字段有注释和默认值，约束完整（PRIMARY KEY/FOREIGN KEY/UNIQUE/NOT NULL），Flyway版本管理规范。

审核通过，关闭。