feat(net): evento api

[schoolbag123]

• SAST Link 登录
• 刷新 access token
• 获取用户信息
• 查询活动（新增）
• 获取正在进行的活动
• 获取最新的活动
• 获取历史活动（分页）
• 获取已参加的活动
• 获取已订阅的活动
• 获取指定部门的活动（分页）（新增）
• 获取用户反馈
• 添加反馈
• 签到
• 订阅活动
• 订阅部门
• 获取主页幻灯片
• 获取活动幻灯片
• 获取部门列表（新增）

网络层 Evento 相关 API 更新日志和注意事项

版本：8.17

注意： 本文档仅对部分难以理解的参数进行解释，其余参数可以语义化理解。如有其他事项或疑问，请在开发者群中询问或直接私聊。

非兼容性改动

Task<Result<bool>> checkInEvent(int eventId, std::string const& code);

Task<Result<bool>> subscribeEvent(int eventId, bool subscribe);

Task<Result<bool>> subscribeDepartment(std::string const& larkDepartment, bool subscribe);

• 以上三个函数的返回值最底层类型从 void 改为 bool。
• 请注意，成功返回 bool 值仅代表服务器成功收到请求并处理，bool 值表示服务器处理后的最终结果，需要根据结果判断整个操作是否成功。

Task<Result<EventQueryRes>> getActiveEventList();

Task<Result<EventQueryRes>> getLatestEventList();

Task<Result<EventQueryRes>> getHistoryEventList(int page, int size = 10);

• 以上三个函数的返回值类型从 EventEntityList 改为 EventQueryRes，类型描述见下方或相关文件。

Task<Result<std::optional<FeedbackEntity>>> getUserFeedback(int eventId);

• 函数返回值最底层类型从 FeedbackEntity 改为 std::optional<FeedbackEntity>。
• 在用户对该活动没有反馈（即 data 字段为空）时，std::optional<FeedbackEntity> 值为 std::nullopt，请注意相关判别和逻辑处理。

新增接口

Task<Result<DepartmentInfoEntityList>> getDepartmentInfo();

• 用途： 获取部门列表。
• 参数： 空。
• 返回值类型： 详见下方或相关文件。

Task<Result<EventQueryRes>> getDepartmentEventList(std::string const& larkDepartment, int page, int size = 10);

• 用途： 通过 Department 获取指定部门的相关活动。
• 参数： std::string const& larkDepartment, int page, int size。
• 注意： 部门名称字段的值应采用 getDepartmentInfo 函数中返回的对应值。

Task<Result<EventQueryRes>> getEventList(std::initializer_list<urls::param> params);

• 用途： 向 Evento 后端根据 params 请求事件列表。
• 参数： std::initializer_list<urls::param> params。
• 可选参数和相关约束： 请参考 API 文档。
• 注意事项： 请严格按照接口要求的键值对构造 params，具体详见示例。

使用示例：

// 构造一个请求 SAST 部门当前正在进行的活动的参数
// 第一个参数例如 "active" 内容必须和接口规范中的描述严格一致
std::initializer_list<urls::param> params = {{"active", "true"}, {"larkDepartmentName", "SAST"}};

新增类型

EventQueryRes 类型定义：

struct EventQueryRes {
    std::vector<EventEntity> elements;
    int current;
    int total;
};

• elements 字段代表事件列表。
• current 和 total 字段代表服务器返回的相应值。

DepartmentInfoEntityList 类型定义：

using DepartmentEntityList = std::vector<DepartmentEntity>;

struct DepartmentEntity {
    std::string id;
    std::string name;
};

• 各字段含义同变量名，请注意所有字段类型均为 std::string。

类型变更

struct EventEntity {
    int id;
    std::string summary;
    std::string description;
    std::string start;
    std::string end;
    std::string location;
    std::string tag;
    std::string larkMeetingRoomName;
    std::string larkDepartmentName;
    State state;
    bool isSubscribed; // 已订阅
    bool isCheckedIn;  // 已签到
};

• 返回类型 EventEntity 中 isChecked 变更为 isCheckedIn 以满足后端接口规范。

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[Serein207]

NOTE: 后端接口更改

• 新增 获取部门列表
• 新增 查询活动
• 废弃 获取正在进行的活动，最新活动，历史活动

网络层已有接口保持不变，根据后端接口更改以下接口实现方式：

• 获取正在进行的活动
• 获取最新的活动
• 获取历史活动
• 获取指定部门的活动（新增）
• 获取部门列表（新增）

可以新增一个和后端接口完全对应的接口，参数就是 std::initializer_list<std::param>，提供最高的可拓展性

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[Serein207]

查询活动接口的返回数据类型有变动，注意同步变更

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[Serein207]

改完之后就可以把 PR 打开，准备合入 dev 了

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"