南山区杏林雅苑项目视察-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3><p>覆盖全景浏览、社区安全、运营管理、监控录像的数据接口与联动逻辑。</p><h3>关联任务</h3><ul><li>关联设计：[设计] 小区IoT中控大屏页面设计</li><li>关联前端：[前端] 小区IoT中控大屏页面开发</li><li>关联测试：[测试-后端] 小区IoT中控大屏接口测试</li></ul><h3>接口1：全景数据总览</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/panorama/summary</td></tr><tr><td>对应功能</td><td>全景浏览-数据总览面板</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>全局上下文</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>area</td><td>number</td><td>占地面积</td><td>展示</td></tr><tr><td>greenRate</td><td>number</td><td>绿化率</td><td>展示</td></tr><tr><td>houses</td><td>number</td><td>房屋总量</td><td>展示</td></tr><tr><td>persons</td><td>number</td><td>人员总量</td><td>展示</td></tr><tr><td>cars</td><td>number</td><td>车辆总量</td><td>展示</td></tr><tr><td>facilities</td><td>number</td><td>配套设施数</td><td>展示</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验communityId</td><td>必填，UUID格式</td><td>缺失返回400</td></tr><tr><td>2.权限检查</td><td>校验用户对communityId访问权限</td><td>角色：物业经理/安防/运营</td><td>无权限403</td></tr><tr><td>3.数据查询</td><td>查询社区信息表、房屋表、人员表、车辆表、设施表</td><td>按communityId汇总</td><td>无数据返回0值</td></tr><tr><td>4.业务处理</td><td>计算绿化率、总量</td><td>绿化率=绿地面积/总面积</td><td>计算异常返回500</td></tr><tr><td>5.数据组装</td><td>组装 summary 字段</td><td>字段映射响应</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>400001</td><td>参数缺失</td><td>缺少必要参数</td></tr><tr><td>403001</td><td>无访问权限</td><td>无权限</td></tr><tr><td>500001</td><td>内部错误</td><td>服务异常</td></tr></table><h3>接口2：楼栋详情及模型点位</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/buildings/{id}/detail</td></tr><tr><td>对应功能</td><td>楼栋点击查看</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>id</td><td>string</td><td>是</td><td>楼栋ID</td><td>模型点击</td></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>上下文</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>occupancyRate</td><td>number</td><td>入住率</td><td>卡片展示</td></tr><tr><td>houseTypes</td><td>array</td><td>房屋类型分布</td><td>图表</td></tr><tr><td>personStats</td><td>array</td><td>人员分类统计</td><td>图表</td></tr><tr><td>cars</td><td>array</td><td>登记用车信息</td><td>列表</td></tr><tr><td>modelPosition</td><td>object</td><td>模型坐标</td><td>定位高亮</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验id、communityId</td><td>必填，UUID</td><td>400返回</td></tr><tr><td>2.权限检查</td><td>校验楼栋访问权限</td><td>角色：物业/安防</td><td>403返回</td></tr><tr><td>3.数据查询</td><td>楼栋、房屋、人员、车辆、模型表</td><td>按楼栋ID关联</td><td>无楼栋404</td></tr><tr><td>4.业务处理</td><td>计算入住率、分类统计</td><td>入住率=入住房屋/总房屋</td><td>异常500</td></tr><tr><td>5.数据组装</td><td>组装卡片数据+模型坐标</td><td>字段映射响应</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>404001</td><td>楼栋不存在</td><td>数据不存在</td></tr><tr><td>403001</td><td>无权限</td><td>无权限</td></tr><tr><td>500002</td><td>计算异常</td><td>服务异常</td></tr></table><h3>接口3：房屋搜索定位</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/houses/search</td></tr><tr><td>对应功能</td><td>房屋搜索定位</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>上下文</td></tr><tr><td>keyword</td><td>string</td><td>是</td><td>房号/楼栋/单元关键词</td><td>搜索框</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>houseId</td><td>string</td><td>房屋ID</td><td>点击高亮</td></tr><tr><td>displayName</td><td>string</td><td>楼栋-单元-室号</td><td>结果列表</td></tr><tr><td>modelPosition</td><td>object</td><td>坐标</td><td>定位高亮</td></tr><tr><td>personCarInfo</td><td>object</td><td>关联人员/车辆</td><td>详情弹窗</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验communityId、keyword</td><td>keyword 1-50字符</td><td>400返回</td></tr><tr><td>2.权限检查</td><td>校验查询权限</td><td>允许物业/安防/客服</td><td>403返回</td></tr><tr><td>3.数据查询</td><td>房屋表模糊匹配，关联模型坐标</td><td>按关键词LIKE，限制50条</td><td>无数据返回空数组</td></tr><tr><td>4.业务处理</td><td>补充关联人员车辆信息</td><td>最近登记车辆、住户信息</td><td>关联失败忽略</td></tr><tr><td>5.数据组装</td><td>组装列表</td><td>字段映射</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>400002</td><td>keyword非法</td><td>请输入有效房号</td></tr><tr><td>403002</td><td>无权限</td><td>无权限</td></tr><tr><td>500003</td><td>查询异常</td><td>服务异常</td></tr></table><h3>接口4：报警实时与统计</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/security/alarms</td></tr><tr><td>对应功能</td><td>社区安全-报警数据处理</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>上下文</td></tr><tr><td>status</td><td>string</td><td>否</td><td>待确认/已确认/误报</td><td>筛选</td></tr><tr><td>page</td><td>number</td><td>否</td><td>页码</td><td>分页</td></tr><tr><td>pageSize</td><td>number</td><td>否</td><td>每页</td><td>分页</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>stats</td><td>object</td><td>各状态数量</td><td>统计看板</td></tr><tr><td>list</td><td>array</td><td>报警列表</td><td>待处理列表</td></tr><tr><td>scroll</td><td>array</td><td>滚动播报最新报警</td><td>滚动区域</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验分页、status</td><td>page>=1,pageSize<=100</td><td>400返回</td></tr><tr><td>2.权限检查</td><td>校验报警查看权限</td><td>安防/值班可见</td><td>403返回</td></tr><tr><td>3.数据查询</td><td>查询报警表，按时间倒序，统计状态</td><td>过滤communityId</td><td>查询失败500</td></tr><tr><td>4.业务处理</td><td>滚动列表取最新100条，列表按分页</td><td>状态过滤优先</td><td>异常记录跳过</td></tr><tr><td>5.数据组装</td><td>stats+list+scroll</td><td>字段映射</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>400003</td><td>分页非法</td><td>分页参数错误</td></tr><tr><td>403003</td><td>无权限</td><td>无权限</td></tr><tr><td>500004</td><td>查询异常</td><td>服务异常</td></tr></table><h3>接口5：运营数据分析</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/operation/analytics</td></tr><tr><td>对应功能</td><td>运营管理-房屋/人员/车辆/工单/投诉</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>上下文</td></tr><tr><td>dateRange</td><td>array</td><td>否</td><td>时间范围</td><td>筛选控件</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>houseOccupancy</td><td>array</td><td>入住/空置趋势</td><td>图表</td></tr><tr><td>personComposition</td><td>array</td><td>人员类型分布</td><td>图表</td></tr><tr><td>vehicleStats</td><td>array</td><td>车辆占比</td><td>图表</td></tr><tr><td>workOrders</td><td>array</td><td>工单分类、最新工单</td><td>列表</td></tr><tr><td>complaints</td><td>array</td><td>投诉分类、最新投诉</td><td>列表</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验communityId，dateRange</td><td>dateRange最多90天</td><td>超出返回400</td></tr><tr><td>2.权限检查</td><td>校验运营数据查看权限</td><td>运营分析员/经理</td><td>403返回</td></tr><tr><td>3.数据查询</td><td>房屋、人员、车辆、工单、投诉、AI分类服务</td><td>按时间过滤</td><td>外部调用失败记录</td></tr><tr><td>4.业务处理</td><td>计算趋势、占比，调用AI分类</td><td>缺数据填0</td><td>AI失败降级不展示分类</td></tr><tr><td>5.数据组装</td><td>组装各模块数据</td><td>字段映射</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>400004</td><td>时间范围非法</td><td>请选择90天内时间</td></tr><tr><td>403004</td><td>无权限</td><td>无权限</td></tr><tr><td>500005</td><td>数据查询失败</td><td>服务异常</td></tr></table><h3>接口6：监控流列表</h3><table border="1" cellpadding="6" cellspacing="0"><tr><td>请求方式</td><td>GET</td></tr><tr><td>请求路径</td><td>/api/v1/monitor/streams</td></tr><tr><td>对应功能</td><td>监控录像多画面</td></tr></table><h4>请求参数</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th><th>前端来源</th></tr><tr><td>communityId</td><td>string</td><td>是</td><td>小区ID</td><td>上下文</td></tr><tr><td>limit</td><td>number</td><td>否</td><td>返回流数量</td><td>配置</td></tr></table><h4>响应字段</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>说明</th><th>前端用途</th></tr><tr><td>streams</td><td>array</td><td>流地址、类型、优先级</td><td>监控画面</td></tr></table><h4>详细业务逻辑（必须与需求功能点对应）</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>步骤</th><th>处理内容</th><th>规则说明</th><th>异常处理</th></tr><tr><td>1.参数校验</td><td>校验communityId、limit</td><td>limit默认9，最大16</td><td>非法400</td></tr><tr><td>2.权限检查</td><td>监控查看权限</td><td>安防/经理</td><td>403</td></tr><tr><td>3.数据查询</td><td>查询监控点位表、流媒体服务</td><td>按优先级排序</td><td>无流返回空</td></tr><tr><td>4.业务处理</td><td>生成可播放URL，过滤离线</td><td>离线标记状态</td><td>离线流不返回URL</td></tr><tr><td>5.数据组装</td><td>组装streams</td><td>包含坐标、名称</td><td>-</td></tr></table><h4>错误处理</h4><table border="1" cellpadding="6" cellspacing="0" width="100%"><tr style="background:#f2f2f2"><th>错误码</th><th>触发场景</th><th>前端提示</th></tr><tr><td>400005</td><td>参数非法</td><td>参数错误</td></tr><tr><td>403005</td><td>无权限</td><td>无权限</td></tr><tr><td>500006</td><td>流服务异常</td><td>视频不可用</td></tr></table>

添加之后

返回任务列表

返回研发需求列表

继续为该研发需求添加任务

所属模块

所有模块