Compare commits

..

1 Commits

Author SHA1 Message Date
lids 6bd7608e5c 需求注释 2026-06-02 15:14:03 +08:00
3 changed files with 76 additions and 492 deletions

View File

@ -9,6 +9,10 @@
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="核心引擎初始化", id="REQ-ENGINE-INIT-001")
*
*
*
* @brief
*/
CmsEngine::CmsEngine()
@ -21,8 +25,11 @@ CmsEngine::CmsEngine()
}
/**
* @brief
* @requirement(name="唯一标识生成", id="REQ-UTIL-IDGEN-001")
* "ID-xxxxx"
* ID
*
* @brief
* @return std::string "ID-00001"
*/
std::string CmsEngine::generateNextId()
@ -37,10 +44,11 @@ std::string CmsEngine::generateNextId()
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="战场事件接入", id="REQ-EVENT-INGEST-001")
* 线
* ID
*
* @brief
*
* ID
*
* @param event
* @return true
* @return false
@ -58,11 +66,11 @@ bool CmsEngine::ingestEvent(const EventRecord& event)
}
/**
* @requirement(name="待处理事件处理", id="REQ-EVENT-PROC-001")
* Pending Generated
* TaskPlan
*
* @brief
*
* Pending Generated
* TaskPlan
*
* @return size_t
*/
size_t CmsEngine::processPendingEvents()
@ -90,8 +98,11 @@ size_t CmsEngine::processPendingEvents()
}
/**
* @brief ID
* @requirement(name="事件查询", id="REQ-EVENT-QUERY-001")
* ID
* nullptr
*
* @brief ID
* @param eventId
* @return const EventRecord* nullptr
*/
@ -110,10 +121,11 @@ const EventRecord* CmsEngine::findEventById(const std::string& eventId) const
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="任务方案创建", id="REQ-PLAN-CREATE-001")
* ID
*
*
* @brief
*
* ID
*
* @param plan id
* @return true
* @return false
@ -130,8 +142,10 @@ bool CmsEngine::createTaskPlan(TaskPlan& plan)
}
/**
* @brief
* @requirement(name="任务方案列表查询", id="REQ-PLAN-LIST-001")
*
*
* @brief
* @return const std::vector<TaskPlan>&
*/
const std::vector<TaskPlan>& CmsEngine::getAllPlans() const
@ -140,8 +154,11 @@ const std::vector<TaskPlan>& CmsEngine::getAllPlans() const
}
/**
* @brief ID
* @requirement(name="任务方案查找", id="REQ-PLAN-FIND-001")
* ID
* nullptr
*
* @brief ID
* @param planId
* @return const TaskPlan* nullptr
*/
@ -156,8 +173,11 @@ const TaskPlan* CmsEngine::findPlanById(const std::string& planId) const
}
/**
* @brief
* @requirement(name="任务方案状态更新", id="REQ-PLAN-UPDATE-001")
* ID
* 稿
*
* @brief
* @param planId
* @param newStatus
* @return true
@ -179,8 +199,10 @@ bool CmsEngine::updatePlanStatus(const std::string& planId, PlanStatus newStatus
// ══════════════════════════════════════════════════════════════════════════════
/**
* @brief
* @requirement(name="模板注册", id="REQ-TMPL-REG-001")
*
*
* @brief
* @param tmpl
*/
void CmsEngine::registerTemplate(const TemplateInstance& tmpl)
@ -189,10 +211,11 @@ void CmsEngine::registerTemplate(const TemplateInstance& tmpl)
}
/**
* @requirement(name="模板匹配", id="REQ-TMPL-MATCH-001")
*
* nullptr
*
* @brief
*
*
*
* @param scenario
* @return const TemplateInstance* nullptr
*/
@ -216,10 +239,11 @@ const TemplateInstance* CmsEngine::matchTemplate(const std::string& scenario) co
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="执行状态上报", id="REQ-MON-REPORT-001")
* nodeId
*
*
* @brief
*
* nodeId
*
* @param status
*/
void CmsEngine::reportExecutionStatus(const ExecutionStatus& status)
@ -228,10 +252,11 @@ void CmsEngine::reportExecutionStatus(const ExecutionStatus& status)
}
/**
* @requirement(name="节点健康检查", id="REQ-MON-HEALTH-001")
* < 0.5 != 0
* 30
*
* @brief
*
* < 0.5 != 0 > 30
*
* @return std::vector<ExecutionStatus>
*/
std::vector<ExecutionStatus> CmsEngine::checkHealth() const
@ -268,10 +293,10 @@ std::vector<ExecutionStatus> CmsEngine::checkHealth() const
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="用户会话创建", id="REQ-SESS-CREATE-001")
* userId
*
* @brief
*
* userId
*
* @param session
* @return true
* @return false ID
@ -289,10 +314,11 @@ bool CmsEngine::createSession(const UserSession& session)
}
/**
* @requirement(name="权限校验", id="REQ-SESS-PERM-001")
*
*
*
* @brief
*
*
*
* @param userId ID
* @param permissionMask
* @return true
@ -313,8 +339,10 @@ bool CmsEngine::checkPermission(const std::string& userId,
// ══════════════════════════════════════════════════════════════════════════════
/**
* @brief
* @requirement(name="通知推送", id="REQ-NOTIF-PUSH-001")
*
*
* @brief
* @param msg
*/
void CmsEngine::pushNotification(const NotificationMessage& msg)
@ -323,8 +351,11 @@ void CmsEngine::pushNotification(const NotificationMessage& msg)
}
/**
* @brief
* @requirement(name="未读通知查询", id="REQ-NOTIF-UNREAD-001")
*
*
*
* @brief
* @return std::vector<NotificationMessage>
*/
std::vector<NotificationMessage> CmsEngine::getUnreadNotifications() const
@ -343,10 +374,11 @@ std::vector<NotificationMessage> CmsEngine::getUnreadNotifications() const
// ══════════════════════════════════════════════════════════════════════════════
/**
* @requirement(name="运行模式切换", id="REQ-MODE-SWITCH-001")
*
*
*
* @brief
*
*
*
* @param newMode
* @return true
* @return false
@ -364,8 +396,11 @@ bool CmsEngine::switchMode(RunMode newMode)
}
/**
* @brief
* @requirement(name="系统状态查询", id="REQ-MODE-QUERY-001")
*
*
*
* @brief
* @return const SystemStateContext&
*/
const SystemStateContext& CmsEngine::getSystemContext() const
@ -374,8 +409,11 @@ const SystemStateContext& CmsEngine::getSystemContext() const
}
/**
* @brief
* @requirement(name="引擎摘要生成", id="REQ-SUMM-GEN-001")
*
*
*
* @brief
* @return std::string
*/
std::string CmsEngine::getSummary() const

