SAST Evento

NJUPT SAST C++组 SoC 项目

关于

这个仓库包含了 C++ 组 2024 年暑期代码活动的任务和项目。该活动由 SAST 组织，旨在为学生提供学习和贡献开源项目的机会。

简介

SAST Evento 是一个 SAST 的事件管理系统，平时我们在活动过程中一般都会遇到下面的问题：

• 活动信息收集仍然通过传统的共享表格，效率低
• 活动时间安排冲突需要手动排查、活动场地冲突也要手动排查
• 活动计划表虽然模板一样，但是每周都需要人手动更新，没法自动生成
• 同学们活动没有的反馈不高，活动完的收获没法量化
• 活动的质量没有比较好的反馈

针对上面的问题，我们决定 SoC 期间制作一个活动辅助系统帮助部长和讲师们更加顺畅地完成日常活动，减少沟通负担。

本项目是 SAST Evento 的跨平台桌面客户端版本。

License

项目基于 MIT License 发布

参与开发

先决条件

• 支持 C++20 或更高标准的编译器
• CMake 3.15 或更高版本
• vcpkg 包管理器
• Rust 工具链

克隆

git clone --recursive https://github.com/NJUPT-SAST/sast-evento.git

注意：本项目使用了子模块，所以请确保使用 --recursive 参数来克隆仓库，或者在克隆后执行以下命令：

git submodule update --init --recursive

提交检查 Hook

本项目使用 pre-commit 来进行提交检查，以确保代码风格一致性。请先安装 pre-commit 工具：

# For Arch Linux
sudo pacman -S pre-commit
# For Pipx users (cross-platform)
pipx install pre-commit

然后在克隆项目后执行以下命令安装 pre-commit 钩子：

pre-commit install

Tip

如果您认为工具提供的结果不可靠，可使用 git commit --no-verify 临时跳过提交检查。

构建

Tip

我们建议使用 VScode 打开和编辑项目。我们特别保留 .vscode 文件夹用于基本设置和扩展。

本项目使用 CMake Presets 来快速配置和构建项目，所需命令行如下：

# 对于 Windows 平台，请保证编译工具集相关环境变量已经配置
# 您可以使用 `vcpkg env` 命令进入正确设置环境变量的 shell
cmake --preset native
# 根据需要，可换用 `native-debug`, `native-release` 或 `native-relwithdebinfo` 预设
cmake --build --preset native

项目依赖

• Boost.Beast
• Boost.Url
• OpenSSL
• Slint
• toml++
• nlohmann-json
• spdlog
• keychain