100 lines
3.6 KiB
C++
100 lines
3.6 KiB
C++
#ifndef TPS_TEMPLATE_MANAGER_HPP
|
||
#define TPS_TEMPLATE_MANAGER_HPP
|
||
|
||
#include "app.hpp"
|
||
#include <string>
|
||
#include <vector>
|
||
#include <map>
|
||
|
||
// ============================================================
|
||
// 模板管理模块（SU-05 模板管理单元）
|
||
// ============================================================
|
||
|
||
/**
|
||
* 模板管理器。
|
||
* 负责任务模板的接收、存储、版本管理、可视化和自动推荐。
|
||
*/
|
||
class TemplateManager {
|
||
public:
|
||
TemplateManager() = default;
|
||
~TemplateManager() = default;
|
||
|
||
/**
|
||
* 接收推送的任务模板集合数据包。
|
||
*
|
||
* @requirement(name="接收推送的任务模板集合数据", id="SRS-F-04-001")
|
||
* 接收上级单位或云服务推送的任务模板集合数据包，
|
||
* 解析后进行增量或全量更新。
|
||
*
|
||
* @param payload 模板集合数据包（JSON/XML 字符串）
|
||
* @param format 数据格式（"json" / "xml"）
|
||
* @return true 表示接收并更新成功
|
||
*/
|
||
bool receiveTemplates(const std::string& payload, const std::string& format);
|
||
|
||
/**
|
||
* 获取当前可用的任务模板列表（仅已启用且未过期的模板）。
|
||
*
|
||
* @return 可用模板列表
|
||
*/
|
||
std::vector<TaskTemplate> getTemplateList() const;
|
||
|
||
/**
|
||
* 获取指定模板的所有版本记录。
|
||
*
|
||
* @requirement(name="任务模板先验知识库版本选择", id="SRS-F-03-001")
|
||
* 提供版本下拉框，允许用户选择已发布且未过期的任务模板版本。
|
||
*
|
||
* @param templateId 模板ID
|
||
* @return 版本列表
|
||
*/
|
||
std::vector<TemplateVersion> getConfig(const std::string& templateId) const;
|
||
|
||
/**
|
||
* 更新先验知识库配置参数。
|
||
*
|
||
* @requirement(name="先验知识库配置调整", id="SRS-F-03-002")
|
||
* 支持用户调整模板库相关配置参数，系统验证其合法性后更新
|
||
* 本地或服务器端配置文件。
|
||
*
|
||
* @param key 配置键
|
||
* @param value 配置值
|
||
* @return true 表示验证通过并更新成功
|
||
*/
|
||
bool updateConfig(const std::string& key, const std::string& value);
|
||
|
||
/**
|
||
* 在自主执行模式下运行匹配算法，推荐最优模板。
|
||
*
|
||
* @requirement(name="自主执行模式下任务模板自动选择提示", id="SRS-F-04-006")
|
||
* 在自主模式下，系统运行匹配算法计算各模板适配度，
|
||
* 选出最高分模板并向用户发出提示。
|
||
*
|
||
* @param scenario 当前任务场景描述
|
||
* @return 推荐度最高的模板ID，如果无匹配则返回空字符串
|
||
*/
|
||
std::string autoSelectTemplate(const std::string& scenario);
|
||
|
||
/**
|
||
* 在人环模式下用户手动选择模板。
|
||
*
|
||
* @requirement(name="人环模式下用户选择任务模板", id="SRS-F-04-005")
|
||
* 在人机协同模式下，用户可点击"选用此模板"按钮选择模板，
|
||
* 系统记录选择结果并锁定版本。
|
||
*
|
||
* @param templateId 选中的模板ID
|
||
* @param version 锁定的版本号
|
||
* @return true 表示选择成功
|
||
*/
|
||
bool selectTemplate(const std::string& templateId, const std::string& version);
|
||
|
||
private:
|
||
std::vector<TaskTemplate> templates_; ///< 模板库
|
||
std::map<std::string, std::vector<TemplateVersion>> versionMap_; ///< 模板ID -> 版本列表
|
||
std::map<std::string, std::string> configStore_; ///< 配置参数存储
|
||
std::string selectedTemplateId_; ///< 当前选中模板ID
|
||
std::string lockedVersion_; ///< 锁定版本
|
||
};
|
||
|
||
#endif // TPS_TEMPLATE_MANAGER_HPP
|