water-management-system/docs/DEPLOYMENT.md

GIS引擎部署指南

系统架构

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Spring Boot   │    │    GeoServer    │    │   PostgreSQL    │
│     应用        │───▶│   地图服务      │───▶│   PostGIS DB    │
│   (端口:8081)   │    │   (端口:8080)   │    │   (端口:5432)   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│    Web前端      │    │     客户端      │    │    管理后台     │
│   (Leaflet)     │    │   (移动APP)     │    │   (管理界面)    │
└─────────────────┘    └─────────────────┘    └─────────────────┘

部署步骤

1. 环境准备

# 安装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. 数据库初始化

# 启动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配置

# 启动GeoServer
docker-compose up -d geoserver

# 等待GeoServer启动完成
sleep 30

# 执行GeoServer配置脚本
chmod +x scripts/setup-geoserver.sh
./scripts/setup-geoserver.sh

4. 应用部署

# 编译应用
./mvnw clean package -DskipTests

# 启动应用服务
docker-compose up -d app

5. 验证部署

# 检查服务状态
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. 日志查看

# 应用日志
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