排口溯源系统 API（Solon）

完整运行与部署说明见：docs/运行部署手册.md

快速启动（本地）

# 需 JDK 8+，并配置 app.yml 中的 MySQL
mvn clean package -DskipTests
java -jar target/paikou-api.jar

• 端口：8080
• API 前缀：/api/v1

启动时数据库行为

DbInitializer 在应用加载完成后仅执行：

1. db/schema.sql — 建表（IF NOT EXISTS）
2. 增量 ALTER TABLE — 兼容老库的字段迁移（如 work_order 验收字段、region.town_street/lng/lat、region.parent_watershed）
3. outlet_gridder 表 — 含于 schema.sql；启动时 V23MigrationRunner 将历史 gridder_user_id 回填至关联表

不再自动写入 Demo 用户/组织/排口/工单，不再自动导入 geo/*.json 村庄边界与支流。空库部署后请自行创建管理员并维护业务数据；空间图层可调用：

• POST /api/v1/region/import-geo
• POST /api/v1/region/import-tributary-geo

近期 API 变更（V2.2）

接口	说明
GET /user/page	用户分页列表
POST /region/merge-tributary	支流合并（数据维护）
region 台账	支流新增 上级流域（parent_watershed）字段；Excel 导入导出含该列
GET /water-quality/period-compare	同排口 2～5 时段对比
PUT /work-order/{id}/accept	双方验收（发起人 + 领取人）；verify 已废弃
工单创建	title 必填，最长 20 字

近期 API 变更（V2.3）

接口	说明
outlet_gridder	排口-网格员多对多；启动自动迁移历史 gridder_user_id
POST/PUT /outlet	gridderUserIds；汇水区选填；编号可改
GET /outlet/page	gridderUserId 筛选；响应含 gridderNames
GET /outlet/list-for-bind	绑定排口列表
GET/PUT /user/{id}/outlet-ids	网格员关联排口

详见 docs/PRD-V2.3-需求对比与实现方案.md。