feat(wm-patrol): #87 巡查设置（区域/路线/表单/模版）

- PatrolAreaService: 区域CRUD/树形列表/详情统计(PAT-16)
- PatrolRouteSetupService: 路线CRUD/巡检点管理/复制路线(PAT-17)
- PatrolFormService: 自定义表单CRUD/表单挂接绑定(PAT-18+PAT-19)
- PatrolTemplateService: 模板CRUD/应用模板生成巡检计划(PAT-20)
- PatrolSetupController: 统一控制器25个端点(/patrol/setup)
- V87__patrol_setup.sql: patrol_area/checkpoint/form/binding/template建表
- JdbcTemplate风格, 返回Map, R<T>统一响应

sql/V86__patrol_core.sql

@@ -0,0 +1,68 @@
+-- Issue #86: 巡检管理核心（总览/轨迹/台账/设备/工单）
+
+-- 1. 巡检设备台账
+CREATE TABLE IF NOT EXISTS patrol_device (
+    id              BIGSERIAL PRIMARY KEY,
+    device_no       VARCHAR(50) UNIQUE,
+    device_name     VARCHAR(100) NOT NULL,
+    device_type     VARCHAR(30) NOT NULL,        -- valve/meter/hydrant/pump/sensor
+    location        VARCHAR(300),
+    lng             DOUBLE PRECISION,
+    lat             DOUBLE PRECISION,
+    status          VARCHAR(20) DEFAULT 'normal', -- normal/abnormal/offline/maintenance
+    area            VARCHAR(50),
+    point_seq       INT DEFAULT 0,
+    remark          TEXT,
+    last_maintenance_date TIMESTAMPTZ,
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_patrol_device_area ON patrol_device(area);
+CREATE INDEX IF NOT EXISTS idx_patrol_device_type ON patrol_device(device_type);
+CREATE INDEX IF NOT EXISTS idx_patrol_device_status ON patrol_device(status);
+
+-- 2. GPS轨迹点
+CREATE TABLE IF NOT EXISTS patrol_track_point (
+    id              BIGSERIAL PRIMARY KEY,
+    task_id         BIGINT NOT NULL REFERENCES patrol_task(id),
+    worker_id       BIGINT,
+    lng             DOUBLE PRECISION NOT NULL,
+    lat             DOUBLE PRECISION NOT NULL,
+    speed           DOUBLE PRECISION DEFAULT 0,
+    accuracy        DOUBLE PRECISION DEFAULT 0,
+    recorded_at     TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_track_task ON patrol_track_point(task_id, recorded_at);
+
+-- 3. 巡检工单增强（如果 patrol_work_order 已存在则 ALTER，否则 CREATE）
+-- 先检查 patrol_work_order 是否存在
+DO $$
+BEGIN
+    IF NOT EXISTS (SELECT FROM pg_tables WHERE tablename = 'patrol_work_order') THEN
+        CREATE TABLE patrol_work_order (
+            id              BIGSERIAL PRIMARY KEY,
+            order_no        VARCHAR(50) UNIQUE NOT NULL,
+            task_id         BIGINT REFERENCES patrol_task(id),
+            issue_type      VARCHAR(30) NOT NULL,     -- leak/damage/abnormal/pollution/other
+            description     TEXT,
+            photos          TEXT,                      -- JSON array
+            severity        VARCHAR(10) DEFAULT 'medium', -- low/medium/high/critical
+            assignee_id     BIGINT,
+            assignee_name   VARCHAR(50),
+            status          VARCHAR(20) DEFAULT 'pending', -- pending/assigned/processing/resolved/closed
+            location        VARCHAR(300),
+            lng             DOUBLE PRECISION,
+            lat             DOUBLE PRECISION,
+            resolution      TEXT,
+            created_at      TIMESTAMPTZ DEFAULT NOW(),
+            resolved_at     TIMESTAMPTZ,
+            closed_at       TIMESTAMPTZ
+        );
+        CREATE INDEX IF NOT EXISTS idx_pwo_status ON patrol_work_order(status);
+        CREATE INDEX IF NOT EXISTS idx_pwo_assignee ON patrol_work_order(assignee_id);
+    END IF;
+END $$;
+
+-- 4. 设备巡检点检记录扩展（给 patrol_record 加 device_status 字段）
+ALTER TABLE patrol_record ADD COLUMN IF NOT EXISTS device_status VARCHAR(20) DEFAULT 'normal';
+ALTER TABLE patrol_record ADD COLUMN IF NOT EXISTS remark TEXT;

sql/V87__patrol_setup.sql

@@ -0,0 +1,70 @@
+-- Issue #87: 巡查设置（区域/路线/表单/模版）
+
+-- PAT-16: 巡检区域
+CREATE TABLE IF NOT EXISTS patrol_area (
+    id              BIGSERIAL PRIMARY KEY,
+    name            VARCHAR(100) NOT NULL,
+    code            VARCHAR(50) UNIQUE,
+    parent_id       BIGINT DEFAULT 0,
+    description     TEXT,
+    lng             DOUBLE PRECISION,
+    lat             DOUBLE PRECISION,
+    radius          DOUBLE PRECISION DEFAULT 0,
+    status          VARCHAR(20) DEFAULT 'active',
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_patrol_area_parent ON patrol_area(parent_id);
+
+-- PAT-17: 巡检路线扩展
+-- patrol_route 已在 V1__production.sql 创建，此处补充缺失字段
+ALTER TABLE patrol_route ADD COLUMN IF NOT EXISTS area_id BIGINT;
+ALTER TABLE patrol_route ADD COLUMN IF NOT EXISTS description TEXT;
+ALTER TABLE patrol_route ADD COLUMN IF NOT EXISTS updated_at TIMESTAMPTZ DEFAULT NOW();
+
+-- 巡检路线巡检点
+CREATE TABLE IF NOT EXISTS patrol_route_checkpoint (
+    id              BIGSERIAL PRIMARY KEY,
+    route_id        BIGINT NOT NULL,
+    checkpoint_seq  INT NOT NULL,
+    device_id       BIGINT,
+    device_name     VARCHAR(100),
+    lng             DOUBLE PRECISION,
+    lat             DOUBLE PRECISION,
+    check_items     TEXT,  -- JSON array
+    created_at      TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_route_checkpoint ON patrol_route_checkpoint(route_id);
+
+-- PAT-18: 自定义巡检表单
+CREATE TABLE IF NOT EXISTS patrol_form (
+    id              BIGSERIAL PRIMARY KEY,
+    name            VARCHAR(100) NOT NULL,
+    type            VARCHAR(30) NOT NULL,  -- daily/special/safety/quality
+    fields          TEXT NOT NULL,          -- JSON array of field definitions
+    status          VARCHAR(20) DEFAULT 'active',
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- PAT-19: 表单绑定关系
+CREATE TABLE IF NOT EXISTS patrol_form_binding (
+    id              BIGSERIAL PRIMARY KEY,
+    form_id         BIGINT NOT NULL,
+    target_type     VARCHAR(20) NOT NULL,  -- route/device/area
+    target_id       BIGINT NOT NULL,
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(form_id, target_type, target_id)
+);
+CREATE INDEX IF NOT EXISTS idx_form_binding_target ON patrol_form_binding(target_type, target_id);
+
+-- PAT-20: 巡检模板
+CREATE TABLE IF NOT EXISTS patrol_template (
+    id              BIGSERIAL PRIMARY KEY,
+    name            VARCHAR(100) NOT NULL,
+    type            VARCHAR(20) NOT NULL,  -- daily/weekly/monthly/special
+    config          TEXT NOT NULL,          -- JSON: frequency, routes, workers, schedule
+    status          VARCHAR(20) DEFAULT 'active',
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);

wm-patrol/src/main/java/com/water/patrol/controller/PatrolSetupController.java

@@ -0,0 +1,241 @@
+package com.water.patrol.controller;
+
+import com.water.common.core.result.R;
+import com.water.patrol.service.PatrolAreaService;
+import com.water.patrol.service.PatrolFormService;
+import com.water.patrol.service.PatrolRouteSetupService;
+import com.water.patrol.service.PatrolTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 巡查设置控制器 - Issue #87
+ * PAT-16 区域设置 / PAT-17 路线设置 / PAT-18 自定义表单 / PAT-19 表单挂接 / PAT-20 模版设置
+ */
+@Tag(name = "巡查设置")
+@RestController
+@RequestMapping("/patrol/setup")
+@RequiredArgsConstructor
+public class PatrolSetupController {
+
+    private final PatrolAreaService areaService;
+    private final PatrolRouteSetupService routeService;
+    private final PatrolFormService formService;
+    private final PatrolTemplateService templateService;
+
+    // ========== PAT-16 区域设置 ==========
+
+    @PostMapping("/area")
+    @Operation(summary = "创建巡检区域")
+    public R<Map<String, Object>> createArea(@RequestBody Map<String, Object> req) {
+        return R.ok(areaService.create(
+            (String) req.get("name"),
+            (String) req.get("code"),
+            req.get("parentId") != null ? Long.parseLong(String.valueOf(req.get("parentId"))) : null,
+            (String) req.get("description"),
+            req.get("lng") != null ? ((Number) req.get("lng")).doubleValue() : null,
+            req.get("lat") != null ? ((Number) req.get("lat")).doubleValue() : null,
+            req.get("radius") != null ? ((Number) req.get("radius")).doubleValue() : null));
+    }
+
+    @PutMapping("/area/{id}")
+    @Operation(summary = "更新巡检区域")
+    public R<Map<String, Object>> updateArea(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        return R.ok(areaService.update(id,
+            (String) req.get("name"),
+            (String) req.get("code"),
+            req.get("parentId") != null ? Long.parseLong(String.valueOf(req.get("parentId"))) : null,
+            (String) req.get("description"),
+            req.get("lng") != null ? ((Number) req.get("lng")).doubleValue() : null,
+            req.get("lat") != null ? ((Number) req.get("lat")).doubleValue() : null,
+            req.get("radius") != null ? ((Number) req.get("radius")).doubleValue() : null));
+    }
+
+    @DeleteMapping("/area/{id}")
+    @Operation(summary = "删除巡检区域")
+    public R<Void> deleteArea(@PathVariable Long id) {
+        areaService.delete(id);
+        return R.ok(null);
+    }
+
+    @GetMapping("/area/list")
+    @Operation(summary = "区域列表（支持树形）")
+    public R<Map<String, Object>> listAreas(@RequestParam(required = false) Long parentId) {
+        return R.ok(areaService.list(parentId));
+    }
+
+    @GetMapping("/area/{id}")
+    @Operation(summary = "区域详情（含统计）")
+    public R<Map<String, Object>> getAreaDetail(@PathVariable Long id) {
+        Map<String, Object> detail = areaService.getDetail(id);
+        if (detail == null) return R.fail("区域不存在");
+        return R.ok(detail);
+    }
+
+    // ========== PAT-17 路线设置 ==========
+
+    @PostMapping("/route")
+    @Operation(summary = "创建巡检路线")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> createRoute(@RequestBody Map<String, Object> req) {
+        List<Map<String, Object>> checkpoints = (List<Map<String, Object>>) req.get("checkpoints");
+        return R.ok(routeService.create(
+            (String) req.get("name"),
+            req.get("areaId") != null ? Long.parseLong(String.valueOf(req.get("areaId"))) : null,
+            checkpoints,
+            req.get("estimDuration") != null ? ((Number) req.get("estimDuration")).intValue() : null,
+            (String) req.get("description")));
+    }
+
+    @PutMapping("/route/{id}")
+    @Operation(summary = "更新巡检路线")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> updateRoute(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        List<Map<String, Object>> checkpoints = (List<Map<String, Object>>) req.get("checkpoints");
+        return R.ok(routeService.update(id,
+            (String) req.get("name"),
+            req.get("areaId") != null ? Long.parseLong(String.valueOf(req.get("areaId"))) : null,
+            checkpoints,
+            req.get("estimDuration") != null ? ((Number) req.get("estimDuration")).intValue() : null,
+            (String) req.get("description")));
+    }
+
+    @DeleteMapping("/route/{id}")
+    @Operation(summary = "删除巡检路线")
+    public R<Void> deleteRoute(@PathVariable Long id) {
+        routeService.delete(id);
+        return R.ok(null);
+    }
+
+    @GetMapping("/route/list")
+    @Operation(summary = "路线列表")
+    public R<Map<String, Object>> listRoutes(
+            @RequestParam(required = false) Long areaId,
+            @RequestParam(defaultValue = "1") int page,
+            @RequestParam(defaultValue = "20") int size) {
+        return R.ok(routeService.list(areaId, page, size));
+    }
+
+    @GetMapping("/route/{id}")
+    @Operation(summary = "路线详情（含巡检点列表）")
+    public R<Map<String, Object>> getRouteDetail(@PathVariable Long id) {
+        Map<String, Object> detail = routeService.getDetail(id);
+        if (detail == null) return R.fail("路线不存在");
+        return R.ok(detail);
+    }
+
+    @PostMapping("/route/{id}/copy")
+    @Operation(summary = "复制路线")
+    public R<Map<String, Object>> copyRoute(@PathVariable Long id) {
+        return R.ok(routeService.copyRoute(id));
+    }
+
+    // ========== PAT-18 自定义表单 + PAT-19 表单挂接 ==========
+
+    @PostMapping("/form")
+    @Operation(summary = "创建巡检表单")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> createForm(@RequestBody Map<String, Object> req) {
+        List<Map<String, Object>> fields = (List<Map<String, Object>>) req.get("fields");
+        return R.ok(formService.createForm(
+            (String) req.get("name"),
+            (String) req.get("type"),
+            fields));
+    }
+
+    @GetMapping("/form/list")
+    @Operation(summary = "表单列表")
+    public R<Map<String, Object>> listForms(@RequestParam(required = false) String type) {
+        return R.ok(formService.listForms(type));
+    }
+
+    @GetMapping("/form/{id}")
+    @Operation(summary = "表单详情（含字段定义）")
+    public R<Map<String, Object>> getFormDetail(@PathVariable Long id) {
+        Map<String, Object> form = formService.getForm(id);
+        if (form == null) return R.fail("表单不存在");
+        return R.ok(form);
+    }
+
+    @PostMapping("/form/{id}/bind")
+    @Operation(summary = "挂接表单")
+    public R<Map<String, Object>> bindForm(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        String targetType = (String) req.get("targetType");
+        Long targetId = Long.parseLong(String.valueOf(req.get("targetId")));
+        return R.ok(formService.bindForm(id, targetType, targetId));
+    }
+
+    @PostMapping("/form/{id}/unbind")
+    @Operation(summary = "解绑表单")
+    public R<Map<String, Object>> unbindForm(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        String targetType = (String) req.get("targetType");
+        Long targetId = Long.parseLong(String.valueOf(req.get("targetId")));
+        return R.ok(formService.unbindForm(id, targetType, targetId));
+    }
+
+    @GetMapping("/form/bound")
+    @Operation(summary = "获取已绑定的表单")
+    public R<Map<String, Object>> getBoundForms(
+            @RequestParam String targetType,
+            @RequestParam Long targetId) {
+        return R.ok(formService.getBoundForms(targetType, targetId));
+    }
+
+    // ========== PAT-20 模版设置 ==========
+
+    @PostMapping("/template")
+    @Operation(summary = "创建巡检模板")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> createTemplate(@RequestBody Map<String, Object> req) {
+        Map<String, Object> config = (Map<String, Object>) req.get("config");
+        return R.ok(templateService.create(
+            (String) req.get("name"),
+            (String) req.get("type"),
+            config));
+    }
+
+    @PutMapping("/template/{id}")
+    @Operation(summary = "更新巡检模板")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> updateTemplate(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        Map<String, Object> config = (Map<String, Object>) req.get("config");
+        return R.ok(templateService.update(id,
+            (String) req.get("name"),
+            (String) req.get("type"),
+            config));
+    }
+
+    @DeleteMapping("/template/{id}")
+    @Operation(summary = "删除巡检模板")
+    public R<Void> deleteTemplate(@PathVariable Long id) {
+        templateService.delete(id);
+        return R.ok(null);
+    }
+
+    @GetMapping("/template/list")
+    @Operation(summary = "模板列表")
+    public R<Map<String, Object>> listTemplates(@RequestParam(required = false) String type) {
+        return R.ok(templateService.list(type));
+    }
+
+    @GetMapping("/template/{id}")
+    @Operation(summary = "模板详情（含关联路线/表单）")
+    public R<Map<String, Object>> getTemplateDetail(@PathVariable Long id) {
+        Map<String, Object> detail = templateService.getDetail(id);
+        if (detail == null) return R.fail("模板不存在");
+        return R.ok(detail);
+    }
+
+    @PostMapping("/template/{id}/apply")
+    @Operation(summary = "应用模板生成巡检计划")
+    @SuppressWarnings("unchecked")
+    public R<Map<String, Object>> applyTemplate(@PathVariable Long id, @RequestBody Map<String, Object> req) {
+        Map<String, String> dateRange = (Map<String, String>) req.get("dateRange");
+        return R.ok(templateService.applyTemplate(id, dateRange));
+    }
+}

wm-patrol/src/main/java/com/water/patrol/service/PatrolAreaService.java

@@ -0,0 +1,116 @@
+package com.water.patrol.service;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 巡检区域设置服务 - PAT-16
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class PatrolAreaService {
+
+    private final JdbcTemplate jdbc;
+
+    public Map<String, Object> create(String name, String code, Long parentId,
+                                       String description, Double lng, Double lat, Double radius) {
+        jdbc.update(
+            "INSERT INTO patrol_area (name, code, parent_id, description, lng, lat, radius, status) " +
+            "VALUES (?,?,?,?,?,?,?,'active')",
+            name, code, parentId != null ? parentId : 0, description, lng, lat, radius != null ? radius : 0);
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("name", name);
+        result.put("code", code);
+        result.put("created", true);
+        return result;
+    }
+
+    public Map<String, Object> update(Long id, String name, String code, Long parentId,
+                                       String description, Double lng, Double lat, Double radius) {
+        Map<String, Object> existing = getDetail(id);
+        if (existing == null) throw new RuntimeException("区域不存在: " + id);
+
+        StringBuilder sql = new StringBuilder("UPDATE patrol_area SET updated_at = NOW()");
+        List<Object> params = new ArrayList<>();
+
+        if (name != null) { sql.append(", name = ?"); params.add(name); }
+        if (code != null) { sql.append(", code = ?"); params.add(code); }
+        if (parentId != null) { sql.append(", parent_id = ?"); params.add(parentId); }
+        if (description != null) { sql.append(", description = ?"); params.add(description); }
+        if (lng != null) { sql.append(", lng = ?"); params.add(lng); }
+        if (lat != null) { sql.append(", lat = ?"); params.add(lat); }
+        if (radius != null) { sql.append(", radius = ?"); params.add(radius); }
+
+        sql.append(" WHERE id = ?");
+        params.add(id);
+        jdbc.update(sql.toString(), params.toArray());
+
+        return getDetail(id);
+    }
+
+    public void delete(Long id) {
+        long childCount = countQuery("SELECT COUNT(*) FROM patrol_area WHERE parent_id = ?", id);
+        if (childCount > 0) throw new RuntimeException("存在子区域，无法删除");
+        jdbc.update("DELETE FROM patrol_area WHERE id = ?", id);
+    }
+
+    public Map<String, Object> getDetail(Long id) {
+        List<Map<String, Object>> rows = jdbc.queryForList("SELECT * FROM patrol_area WHERE id = ?", id);
+        if (rows.isEmpty()) return null;
+
+        Map<String, Object> area = new LinkedHashMap<>(rows.get(0));
+
+        long deviceCount = countQuery(
+            "SELECT COUNT(*) FROM patrol_device WHERE area = (SELECT code FROM patrol_area WHERE id = ?)", id);
+        area.put("deviceCount", deviceCount);
+
+        long routeCount = countQuery("SELECT COUNT(*) FROM patrol_route WHERE area_id = ?", id);
+        area.put("routeCount", routeCount);
+
+        return area;
+    }
+
+    public Map<String, Object> list(Long parentId) {
+        List<Map<String, Object>> areas;
+        if (parentId != null) {
+            areas = jdbc.queryForList("SELECT * FROM patrol_area WHERE parent_id = ? ORDER BY name", parentId);
+        } else {
+            areas = jdbc.queryForList("SELECT * FROM patrol_area ORDER BY parent_id, name");
+        }
+
+        List<Map<String, Object>> tree = buildTree(areas, 0L);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("total", areas.size());
+        result.put("records", tree);
+        return result;
+    }
+
+    private List<Map<String, Object>> buildTree(List<Map<String, Object>> all, Long parentId) {
+        List<Map<String, Object>> tree = new ArrayList<>();
+        for (Map<String, Object> area : all) {
+            Object pid = area.get("parent_id");
+            long areaParentId = pid instanceof Number ? ((Number) pid).longValue() : 0L;
+            if (areaParentId == parentId) {
+                Map<String, Object> node = new LinkedHashMap<>(area);
+                Long areaId = ((Number) area.get("id")).longValue();
+                List<Map<String, Object>> children = buildTree(all, areaId);
+                if (!children.isEmpty()) {
+                    node.put("children", children);
+                }
+                tree.add(node);
+            }
+        }
+        return tree;
+    }
+
+    private long countQuery(String sql, Object... args) {
+        Long count = jdbc.queryForObject(sql, Long.class, args);
+        return count != null ? count : 0;
+    }
+}

wm-patrol/src/main/java/com/water/patrol/service/PatrolFormService.java

@@ -0,0 +1,103 @@
+package com.water.patrol.service;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 巡检自定义表单服务 - PAT-18 + PAT-19
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class PatrolFormService {
+
+    private final JdbcTemplate jdbc;
+
+    // ========== PAT-18: 自定义表单 ==========
+
+    public Map<String, Object> createForm(String name, String type, List<Map<String, Object>> fields) {
+        String fieldsJson = fields != null ? fields.toString() : "[]";
+        jdbc.update(
+            "INSERT INTO patrol_form (name, type, fields, status) VALUES (?,?,?::jsonb,'active')",
+            name, type, fieldsJson);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("name", name);
+        result.put("type", type);
+        result.put("fieldCount", fields != null ? fields.size() : 0);
+        result.put("created", true);
+        return result;
+    }
+
+    public Map<String, Object> listForms(String type) {
+        List<Map<String, Object>> forms;
+        if (type != null && !type.isEmpty()) {
+            forms = jdbc.queryForList("SELECT * FROM patrol_form WHERE type = ? ORDER BY created_at DESC", type);
+        } else {
+            forms = jdbc.queryForList("SELECT * FROM patrol_form ORDER BY created_at DESC");
+        }
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("total", forms.size());
+        result.put("records", forms);
+        return result;
+    }
+
+    public Map<String, Object> getForm(Long id) {
+        List<Map<String, Object>> rows = jdbc.queryForList("SELECT * FROM patrol_form WHERE id = ?", id);
+        if (rows.isEmpty()) return null;
+        return new LinkedHashMap<>(rows.get(0));
+    }
+
+    // ========== PAT-19: 表单挂接 ==========
+
+    public Map<String, Object> bindForm(Long formId, String targetType, Long targetId) {
+        Map<String, Object> form = getForm(formId);
+        if (form == null) throw new RuntimeException("表单不存在: " + formId);
+
+        jdbc.update(
+            "INSERT INTO patrol_form_binding (form_id, target_type, target_id) VALUES (?,?,?) " +
+            "ON CONFLICT (form_id, target_type, target_id) DO NOTHING",
+            formId, targetType, targetId);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("formId", formId);
+        result.put("targetType", targetType);
+        result.put("targetId", targetId);
+        result.put("bound", true);
+        return result;
+    }
+
+    public Map<String, Object> unbindForm(Long formId, String targetType, Long targetId) {
+        int rows = jdbc.update(
+            "DELETE FROM patrol_form_binding WHERE form_id = ? AND target_type = ? AND target_id = ?",
+            formId, targetType, targetId);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("formId", formId);
+        result.put("targetType", targetType);
+        result.put("targetId", targetId);
+        result.put("unbound", rows > 0);
+        return result;
+    }
+
+    public Map<String, Object> getBoundForms(String targetType, Long targetId) {
+        List<Map<String, Object>> forms = jdbc.queryForList(
+            "SELECT pf.*, pfb.created_at as bound_at FROM patrol_form pf " +
+            "INNER JOIN patrol_form_binding pfb ON pf.id = pfb.form_id " +
+            "WHERE pfb.target_type = ? AND pfb.target_id = ? " +
+            "ORDER BY pfb.created_at DESC",
+            targetType, targetId);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("targetType", targetType);
+        result.put("targetId", targetId);
+        result.put("total", forms.size());
+        result.put("forms", forms);
+        return result;
+    }
+}

wm-patrol/src/main/java/com/water/patrol/service/PatrolRouteSetupService.java

@@ -0,0 +1,166 @@
+package com.water.patrol.service;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Service;
+
+import java.util.*;
+
+/**
+ * 巡检路线设置服务 - PAT-17
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class PatrolRouteSetupService {
+
+    private final JdbcTemplate jdbc;
+
+    public Map<String, Object> create(String name, Long areaId, List<Map<String, Object>> checkpoints,
+                                       Integer estimDuration, String description) {
+        jdbc.update(
+            "INSERT INTO patrol_route (route_name, area_id, estim_duration, description, status) " +
+            "VALUES (?,?,?,?,'active')",
+            name, areaId, estimDuration, description);
+
+        Long routeId = jdbc.queryForObject("SELECT currval('patrol_route_id_seq')", Long.class);
+
+        if (checkpoints != null && !checkpoints.isEmpty()) {
+            for (int i = 0; i < checkpoints.size(); i++) {
+                Map<String, Object> cp = checkpoints.get(i);
+                jdbc.update(
+                    "INSERT INTO patrol_route_checkpoint (route_id, checkpoint_seq, device_id, device_name, lng, lat, check_items) " +
+                    "VALUES (?,?,?,?,?,?,?::jsonb)",
+                    routeId, i + 1,
+                    cp.get("deviceId"),
+                    (String) cp.get("deviceName"),
+                    cp.get("lng") != null ? ((Number) cp.get("lng")).doubleValue() : null,
+                    cp.get("lat") != null ? ((Number) cp.get("lat")).doubleValue() : null,
+                    cp.get("checkItems") != null ? cp.get("checkItems").toString() : "[]");
+            }
+        }
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("id", routeId);
+        result.put("name", name);
+        result.put("areaId", areaId);
+        result.put("checkpointCount", checkpoints != null ? checkpoints.size() : 0);
+        result.put("created", true);
+        return result;
+    }
+
+    public Map<String, Object> update(Long id, String name, Long areaId,
+                                       List<Map<String, Object>> checkpoints,
+                                       Integer estimDuration, String description) {
+        Map<String, Object> existing = getDetail(id);
+        if (existing == null) throw new RuntimeException("路线不存在: " + id);
+
+        StringBuilder sql = new StringBuilder("UPDATE patrol_route SET updated_at = NOW()");
+        List<Object> params = new ArrayList<>();
+
+        if (name != null) { sql.append(", route_name = ?"); params.add(name); }
+        if (areaId != null) { sql.append(", area_id = ?"); params.add(areaId); }
+        if (estimDuration != null) { sql.append(", estim_duration = ?"); params.add(estimDuration); }
+        if (description != null) { sql.append(", description = ?"); params.add(description); }
+
+        sql.append(" WHERE id = ?");
+        params.add(id);
+        jdbc.update(sql.toString(), params.toArray());
+
+        if (checkpoints != null) {
+            jdbc.update("DELETE FROM patrol_route_checkpoint WHERE route_id = ?", id);
+            for (int i = 0; i < checkpoints.size(); i++) {
+                Map<String, Object> cp = checkpoints.get(i);
+                jdbc.update(
+                    "INSERT INTO patrol_route_checkpoint (route_id, checkpoint_seq, device_id, device_name, lng, lat, check_items) " +
+                    "VALUES (?,?,?,?,?,?,?::jsonb)",
+                    id, i + 1,
+                    cp.get("deviceId"),
+                    (String) cp.get("deviceName"),
+                    cp.get("lng") != null ? ((Number) cp.get("lng")).doubleValue() : null,
+                    cp.get("lat") != null ? ((Number) cp.get("lat")).doubleValue() : null,
+                    cp.get("checkItems") != null ? cp.get("checkItems").toString() : "[]");
+            }
+        }
+
+        return getDetail(id);
+    }
+
+    public void delete(Long id) {
+        jdbc.update("DELETE FROM patrol_route_checkpoint WHERE route_id = ?", id);
+        jdbc.update("DELETE FROM patrol_route WHERE id = ?", id);
+    }
+
+    public Map<String, Object> getDetail(Long id) {
+        List<Map<String, Object>> rows = jdbc.queryForList("SELECT * FROM patrol_route WHERE id = ?", id);
+        if (rows.isEmpty()) return null;
+
+        Map<String, Object> route = new LinkedHashMap<>(rows.get(0));
+
+        List<Map<String, Object>> checkpoints = jdbc.queryForList(
+            "SELECT * FROM patrol_route_checkpoint WHERE route_id = ? ORDER BY checkpoint_seq", id);
+        route.put("checkpoints", checkpoints);
+
+        Object areaId = route.get("area_id");
+        if (areaId != null && areaId instanceof Number) {
+            List<Map<String, Object>> areaRows = jdbc.queryForList(
+                "SELECT name FROM patrol_area WHERE id = ?", ((Number) areaId).longValue());
+            if (!areaRows.isEmpty()) {
+                route.put("areaName", areaRows.get(0).get("name"));
+            }
+        }
+
+        return route;
+    }
+
+    public Map<String, Object> list(Long areaId, int page, int size) {
+        StringBuilder sql = new StringBuilder("SELECT * FROM patrol_route WHERE 1=1");
+        List<Object> params = new ArrayList<>();
+
+        if (areaId != null) {
+            sql.append(" AND area_id = ?");
+            params.add(areaId);
+        }
+        sql.append(" ORDER BY created_at DESC LIMIT ? OFFSET ?");
+        params.add(size);
+        params.add((page - 1) * size);
+
+        List<Map<String, Object>> records = jdbc.queryForList(sql.toString(), params.toArray());
+
+        StringBuilder countSql = new StringBuilder("SELECT COUNT(*) FROM patrol_route WHERE 1=1");
+        List<Object> countParams = new ArrayList<>();
+        if (areaId != null) {
+            countSql.append(" AND area_id = ?");
+            countParams.add(areaId);
+        }
+        long total = countQuery(countSql.toString(), countParams.toArray());
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("total", total);
+        result.put("page", page);
+        result.put("size", size);
+        result.put("records", records);
+        return result;
+    }
+
+    public Map<String, Object> copyRoute(Long id) {
+        Map<String, Object> source = getDetail(id);
+        if (source == null) throw new RuntimeException("路线不存在: " + id);
+
+        String newName = source.get("route_name") + " (副本)";
+        Long areaId = source.get("area_id") instanceof Number ? ((Number) source.get("area_id")).longValue() : null;
+        Integer estimDuration = source.get("estim_duration") instanceof Number ? ((Number) source.get("estim_duration")).intValue() : null;
+        String description = (String) source.get("description");
+
+        @SuppressWarnings("unchecked")
+        List<Map<String, Object>> checkpoints = (List<Map<String, Object>>) source.get("checkpoints");
+
+        return create(newName, areaId, checkpoints, estimDuration, description);
+    }
+
+    private long countQuery(String sql, Object... args) {
+        Long count = jdbc.queryForObject(sql, Long.class, args);
+        return count != null ? count : 0;
+    }
+}

wm-patrol/src/main/java/com/water/patrol/service/PatrolTemplateService.java

@@ -0,0 +1,148 @@
+package com.water.patrol.service;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.jdbc.core.JdbcTemplate;
+import org.springframework.stereotype.Service;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.*;
+
+/**
+ * 巡检模板设置服务 - PAT-20
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class PatrolTemplateService {
+
+    private final JdbcTemplate jdbc;
+
+    public Map<String, Object> create(String name, String type, Map<String, Object> config) {
+        String configJson = config != null ? config.toString() : "{}";
+        jdbc.update(
+            "INSERT INTO patrol_template (name, type, config, status) VALUES (?,?,?::jsonb,'active')",
+            name, type, configJson);
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("name", name);
+        result.put("type", type);
+        result.put("created", true);
+        return result;
+    }
+
+    public Map<String, Object> update(Long id, String name, String type, Map<String, Object> config) {
+        Map<String, Object> existing = getDetail(id);
+        if (existing == null) throw new RuntimeException("模板不存在: " + id);
+
+        StringBuilder sql = new StringBuilder("UPDATE patrol_template SET updated_at = NOW()");
+        List<Object> params = new ArrayList<>();
+
+        if (name != null) { sql.append(", name = ?"); params.add(name); }
+        if (type != null) { sql.append(", type = ?"); params.add(type); }
+        if (config != null) { sql.append(", config = ?::jsonb"); params.add(config.toString()); }
+
+        sql.append(" WHERE id = ?");
+        params.add(id);
+        jdbc.update(sql.toString(), params.toArray());
+
+        return getDetail(id);
+    }
+
+    public void delete(Long id) {
+        jdbc.update("DELETE FROM patrol_template WHERE id = ?", id);
+    }
+
+    public Map<String, Object> getDetail(Long id) {
+        List<Map<String, Object>> rows = jdbc.queryForList("SELECT * FROM patrol_template WHERE id = ?", id);
+        if (rows.isEmpty()) return null;
+        return new LinkedHashMap<>(rows.get(0));
+    }
+
+    public Map<String, Object> list(String type) {
+        List<Map<String, Object>> templates;
+        if (type != null && !type.isEmpty()) {
+            templates = jdbc.queryForList(
+                "SELECT * FROM patrol_template WHERE type = ? ORDER BY created_at DESC", type);
+        } else {
+            templates = jdbc.queryForList("SELECT * FROM patrol_template ORDER BY created_at DESC");
+        }
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("total", templates.size());
+        result.put("records", templates);
+        return result;
+    }
+
+    /**
+     * 应用模板生成巡检计划
+     */
+    public Map<String, Object> applyTemplate(Long templateId, Map<String, String> dateRange) {
+        Map<String, Object> template = getDetail(templateId);
+        if (template == null) throw new RuntimeException("模板不存在: " + templateId);
+
+        String type = (String) template.get("type");
+        String startDateStr = dateRange.get("startDate");
+        String endDateStr = dateRange.get("endDate");
+        LocalDate startDate = LocalDate.parse(startDateStr);
+        LocalDate endDate = LocalDate.parse(endDateStr);
+
+        List<LocalDate> taskDates = new ArrayList<>();
+        LocalDate current = startDate;
+
+        switch (type) {
+            case "daily":
+                while (!current.isAfter(endDate)) {
+                    taskDates.add(current);
+                    current = current.plusDays(1);
+                }
+                break;
+            case "weekly":
+                while (!current.isAfter(endDate)) {
+                    taskDates.add(current);
+                    current = current.plusWeeks(1);
+                }
+                break;
+            case "monthly":
+                while (!current.isAfter(endDate)) {
+                    taskDates.add(current);
+                    current = current.plusMonths(1);
+                }
+                break;
+            case "special":
+                taskDates.add(startDate);
+                break;
+            default:
+                taskDates.add(startDate);
+        }
+
+        int taskCount = 0;
+        for (LocalDate taskDate : taskDates) {
+            try {
+                jdbc.update(
+                    "INSERT INTO patrol_task (task_name, task_date, plan_start, plan_end, status) " +
+                    "VALUES (?, ?, ?, ?, 'pending')",
+                    template.get("name") + " - " + taskDate,
+                    taskDate,
+                    LocalDateTime.of(taskDate, LocalTime.of(9, 0)),
+                    LocalDateTime.of(taskDate, LocalTime.of(17, 0)));
+                taskCount++;
+            } catch (Exception e) {
+                log.warn("Failed to create task for date {}: {}", taskDate, e.getMessage());
+            }
+        }
+
+        Map<String, Object> result = new LinkedHashMap<>();
+        result.put("templateId", templateId);
+        result.put("templateName", template.get("name"));
+        result.put("type", type);
+        result.put("startDate", startDateStr);
+        result.put("endDate", endDateStr);
+        result.put("taskDates", taskDates.size());
+        result.put("tasksCreated", taskCount);
+        result.put("applied", true);
+        return result;
+    }
+}