suyu_two/app/src/services/project_service.h

#pragma once

#include "domain/project_storage.h"

#include <string>

// 工程管理操作失败原因
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:
    // 使用外部提供的工程存储实现和启动配置创建服务
    ProjectService(
        ProjectStorage &storage,
        const ProjectLimitSettings &project_limits);

    // 只读访问当前工程；UI 和其他服务不应绕过 editProject 修改它
    const Project &project() const;
    // 获取服务层授权的可编辑引用，调用方必须随后完成校验
    Project &editProject();
    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; // 当前工程是否有未保存修改
};