#ifndef ODF_MANAGEMENT_NAMING_HELPER_HPP
#define ODF_MANAGEMENT_NAMING_HELPER_HPP

#include <string>
#include <optional>

/**
 * @brief 命名规则辅助工具
 *
 * 提供 ODF 单元编号的生成与校验功能。
 * 格式：区域代码-楼层号-机房编号-设备类型-端口容量-序列号-扩展标识
 * 示例：DC01-F03-TX-ODP-LC24-001-A
 */
class NamingHelper {
public:
    /**
     * @brief 校验 ODF 编号是否符合命名规则
     * @param code 待校验的编号字符串
     * @return 符合规则返回包含解析后的各部分信息，否则返回 std::nullopt
     */
    [[nodiscard]] static std::optional<std::string> validateFormat(const std::string& code);

    /**
     * @brief 生成 ODF 单元编号
     * @param areaCode    区域代码，如 "DC01"
     * @param floor       楼层号，如 "F03"
     * @param room        机房编号，如 "TX"
     * @param deviceType  设备类型，如 "ODP"
     * @param portDesc    端口容量描述，如 "LC24"
     * @param serial      序列号，如 "001"
     * @param extension   扩展标识（可选），如 "A"
     * @return 完整编号字符串
     */
    [[nodiscard]] static std::string generate(const std::string& areaCode,
                                              const std::string& floor,
                                              const std::string& room,
                                              const std::string& deviceType,
                                              const std::string& portDesc,
                                              const std::string& serial,
                                              const std::string& extension = "");

    /// @brief 命名规则的正则表达式模式
    static constexpr const char* PATTERN =
        "^[A-Z0-9]{2,6}-[A-Z]\\d{2}-[A-Z0-9]{2,6}-[A-Z]{2,6}-[A-Z]{2}\\d{2,4}-\\d{3}(-[A-Z0-9]+)?$";

private:
    NamingHelper() = delete;
};

#endif // ODF_MANAGEMENT_NAMING_HELPER_HPP