7/README.md

# ODF 光纤配线单元管理工具 (ODF Management)

## 概述

本项目提供了一套标准化的 **ODF（Optical Distribution Frame）光纤配线单元** 管理软件，
涵盖单元结构设计、适配器与连接器集成、编号命名管理、典型场景配置生成以及项目进度跟踪等核心功能。

## 功能简介

| 模块 | 说明 |
|------|------|
| **ODF 单元管理** | 支持熔接型/配线型/混合型单元，结构信息与容量管理 |
| **适配器接口管理** | 管理 LC / SC / MPO 等连接器类型、光纤模式、端面类型参数 |
| **命名规则引擎** | 按 `区域-楼层-机房-设备类型-序列号` 规则生成与校验编号 |
| **典型配置模板** | 内置"数据中心 LC 单模预端接"等场景，生成 BOM 物料清单 |
| **项目里程碑** | 跟踪需求、设计、样机、验证、交付等阶段进度 |

## 构建与运行

### 要求

- CMake >= 3.14
- C++17 编译器（GCC >= 8, Clang >= 7, MSVC 2019+）

### 编译

```bash
mkdir -p build && cd build
cmake ..
cmake --build .
```

### 运行主程序

```bash
./odf_manager
```

### 运行测试

```bash
./basic_test
```

## 工程结构

```
├── CMakeLists.txt
├── README.md
├── include/
│   ├── app.hpp               # 应用入口与顶层功能调度
│   ├── odf_unit.hpp          # ODF 单元数据结构
│   ├── adapter_interface.hpp # 适配器接口信息
│   ├── naming_helper.hpp     # 命名规则校验与生成
│   ├── config_template.hpp   # 典型配置模板
│   └── project_milestone.hpp # 项目里程碑数据
├── src/
│   ├── main.cpp              # 命令行入口
│   ├── app.cpp               # 业务逻辑实现
│   ├── odf_unit.cpp
│   ├── adapter_interface.cpp
│   ├── naming_helper.cpp
│   ├── config_template.cpp
│   └── project_milestone.cpp
└── tests/
    └── basic_test.cpp        # 单元测试（标准库 assert）
```

## 命名规则示例

格式：`区域代码-楼层-机房编号-设备类型-端口容量-序列号-扩展标识`

例：`DC01-F03-TX-ODP-LC24-001-A`

## 技术标准

- 适配器插入损耗 ≤ 0.3dB
- 回波损耗 ≥ 50dB (UPC) / ≥ 60dB (APC)
- 材料阻燃等级 UL94-V0
- 插拔次数 ≥ 500 次