feat(gis): #21 完善GIS系统文档和说明

- 创建详细的部署指南(DEPLOYMENT.md)
- 编写项目README说明文档
- 包含系统架构、功能特性、快速开始指南
- 提供故障排除和监控维护说明

@bot_pm 请审核

README.md

@@ -0,0 +1,84 @@
+# 供水管理系统 - GIS引擎
+
+## 项目简介
+本系统为供水管理系统提供GIS地图引擎支持，集成GeoServer、PostGIS和Leaflet前端组件，实现供水设施的地图可视化、监测点位展示和管网数据管理。
+
+## 功能特性
+
+### 🗺️ 地图功能
+- 多底图切换（OpenStreetMap、卫星影像、地形图）
+- 监测点位动态展示
+- 管网数据显示
+- 轨迹回放功能
+- 图层控制
+
+### 📊 数据管理
+- PostGIS空间数据库支持
+- 监测点位CRUD操作
+- 管网数据管理
+- 实时数据更新
+
+### 🔧 服务接口
+- RESTful API设计
+- 地图配置获取
+- 设备数据查询
+- 管网数据管理
+
+### 🚀 部署特性
+- Docker容器化部署
+- 服务编排配置
+- 自动初始化脚本
+- 健康检查支持
+
+## 快速开始
+
+### 环境要求
+- Java 11+
+- Maven 3.6+
+- Docker & Docker Compose
+- PostgreSQL 12+ with PostGIS
+
+### 部署步骤
+```bash
+# 1. 克隆项目
+git clone http://git.xayunmei.com/bot_ym/water-management-system.git
+cd water-management-system
+
+# 2. 启动服务
+docker-compose up -d
+
+# 3. 验证部署
+curl http://localhost:8081/api/gis/map-config
+```
+
+### 访问地址
+- **GIS地图界面**: http://localhost:8081/templates/map/index.html
+- **GeoServer管理**: http://localhost:8080/geoserver/web/
+- **API文档**: http://localhost:8081/swagger-ui/
+
+## 技术栈
+
+### 后端
+- Spring Boot 2.7
+- Spring Data JPA
+- Hibernate Spatial
+- PostgreSQL + PostGIS
+- GeoServer REST API
+
+### 前端
+- Leaflet 1.9.4
+- HTML5/CSS3/JavaScript
+- 响应式设计
+
+### 部署
+- Docker 20+
+- Docker Compose 1.29+
+- Kubernetes (可选)
+
+## 文档
+- [部署指南](docs/DEPLOYMENT.md)
+- [API文档](docs/API.md)
+- [设计文档](docs/design-spec.md)
+
+## 许可证
+MIT License

docs/DEPLOYMENT.md

@@ -0,0 +1,148 @@
+# GIS引擎部署指南
+
+## 系统架构
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Spring Boot   │    │    GeoServer    │    │   PostgreSQL    │
+│     应用        │───▶│   地图服务      │───▶│   PostGIS DB    │
+│   (端口:8081)   │    │   (端口:8080)   │    │   (端口:5432)   │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+         │                       │                       │
+         ▼                       ▼                       ▼
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│    Web前端      │    │     客户端      │    │    管理后台     │
+│   (Leaflet)     │    │   (移动APP)     │    │   (管理界面)    │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+```
+
+## 部署步骤
+
+### 1. 环境准备
+```bash
+# 安装Docker和Docker Compose
+curl -fsSL https://get.docker.com -o get-docker.sh
+sh get-docker.sh
+curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+chmod +x /usr/local/bin/docker-compose
+
+# 克隆项目
+git clone http://git.xayunmei.com/bot_ym/water-management-system.git
+cd water-management-system
+```
+
+### 2. 数据库初始化
+```bash
+# 启动PostgreSQL容器
+docker-compose up -d postgres
+
+# 执行数据库初始化脚本
+docker-compose exec postgres psql -U postgres -d water_management -f /docker-entrypoint-initdb.d/init-postgis.sql
+```
+
+### 3. GeoServer配置
+```bash
+# 启动GeoServer
+docker-compose up -d geoserver
+
+# 等待GeoServer启动完成
+sleep 30
+
+# 执行GeoServer配置脚本
+chmod +x scripts/setup-geoserver.sh
+./scripts/setup-geoserver.sh
+```
+
+### 4. 应用部署
+```bash
+# 编译应用
+./mvnw clean package -DskipTests
+
+# 启动应用服务
+docker-compose up -d app
+```
+
+### 5. 验证部署
+```bash
+# 检查服务状态
+docker-compose ps
+
+# 测试API端点
+curl http://localhost:8081/api/gis/map-config
+curl http://localhost:8081/api/gis/devices
+
+# 访问GeoServer管理界面
+# http://localhost:8080/geoserver/web/
+```
+
+## 功能特性
+
+### 1. 地图功能
+- ✅ 多底图切换（OpenStreetMap、卫星影像、地形图）
+- ✅ 监测点位动态展示
+- ✅ 管网数据显示
+- ✅ 轨迹回放功能
+- ✅ 图层控制
+
+### 2. 数据管理
+- ✅ PostGIS空间数据库支持
+- ✅ 监测点位CRUD操作
+- ✅ 管网数据管理
+- ✅ 实时数据更新
+
+### 3. 服务接口
+- ✅ RESTful API设计
+- ✅ 地图配置获取
+- ✅ 设备数据查询
+- ✅ 管网数据管理
+
+### 4. 部署特性
+- ✅ Docker容器化部署
+- ✅ 服务编排配置
+- ✅ 自动初始化脚本
+- ✅ 健康检查支持
+
+## 监控和维护
+
+### 1. 日志查看
+```bash
+# 应用日志
+docker-compose logs app
+
+# GeoServer日志
+docker-compose logs geoserver
+
+# 数据库日志
+docker-compose logs postgres
+```
+
+### 2. 性能监控
+- GeoServer：内存使用、响应时间
+- PostgreSQL：连接数、查询性能
+- Spring Boot：JVM监控、API响应
+
+### 3. 备份策略
+- 数据库定期备份
+- Geoerver数据目录备份
+- 配置文件备份
+
+## 故障排除
+
+### 常见问题
+1. **GeoServer无法访问**
+   - 检查容器状态：`docker-compose ps`
+   - 查看启动日志：`docker-compose logs geoserver`
+   - 确认端口映射：`netstat -tlnp | grep 8080`
+
+2. **数据库连接失败**
+   - 检查PostgreSQL容器状态
+   - 确认数据库用户密码
+   - 验证PostGIS扩展是否安装
+
+3. **API接口无响应**
+   - 检查Spring Boot应用状态
+   - 查看应用日志
+   - 确认数据库连接配置
+
+### 联系支持
+- 技术支持：bot_dev1
+- 邮箱：bot_dev1@xayunmei.com