View File

@ -1,25 +0,0 @@
cmake_minimum_required(VERSION 3.10.0)
project(test_plan_execute_t1)
include(FetchContent)
if (MSVC)
add_compile_options(/utf-8)
endif()
FetchContent_Declare(
googletest
URL https://github.com/google/googletest/archive/03597a01ee50ed33e9dfd640b249b4be3799d395.zip
)
# For Windows: Prevent overriding the parent project's compiler/linker settings
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
FetchContent_MakeAvailable(googletest)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/../include)
include(CTest)
enable_testing()
add_executable(test_plan_execute_t1 test_app.cpp ../src/app.cpp)
target_link_libraries(test_plan_execute_t1 gtest gmock gtest_main)
include(GoogleTest)
gtest_discover_tests(test_plan_execute_t1)

View File

@ -1,429 +0,0 @@
#include <gtest/gtest.h>
#include <gmock/gmock.h>
#include "app.hpp"
#include <string>
#include <vector>
#include <chrono>
using namespace testing;
// ============================================================================
// 测试套件CmsEngine::processPendingEvents
// ============================================================================
/**
* @brief processPendingEvents Pending事件
*/
TEST(CmsEngineProcessPendingEventsTest, ProcessMultiplePendingEvents) {
CmsEngine engine;
for (size_t i = 0; i < 3; ++i) {
EventRecord evt;
evt.id = "EVT-" + std::to_string(i);
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
}
size_t processed = engine.processPendingEvents();
EXPECT_EQ(processed, 3);
// 验证所有事件状态已更新为Generated
for (size_t i = 0; i < 3; ++i) {
std::string eventId = "EVT-" + std::to_string(i);
const EventRecord* evt = engine.findEventById(eventId);
ASSERT_NE(evt, nullptr);
EXPECT_EQ(evt->status, EventStatus::Generated);
}
// 验证生成了对应的TaskPlan
const auto& plans = engine.getAllPlans();
EXPECT_EQ(plans.size(), 3);
for (size_t i = 0; i < 3; ++i) {
EXPECT_EQ(plans[i].relatedEventId, "EVT-" + std::to_string(i));
EXPECT_EQ(plans[i].status, PlanStatus::Drafting);
EXPECT_EQ(plans[i].type, PlanType::Centralized);
EXPECT_FALSE(plans[i].name.empty());
EXPECT_FALSE(plans[i].id.empty());
}
}
/**
* @brief processPendingEvents 0Pending事件
*/
TEST(CmsEngineProcessPendingEventsTest, ProcessZeroPendingEvents) {
CmsEngine engine;
for (size_t i = 0; i < 3; ++i) {
EventRecord evt;
evt.id = "EVT-" + std::to_string(i);
evt.priority = 100;
evt.status = EventStatus::Generated;
engine.ingestEvent(evt);
}
size_t processed = engine.processPendingEvents();
EXPECT_EQ(processed, 0);
// 验证没有生成新的TaskPlan
const auto& plans = engine.getAllPlans();
EXPECT_TRUE(plans.empty());
}
/**
* @brief processPendingEvents
*/
TEST(CmsEngineProcessPendingEventsTest, ProcessEmptyEventList) {
CmsEngine engine;
size_t processed = engine.processPendingEvents();
EXPECT_EQ(processed, 0);
const auto& plans = engine.getAllPlans();
EXPECT_TRUE(plans.empty());
}
/**
* @brief processPendingEvents
*/
TEST(CmsEngineProcessPendingEventsTest, ProcessMixedStatusEvents) {
CmsEngine engine;
// 添加2个Pending事件
for (size_t i = 0; i < 2; ++i) {
EventRecord evt;
evt.id = "PENDING-" + std::to_string(i);
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
}
// 添加2个Generated事件
for (size_t i = 0; i < 2; ++i) {
EventRecord evt;
evt.id = "GENERATED-" + std::to_string(i);
evt.priority = 100;
evt.status = EventStatus::Generated;
engine.ingestEvent(evt);
}
size_t processed = engine.processPendingEvents();
EXPECT_EQ(processed, 2);
// 验证只有Pending事件被处理
const EventRecord* pendingEvt0 = engine.findEventById("PENDING-0");
ASSERT_NE(pendingEvt0, nullptr);
EXPECT_EQ(pendingEvt0->status, EventStatus::Generated);
const EventRecord* generatedEvt0 = engine.findEventById("GENERATED-0");
ASSERT_NE(generatedEvt0, nullptr);
EXPECT_EQ(generatedEvt0->status, EventStatus::Generated);
// 验证生成了2个TaskPlan
const auto& plans = engine.getAllPlans();
EXPECT_EQ(plans.size(), 2);
}
/**
* @brief processPendingEvents Pending事件
*/
TEST(CmsEngineProcessPendingEventsTest, ProcessLargeNumberOfPendingEvents) {
const size_t largeCount = 1000;
CmsEngine engine;
for (size_t i = 0; i < largeCount; ++i) {
EventRecord evt;
evt.id = "EVT-" + std::to_string(i);
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
}
size_t processed = engine.processPendingEvents();
EXPECT_EQ(processed, largeCount);
const auto& plans = engine.getAllPlans();
EXPECT_EQ(plans.size(), largeCount);
// 验证ID生成正确递增
for (size_t i = 0; i < largeCount; ++i) {
std::string expectedId = "ID-" + std::string(5 - std::to_string(i + 1).length(), '0') + std::to_string(i + 1);
EXPECT_EQ(plans[i].id, expectedId);
}
}
// ============================================================================
// 测试套件CmsEngine::findEventById
// ============================================================================
/**
* @brief findEventById
*/
TEST(CmsEngineFindEventByIdTest, FindExistingEvent) {
CmsEngine engine;
EventRecord evt;
evt.id = "EVT-001";
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
const EventRecord* found = engine.findEventById("EVT-001");
ASSERT_NE(found, nullptr);
EXPECT_EQ(found->id, "EVT-001");
EXPECT_EQ(found->priority, 100);
EXPECT_EQ(found->status, EventStatus::Pending);
}
/**
* @brief findEventById ID
*/
TEST(CmsEngineFindEventByIdTest, FindNonExistentEvent) {
CmsEngine engine;
EventRecord evt;
evt.id = "EVT-001";
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
const EventRecord* found = engine.findEventById("NONEXISTENT");
EXPECT_EQ(found, nullptr);
}
/**
* @brief findEventById ID
*/
TEST(CmsEngineFindEventByIdTest, FindEventWithEmptyId) {
CmsEngine engine;
EventRecord evt;
evt.id = "EVT-001";
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
const EventRecord* found = engine.findEventById("");
EXPECT_EQ(found, nullptr);
}
/**
* @brief findEventById
*/
TEST(CmsEngineFindEventByIdTest, FindEventInEmptyEngine) {
const CmsEngine engine;
const EventRecord* found = engine.findEventById("ANY-ID");
EXPECT_EQ(found, nullptr);
}
/**
* @brief findEventById
*/
TEST(CmsEngineFindEventByIdTest, FindSpecificEventAmongMany) {
CmsEngine engine;
// 添加多个事件
for (int i = 0; i < 10; ++i) {
EventRecord evt;
evt.id = "EVT-" + std::to_string(i);
evt.priority = 50 + i * 10;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
}
const EventRecord* found = engine.findEventById("EVT-5");
ASSERT_NE(found, nullptr);
EXPECT_EQ(found->id, "EVT-5");
EXPECT_EQ(found->priority, 100);
}
/**
* @brief findEventById ID
*/
TEST(CmsEngineFindEventByIdTest, FindEventCaseSensitive) {
CmsEngine engine;
EventRecord evt;
evt.id = "Event-001";
evt.priority = 100;
evt.status = EventStatus::Pending;
engine.ingestEvent(evt);
const EventRecord* found = engine.findEventById("event-001");
EXPECT_EQ(found, nullptr);
found = engine.findEventById("Event-001");
ASSERT_NE(found, nullptr);
EXPECT_EQ(found->id, "Event-001");
}
// ============================================================================
// 测试套件CmsEngine::createTaskPlan
// ============================================================================
/**
* @brief createTaskPlan
*/
TEST(CmsEngineCreateTaskPlanTest, CreateValidTaskPlan) {
CmsEngine engine;
TaskPlan plan;
plan.name = "TestPlan";
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
plan.resourceQuota = 0.8;
plan.constraints = "测试约束";
bool result = engine.createTaskPlan(plan);
EXPECT_TRUE(result);
EXPECT_FALSE(plan.id.empty());
EXPECT_EQ(plan.name, "TestPlan");
EXPECT_EQ(plan.type, PlanType::Centralized);
EXPECT_EQ(plan.status, PlanStatus::Drafting);
EXPECT_EQ(plan.resourceQuota, 0.8);
EXPECT_EQ(plan.constraints, "测试约束");
// 验证方案已存入引擎
const auto& plans = engine.getAllPlans();
ASSERT_EQ(plans.size(), 1);
EXPECT_EQ(plans[0].id, plan.id);
EXPECT_EQ(plans[0].name, "TestPlan");
}
/**
* @brief createTaskPlan
*/
TEST(CmsEngineCreateTaskPlanTest, CreateTaskPlanWithEmptyName) {
CmsEngine engine;
TaskPlan plan;
plan.name = "";
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
bool result = engine.createTaskPlan(plan);
EXPECT_FALSE(result);
EXPECT_TRUE(plan.id.empty());
// 验证没有方案被添加
const auto& plans = engine.getAllPlans();
EXPECT_TRUE(plans.empty());
}
/**
* @brief createTaskPlan
*/
TEST(CmsEngineCreateTaskPlanTest, CreateTaskPlanWithWhitespaceName) {
CmsEngine engine;
TaskPlan plan;
plan.name = " ";
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
bool result = engine.createTaskPlan(plan);
EXPECT_TRUE(result);
EXPECT_FALSE(plan.id.empty());
const auto& plans = engine.getAllPlans();
ASSERT_EQ(plans.size(), 1);
EXPECT_EQ(plans[0].name, " ");
}
/**
* @brief createTaskPlan ID递增
*/
TEST(CmsEngineCreateTaskPlanTest, CreateMultipleTaskPlans) {
CmsEngine engine;
TaskPlan plan1;
plan1.name = "Plan1";
bool result1 = engine.createTaskPlan(plan1);
EXPECT_TRUE(result1);
EXPECT_EQ(plan1.id, "ID-00001");
TaskPlan plan2;
plan2.name = "Plan2";
bool result2 = engine.createTaskPlan(plan2);
EXPECT_TRUE(result2);
EXPECT_EQ(plan2.id, "ID-00002");
TaskPlan plan3;
plan3.name = "Plan3";
bool result3 = engine.createTaskPlan(plan3);
EXPECT_TRUE(result3);
EXPECT_EQ(plan3.id, "ID-00003");
const auto& plans = engine.getAllPlans();
ASSERT_EQ(plans.size(), 3);
EXPECT_EQ(plans[0].id, "ID-00001");
EXPECT_EQ(plans[1].id, "ID-00002");
EXPECT_EQ(plans[2].id, "ID-00003");
}
/**
* @brief createTaskPlan
*/
TEST(CmsEngineCreateTaskPlanTest, CreateTaskPlanWithSpecialCharacters) {
CmsEngine engine;
TaskPlan plan;
plan.name = "Plan_With_Special_Chars!@#$%^&*()";
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
bool result = engine.createTaskPlan(plan);
EXPECT_TRUE(result);
EXPECT_FALSE(plan.id.empty());
const auto& plans = engine.getAllPlans();
ASSERT_EQ(plans.size(), 1);
EXPECT_EQ(plans[0].name, "Plan_With_Special_Chars!@#$%^&*()");
}
/**
* @brief createTaskPlan
*/
TEST(CmsEngineCreateTaskPlanTest, CreateTaskPlanWithLongName) {
CmsEngine engine;
TaskPlan plan;
std::string longName(1000, 'A');
plan.name = longName;
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
bool result = engine.createTaskPlan(plan);
EXPECT_TRUE(result);
EXPECT_FALSE(plan.id.empty());
const auto& plans = engine.getAllPlans();
ASSERT_EQ(plans.size(), 1);
EXPECT_EQ(plans[0].name, longName);
}
/**
* @brief createTaskPlan findPlanById验证
*/
TEST(CmsEngineCreateTaskPlanTest, CreateAndFindTaskPlan) {
CmsEngine engine;
TaskPlan plan;
plan.name = "TestPlan";
plan.type = PlanType::Centralized;
plan.status = PlanStatus::Drafting;
bool result = engine.createTaskPlan(plan);
EXPECT_TRUE(result);
const TaskPlan* found = engine.findPlanById(plan.id);
ASSERT_NE(found, nullptr);
EXPECT_EQ(found->name, "TestPlan");
EXPECT_EQ(found->id, plan.id);
EXPECT_EQ(found->type, PlanType::Centralized);
EXPECT_EQ(found->status, PlanStatus::Drafting);
}