#pragma once #include "domain/project_storage.h" #include // 工程管理操作失败原因 enum class ProjectServiceError { None, // 无错误 InvalidProjectName, // 工程名称为空或仅包含空白字符 FilePathRequired, // 未提供工程文件路径 InvalidProject, // 当前工程不符合领域规则 StorageFailure // 工程文件存储操作失败 }; // 工程管理操作结果;失败时当前工程和文件路径保持原状 struct ProjectOperationResult { bool succeeded = false; // 操作是否成功 ProjectServiceError error = ProjectServiceError::None; // 服务层错误原因 ProjectStorageError storageError = ProjectStorageError::None; // 存储层错误原因 std::string message; // 面向调用方的结果描述 }; // 编排当前工程的新建、保存和加载流程 class ProjectService { public: // 使用外部提供的工程存储实现创建服务 explicit ProjectService(ProjectStorage &storage); ProjectService( ProjectStorage &storage, const ProjectLimitSettings &project_limits); // 只读访问当前工程;UI 和其他服务不应绕过 editProject 修改它 const Project &project() const; // 获取服务层授权的可编辑引用,调用方必须随后完成校验 Project &editProject(); const std::string ¤tFilePath() const; bool hasCurrentFile() const; bool isModified() const; const ProjectLimitSettings &projectLimits() const; // 失败编辑回滚时恢复进入编辑前的脏状态 void restoreModifiedState(bool modified); /** * @brief 创建未保存的新工程 * @param name 工程名称,不得为空或仅包含空白字符 * @return 新建操作结果 */ ProjectOperationResult createNewProject(const std::string &name); /** * @brief 保存到当前工程文件 * @return 保存操作结果,当前工程没有文件路径时返回失败 */ ProjectOperationResult save(); /** * @brief 将当前工程保存到指定文件 * @param file_path UTF-8 编码的目标文件路径,不得为空或仅包含空白字符 * @return 保存操作结果 */ ProjectOperationResult saveAs(const std::string &file_path); /** 将当前工程导出到指定 JSON,不改变当前工程文件关联 */ ProjectOperationResult exportAs(const std::string &file_path) const; /** * @brief 从指定文件加载工程 * @param file_path UTF-8 编码的工程文件路径,不得为空或仅包含空白字符 * @return 加载操作结果,失败时不替换当前工程 */ ProjectOperationResult load(const std::string &file_path); private: static Project makeNewProject(const std::string &name); static bool isBlank(const std::string &value); static ProjectOperationResult storageFailure( ProjectStorageError error, const std::string &message); ProjectStorage &storage_; // 非拥有的工程存储依赖 const ProjectLimitSettings &project_limits_; // 应用启动时确定的只读数量上限 Project project_; // 当前编辑中的工程 std::string current_file_path_; // 当前工程对应的文件路径 bool modified_ = true; // 当前工程是否有未保存修改 };