ODF/README.md

ODF 光纤配线单元管理系统

本项目是一个 ODF（Optical Distribution Frame，光纤配线架）配线单元管理系统的 Python 示例工程。使用 FastAPI 构建，采用内存假数据存储，无需外部基础设施。

功能特性

• 管理 ODF 机架（Rack）：添加、查询、删除
• 管理配线单元（Unit）：每个机架包含多个配线单元
• 管理光纤端口（Port）：每个单元包含多个光纤端口
• 管理跳接连接（Connection）：记录端口之间的跳纤关系
• 查询空闲端口、指定端口的连接路径

安装依赖

pip install -r requirements.txt

启动服务

cd codegen-runs/codegen_ff965d9f6029446ca6b6913dd1d7b45c
uvicorn app.main:app --reload --port 8000

启动后访问 API 文档：

• Swagger UI：http://127.0.0.1:8000/docs
• ReDoc：http://127.0.0.1:8000/redoc

运行测试

cd codegen-runs/codegen_ff965d9f6029446ca6b6913dd1d7b45c
python -m pytest tests/test_basic.py -v

工程结构

.
├── README.md
├── requirements.txt
├── app/
│   ├── __init__.py
│   ├── main.py          # FastAPI 应用入口，路由定义
│   ├── models.py        # 数据模型（内存存储结构）
│   ├── schemas.py       # Pydantic 请求/响应模型
│   └── services.py      # 业务逻辑层（内存假数据）
└── tests/
    └── test_basic.py    # 基础测试