1. 项目概述
这个市容监察管理系统设计项目采用.NET后端+微信小程序前端的架构方案，旨在为城市管理部门提供便捷的移动执法工具。系统主要解决传统纸质化办公效率低下、问题上报流程繁琐、案件处理进度不透明等痛点。我在实际开发中发现，将微信小程序与政务系统结合，能显著提升基层工作人员的执法效率。
系统包含案件上报、任务派发、进度跟踪、数据统计等核心模块。开发过程中特别注重与现有政务系统的数据对接，以及移动端操作的便捷性设计。下面从技术选型、功能实现到部署上线的完整流程，我都会结合具体代码和实际踩坑经验进行详细说明。
2. 技术架构设计
2.1 整体技术栈选型
后端采用.NET Core 3.1框架，主要考虑因素包括：
- 与现有政务系统的兼容性（多数政府系统基于Windows Server）
- 成熟的ORM框架Entity Framework Core简化数据库操作
- 内置的JWT认证机制保障接口安全
- IIS部署方案符合政务系统运维习惯
前端选择微信小程序是因为：
- 无需安装额外APP，扫码即用
- 完善的摄像头、定位等硬件API调用能力
- 用户基数大（尤其适合中老年执法人员使用）
数据库选用SQL Server 2019，主要看中其：
- 与.NET生态的天然兼容性
- 强大的空间数据处理能力（用于案件地理位置存储）
- 成熟的备份恢复机制
2.2 系统架构设计
采用经典的三层架构：
code复制表现层：微信小程序 + 管理后台Web
业务层：.NET Core WebAPI
数据层：SQL Server + Redis缓存
特别设计了双通道通信机制：
- 实时通信：SignalR推送案件状态变更
- 异步通信：RabbitMQ处理图片压缩等耗时操作
3. 核心功能实现
3.1 案件上报模块
csharp复制// 案件实体类设计
public class CaseReport {
[Key]
public int CaseId { get; set; }
[Required]
[StringLength(200)]
public string Title { get; set; }
public CaseType Type { get; set; } // 案件类型枚举
[Column(TypeName = "geometry")]
public Point Location { get; set; } // 空间数据类型
public List<CaseImage> Images { get; set; }
}
// 微信小程序端上传代码
wx.chooseImage({
count: 3,
sizeType: ['compressed'],
success: (res) => {
const tempFiles = res.tempFiles
uploadFile(tempFiles) // 分段上传实现
}
})
关键实现细节：
- 图片采用分块上传，每张图片限制2MB以内
- 自动读取手机GPS坐标（需处理国产机坐标系转换）
- 采用腾讯云COS存储图片，生成临时访问链接
踩坑记录：早期版本直接传原图导致接口超时，后来改为先传缩略图，原图通过消息队列异步处理
3.2 任务派发算法
采用基于地理位置的智能派单算法：
csharp复制public List<Inspector> MatchInspectors(Point caseLocation) {
var availableInspectors = _db.Inspectors
.Where(i => i.Status == InspectorStatus.OnDuty)
.ToList();
return availableInspectors
.OrderBy(i => i.CurrentLocation.Distance(caseLocation))
.Take(3)
.ToList();
}
派单策略考虑因素：
- 执法人员当前位置（通过小程序定期上报）
- 当前任务量（避免任务分配不均）
- 专业领域匹配度（如广告拆除需特定资质）
3.3 实时进度追踪
使用SignalR实现状态实时推送：
javascript复制// 小程序端订阅通知
const connection = new signalR.HubConnectionBuilder()
.withUrl("/caseHub")
.configureLogging(signalR.LogLevel.Information)
.build();
connection.on("StatusUpdated", (caseId, status) => {
this.setData({ caseStatus: status })
});
后端事件处理：
csharp复制public async Task UpdateCaseStatus(int caseId, CaseStatus status) {
// 更新数据库
await _caseService.UpdateStatus(caseId, status);
// 推送通知
await _hubContext.Clients.Group($"case-{caseId}")
.SendAsync("StatusUpdated", caseId, status);
}
4. 数据库设计要点
4.1 核心表结构
| 表名 | 主要字段 | 说明 |
|---|---|---|
| Cases | CaseId, Title, Type, Location, Status | 案件主表 |
| CaseImages | ImageId, CaseId, CosUrl, ThumbnailUrl | 案件图片 |
| Inspectors | InspectorId, Name, CurrentLocation, Status | 执法人员 |
| Assignments | AssignmentId, CaseId, InspectorId, AssignTime | 任务分配 |
4.2 空间数据优化
针对地理位置查询的特殊优化：
sql复制-- 创建空间索引
CREATE SPATIAL INDEX IX_Cases_Location
ON Cases(Location)
WITH (BOUNDING_BOX = (xmin=73, ymin=18, xmax=136, ymax=54));
-- 查询5公里范围内的案件
SELECT * FROM Cases
WHERE Location.STDistance(@userLocation) < 5000
5. 部署实施经验
5.1 微信小程序审核要点
- 必须申请"政务民生"类目
- 用户隐私协议需明确说明位置、相机等权限用途
- 内容安全API需过滤用户上传的违规内容
- 测试账号需准备政府域名的邮箱注册
5.2 服务器配置建议
推荐的最低生产环境配置：
- 应用服务器：Windows Server 2019, 4核8G内存
- 数据库服务器：SQL Server 2019, 8核16G内存 + SSD存储
- 带宽：建议10Mbps以上（图片传输需求大）
实际运维中发现，案件图片存储量增长较快，建议每月检查COS存储桶容量
6. 开发中的典型问题
6.1 定位漂移问题
现象：安卓手机上报的坐标存在偏移
解决方案：
javascript复制// 坐标转换（GCJ02转WGS84）
function gcjToWgs(lat, lng) {
const ee = 0.00669342162296594323
const a = 6378245.0
// 转换算法实现...
return { lat: wgsLat, lng: wgsLng }
}
6.2 高并发下的文件上传
优化方案：
- 采用分块上传（每块512KB）
- 后端使用静态文件缓存
- 限制单个IP的上传频率
csharp复制services.AddRateLimiter(options => {
options.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(context =>
RateLimitPartition.GetFixedWindowLimiter(
context.Request.Headers["X-Forwarded-For"].FirstOrDefault() ??
context.Connection.RemoteIpAddress?.ToString(),
_ => new FixedWindowRateLimiterOptions {
PermitLimit = 10,
Window = TimeSpan.FromMinutes(1)
}));
});
7. 扩展功能建议
- 对接智能分析：
- 使用CNN识别违规广告牌
- NLP处理投诉文本分类
- 可视化大屏：
- ECharts展示案件热力图
- 实时统计处置效率指标
- 语音上报功能：
- 集成ASR实现语音转文字
- 关键词自动触发紧急案件
这个项目最让我有成就感的是看到基层执法人员真正用起来了。有个老城管告诉我，以前每天要手写十几张单子，现在手机点几下就完成上报，还能实时查看处理进度。技术上最大的收获是掌握了微信小程序与政务系统的深度集成方案，特别是如何处理政务系统特有的数据安全和权限控制需求。