110 lines
3.1 KiB
C++
110 lines
3.1 KiB
C++
#ifndef ODF_MANAGEMENT_APP_HPP
|
||
#define ODF_MANAGEMENT_APP_HPP
|
||
|
||
#include "odf_unit.hpp"
|
||
#include "adapter_interface.hpp"
|
||
#include "naming_helper.hpp"
|
||
#include "config_template.hpp"
|
||
#include "project_milestone.hpp"
|
||
|
||
#include <string>
|
||
#include <vector>
|
||
|
||
/**
|
||
* @brief ODF 管理应用入口
|
||
*
|
||
* 提供顶层功能调度：创建 ODF 单元、管理适配器接口、
|
||
* 命名生成与校验、典型配置模板查询及项目里程碑跟踪。
|
||
*/
|
||
class App {
|
||
public:
|
||
/// @brief 构造函数
|
||
App();
|
||
|
||
// ==================== ODF 单元管理 ====================
|
||
|
||
/**
|
||
* @brief 添加一个 ODF 单元
|
||
* @param unit 单元信息
|
||
*/
|
||
void addOdfUnit(const OdfUnit& unit);
|
||
|
||
/// @brief 列出所有 ODF 单元摘要
|
||
[[nodiscard]] std::string listOdfUnits() const;
|
||
|
||
// ==================== 适配器接口管理 ====================
|
||
|
||
/**
|
||
* @brief 添加适配器接口规格
|
||
* @param iface 适配器接口信息
|
||
*/
|
||
void addAdapterInterface(const AdapterInterface& iface);
|
||
|
||
/// @brief 列出所有适配器接口
|
||
[[nodiscard]] std::string listAdapterInterfaces() const;
|
||
|
||
// ==================== 命名工具 ====================
|
||
|
||
/**
|
||
* @brief 校验编号格式
|
||
* @param code 编号字符串
|
||
* @return 校验结果说明
|
||
*/
|
||
[[nodiscard]] static std::string validateNamingFormat(const std::string& code);
|
||
|
||
/**
|
||
* @brief 生成示例编号
|
||
* @return 示例编号字符串
|
||
*/
|
||
[[nodiscard]] static std::string generateSampleNaming();
|
||
|
||
// ==================== 端口密度计算 ====================
|
||
|
||
/**
|
||
* @brief 计算单位高度（1U）端口密度
|
||
* @param rackHeightU 机柜高度（U 为单位）
|
||
* @param totalPorts 总端口数
|
||
* @return 每 U 端口密度（端口数/U，向下取整）
|
||
*/
|
||
[[nodiscard]] static uint32_t calculatePortDensity(uint32_t rackHeightU,
|
||
uint32_t totalPorts);
|
||
|
||
// ==================== 配置模板 ====================
|
||
|
||
/// @brief 获取所有内置模板摘要
|
||
[[nodiscard]] std::string listTemplates() const;
|
||
|
||
/**
|
||
* @brief 根据机柜数量生成 BOM
|
||
* @param templateIndex 模板索引
|
||
* @param cabinetCount 机柜数量
|
||
* @return BOM 摘要字符串
|
||
*/
|
||
[[nodiscard]] std::string generateBom(size_t templateIndex, uint32_t cabinetCount) const;
|
||
|
||
// ==================== 项目里程碑 ====================
|
||
|
||
/**
|
||
* @brief 添加项目里程碑
|
||
* @param ms 里程碑信息
|
||
*/
|
||
void addMilestone(const ProjectMilestone& ms);
|
||
|
||
/// @brief 列出所有里程碑
|
||
[[nodiscard]] std::string listMilestones() const;
|
||
|
||
/**
|
||
* @brief 检查所有里程碑时间约束
|
||
* @return 约束检查结果说明
|
||
*/
|
||
[[nodiscard]] std::string checkMilestonesConstraint() const;
|
||
|
||
private:
|
||
std::vector<OdfUnit> units_;
|
||
std::vector<AdapterInterface> adapters_;
|
||
std::vector<ProjectMilestone> milestones_;
|
||
std::vector<ConfigTemplate> templates_;
|
||
};
|
||
|
||
#endif // ODF_MANAGEMENT_APP_HPP
|