27/README.md

ODF 光纤配线单元管理系统

基于需求分析结果生成的 C++17 工程，提供 ODF 光纤配线单元的标准化数据建模、编码生成、兼容性校验、典型配置管理与项目排期跟踪功能。

目录结构

├── CMakeLists.txt        # CMake 构建配置（C++17，MSVC /utf-8 支持）
├── README.md
├── include/
│   └── app.hpp           # 核心头文件：数据结构、枚举、ODFManager 类声明
├── src/
│   ├── app.cpp           # ODFManager 业务逻辑实现
│   └── main.cpp          # 命令行演示入口
└── tests/
    └── basic_test.cpp    # 单元测试（标准库 assert，无外部依赖）

构建与运行

前置要求

• CMake >= 3.10
• 支持 C++17 的编译器（GCC 8+, Clang 7+, MSVC 2019+）

编译步骤

cd codegen-runs/codegen_0aba9d8655fb4800802d9d53d920a8a4
mkdir -p build && cd build
cmake ..
cmake --build .

运行主程序

./odf_manager

主程序演示：编码生成、典型配置查询、兼容性校验、标签打印、里程碑排期导出。

运行单元测试

./basic_test

共 6 个测试用例覆盖：编码生成（含唯一性冲突处理）、适配器兼容性校验、单元注册（含容量约束与重复检测）、典型配置查询、标签与里程碑功能。

设计要点

需求	实现
ODF 单元数据结构	ODFUnitInfo 结构体，包含 ID、型号、位置、制造商、适配器列表
适配器接口规格	AdapterSpec 结构体，含接口类型（LC/SC/MPO）、等级（OM1-OS2）、端面（UPC/APC）、插损/回损
命名编码规则	generate_naming_code() 格式 [site]-[cabinet]-[slot]，长度 ≤ 64 字符，冲突自动去重
典型配置方案	TypicalConfig 结构 + register/get_typical_config 接口
兼容性校验	validate_adapter_compatibility() 按接口类型匹配，允许 UPC ↔ APC 混合
项目里程碑	Milestone 结构 + export_milestone_schedule() 输出文本表格
标签打印	print_label() 生成含文本 + 二维码占位符的标签内容
容量约束	注册时校验 max_capacity_cores ≤ 288