{ "projectId": 94, "generationId": "codegen_b8528778ead64e3588cd3d3e22202f9f", "language": "C++", "status": "completed", "fileIds": [ 1283 ], "outputDir": "/app/agents/ai_agents/project-files/codegen-runs/codegen_b8528778ead64e3588cd3d3e22202f9f", "relativeOutputDir": "codegen-runs/codegen_b8528778ead64e3588cd3d3e22202f9f", "generatedFiles": [ "CMakeLists.txt", "events.ndjson", "include/app.hpp", "src/app.cpp", "src/main.cpp", "tests/basic_test.cpp" ], "analysisSummary": "## 业务目标\n构建面向数据中心、运营商机房及政企网络的高密度、模块化光纤配线单元（ODF）软件管理系统。核心目标包括：\n1. **物理连接数字化管理**：实现光纤端口、纤芯、熔接盘及光缆芯号的精准映射与全链路溯源，替代传统纸质台账。\n2. **高可靠运维支撑**：提供实时设备状态监控、异常告警与自动化数据同步能力，降低人工巡检与调度错误率。\n3. **标准化与安全合规**：严格遵循通信布线行业标准（YD/T 778、TIA/EIA-568等）及安全规范，保障数据机密性、完整性与系统环境适应性。\n4. **可扩展架构演进**：采用分层松耦合设计，支持软硬件独立升级、第三方综合布线系统对接及海量非结构化资料存储。\n\n## 功能清单\n| 功能模块 | 核心功能点 | 对应软件单元 |\n|:---|:---|:---|\n| **端口映射管理** | 端口唯一编号校验、映射关系新增/删除/更新/查询、冲突检测、路由信息维护 | PM-001 端口映射管理器 |\n| **设备状态监控** | 硬件节点健康度轮询、离线/故障告警生成、环境参数采集与阈值比对 | DM-002 设备监控器 |\n| **用户认证与授权** | 账号登录验证、RBAC角色权限控制、会话超时管理、操作审计日志记录 | UA-003 用户认证服务 |\n| **数据同步服务** | 与第三方综合布线管理软件双向同步、增量/全量映射数据推送、冲突解决策略 | DS-004 数据同步服务 |\n| **文件资源管理** | 设备说明书、安装视频、现场照片等多媒体资料的上传/下载/分片断点续传 | 对象存储服务（基础设施层） |\n| **系统配置与维护** | 数据库主从切换监控、备份策略执行、代码版本回滚、自动化部署脚本管理 | 基础设施层/DevOps流程 |\n\n## 数据结构\n### 核心关系型数据表：`PORT_MAPPING`\n| 字段名称 | 字段代码 | 数据类型 | 约束/说明 |\n|:---|:---|:---|:---|\n| 映射ID | `mapping_id` | INT | 主键，自增，唯一标识 |\n| 端口编号 | `port_code` | VARCHAR(10) | 字母数字组合，唯一索引，加密传输 |\n| 纤芯编号 | `fiber_core` | VARCHAR(10) | 字母数字组合，高精度标识 |\n| 熔接盘号 | `splice_tray` | VARCHAR | 关联物理熔接盘位置 |\n| 光缆芯号 | `cable_core` | VARCHAR | 关联上游光缆资源 |\n| 路由信息 | `route_info` | TEXT | 详细光路走向与跳接记录 |\n| 创建时间 | `create_time` | DATETIME | 记录首次映射时间 |\n| 更新时间 | `update_time` | DATETIME | 记录最后一次变更时间 |\n\n### 其他关键数据结构\n- **用户与权限模型**：基于RBAC的`Users`、`Roles`、`Permissions`关联表，支持细粒度API访问控制。\n- **设备状态快照**：JSON格式存储传感器节点上报的温度、湿度、端口活跃状态（ACTIVE/INACTIVE/ERROR）。\n- **文件元数据索引**：分布式对象存储中的文件UUID、访问权限策略、分片哈希值及上传时间戳。\n\n## 接口或命令\n### 外部通信接口：`IF-DATA-001`\n- **协议与格式**：RESTful API，HTTP POST/GET/PUT/DELETE，请求/响应体为JSON，传输层强制HTTPS加密。\n- **核心端点与签名**：\n | 接口名称 | 输入参数 | 输出参数 | 业务语义 |\n |:---|:---|:---|:---|\n | `addMapping` | `port_code`, `fiber_core` | `result_code` | 创建新端口映射，触发唯一性校验 |\n | `deleteMapping` | `port_code` | `result_code` | 解除端口绑定，清理关联缓存 |\n | `getMapping` | `port_code` | `mapping_info` | 查询完整映射详情及路由拓扑 |\n | `updateMapping` | `port_code`, `new_fiber_core` | `result_code` | 变更纤芯绑定，记录审计日志 |\n- **数据特征**：`port_code`/`fiber_core`要求高精度、实时高频交互；`status`枚举值限制为`ACTIVE`/`INACTIVE`/`ERROR`，低频小容量上报。\n\n## 约束\n1. **环境与硬件约束**：部署于室内机房（工作温度-5℃~+40℃，防护IP20）；计算资源限制为双核CPU、4GB RAM、64GB SSD、千兆以太网。\n2. **技术栈约束**：后端语言限定Java；关系型数据库采用MySQL主从复制架构；非结构化文件采用分布式对象存储；源码托管于GitLab按模块分仓。\n3. **标准与合规约束**：必须符合YD/T 778、TIA/EIA-568、ISO/IEC 11801布线标准；硬件材料满足RoHS 2.0与REACH环保指令。\n4. **安全约束**：实施纵深防御，敏感字段加密存储与传输；启用会话超时机制；所有输入需经严格校验防注入；权限最小化原则。\n5. **性能约束**：CRUD操作响应时间需达毫秒级；支持高并发读取与大数据量查询；系统需通过JMeter/LoadRunner压力验证。\n\n## 测试建议\n| 测试类型 | 测试重点 | 推荐工具/方法 | 验收标准 |\n|:---|:---|:---|:---|\n| **性能测试** | 并发请求处理能力、百万级映射记录查询效率、长时间运行稳定性 | JMeter（Web/API压测）、LoadRunner（复杂协议评估） | 吞吐量达标，P95响应<500ms，无内存泄漏 |\n| **可靠性测试** | 异常捕获恢复、数据库主从切换、故障注入与回滚策略 | 混沌工程工具、自动化故障模拟脚本 | 单点故障恢复时间99.9%，冲突记录可追溯 |\n| **代码级测试** | 核心函数路径覆盖、边界条件处理、单元测试隔离性 | JUnit/TestNG、SonarQube静态分析 | 核心函数覆盖率≥80%，无严重代码异味 |\n\n---\n\n## 需求可追踪性明细\n\n| 需求标识 | 需求名称 | 需求描述 | 来源文档 | 建议由哪一层职责或业务方法实现/验证 |\n|:---|:---|:---|:---|:---|\n| SRS-F-05-001 | 端口唯一编号系统 | 确保每个物理端口具备全局唯一标识，支持快速检索与防重复分配校验。 | 软件设计说明书_20260707_153102_042.docx（表7/表8） | **业务逻辑层(PM-001)**：通过`addMapping`/`getMapping`函数实现唯一性校验；**单元测试**验证数据库唯一索引与冲突拦截逻辑。 |\n| SRS-F-05-002 | 产品型号编码结构 | 遵循附录A规范定义的产品型号编码规则（如ODF-1U-24-LCD-SM-R-BK），用于资产分类、识别与批量导入解析。 | 软件设计说明书_20260707_153102_042.docx（表7/表8/附录A） | **业务逻辑层(PM-001)**：在输入参数解析模块实现正则匹配与格式校验；**集成测试**验证编码生成、解析与导出功能的准确性。 |\n| SRS-F-05-003 | 内部组件编号与溯源 | 记录熔接盘号、光缆芯号等内部组件信息，支持全链路物理拓扑追溯与变更历史留存。 | 软件设计说明书_20260707_153102_042.docx（表7/表8） | **业务逻辑层(PM-001)**：通过`updateMapping`维护`splice_tray`/`cable_core`字段；**审计日志审查**与数据库时间戳比对验证溯源完整性。 |\n| SRS-F-05-004 | 端口映射记录表支持 | 提供结构化数据存储方案，支持端口与纤芯的映射关系增删改查、历史版本管理及跨系统同步。 | 软件设计说明书_20260707_153102_042.docx（表7/表8） | **数据访问层(PM-001/DS-004)**：基于`PORT_MAPPING`表设计ORM映射；DS-004通过`syncData`实现第三方同步；**DBA脚本验证**与同步接口压测确认数据一致性。 |\n| SRS-NFR-SRS-010 | CSCI运行适应性需求 | 系统需适应室内机房环境，具备硬件状态监控、异常告警、宽温元器件适配及高可用容错能力。 | 软件设计说明书_20260707_153102_042.docx（表7/表8/3.6.5节） | **基础设施/监控层(DM-002)**：通过`checkStatus`轮询传感器节点并生成告警；**环境试验室温湿度/振动测试**结合故障注入验证系统鲁棒性。 |\n| SRS-NFR-SRS-011 | 安全性需求 | 实施纵深防御策略，包含身份认证、RBAC权限控制、HTTPS加密传输、输入校验及会话安全管理。 | 软件设计说明书_20260707_153102_042.docx（表7/表8/3.6.2节） | **安全网关/认证层(UA-003)**：通过`authenticate`实现令牌签发与权限拦截；**渗透测试**扫描漏洞，模拟越权/会话劫持操作验证防护机制有效性。 |", "eventLogFile": "/app/agents/ai_agents/project-files/codegen-runs/codegen_b8528778ead64e3588cd3d3e22202f9f/events.ndjson", "repoSettings": { "username": "root", "password": "pAssW0rd", "repoUrl": "http://47.108.255.216:3000/root/20260707.git", "branch": "20260707-161101" }, "repoUrl": "http://47.108.255.216:3000/root/20260707.git", "branch": "20260707-161101" }