Tars Docs
🌻

Tars Docs

日期
Mar 5, 2026
标签
Docs
描述
SDUTACM 后台管理系统「Tars」使用文档

管理员登陆

访问 /admin/admin/login 以进入登陆界面(已登陆会自动跳转到 /admin/overview
notion image
账号密码可询问 root 管理员。

OverView(网站数据总览)

进入系统后默认进入 OverView 界面,该界面展示了官网的日活、访问趋势、新闻统计、项目统计、管理员统计等数据。
notion image

HomePage(首页配置)

总览

在此配置官网首页显示的内容,左侧是一些基本的配置,基本上不大用改。
notion image

新闻首页展示、项目首页展示

主要是右侧的新闻首页展示与项目首页展示
notion image
新闻首页展示模块是一个穿索框,左侧为所有已发布新闻,右侧为首页展示新闻。
你可以把需要放到首页展示的新闻给放到右侧。
新闻首页展示必须展示五条新闻,如果不足五条或者超出五条则无法正常保存。
此处新闻的排序顺序与「News」管理的新闻列表的排序顺序一致,是按照创建时间排序的,但是首页展示会根据发布时间降序排序。
项目首页展示与新闻首页展示逻辑类似。

Media(媒体资源管理)

Media 模块主要用来进行 SDUTACM 线上资产的维护,你可以存放任何与 SDUTACM 相关的媒体素材,并且实时访问与下载,并且可以在 News 新闻管理处引用。

媒体资源类型

  • Logo:SDUTACM 原创的 Logo 设计稿或第三方 Logo 素材。
  • Image:朴实无华的图片存储。
  • Audio:音频素材,一大用处就是放到年度报告的 bgm 中,或者存放比赛的暖场音乐。
  • Video:视频素材,可以存放一些精彩回放和有纪念意义的小视频。
图片类型的资源上传单个不要超过 10MB,音视频资源支持大文件上传,最大不超过 500MB

上传媒体资源

以 Image 为例,当点击「+ Image」时,会弹出一个对话框,你可以点击从本地批量选择文件上传,也可以直接拖拽文件到文件上传框中。
notion image
下方的 Description 可以为所有此次上传的文件添加描述,建议添加一个方便区分有独立标识的描述信息,方便检索。

编辑媒体资源

媒体资源编辑主要是编辑 Description,此外你也可以在编辑界面看到该媒体资源的基本信息。
notion image

媒体资源操作

notion image
每个媒体资源卡片都具有四个操作按钮,从左到右依次是:“编辑”、“复制链接”、“下载到本地”、“删除”。

News(新闻管理)

每个新闻都分为”Draft(草稿)“以及”Published(发布)“状态,所有新闻都需要存放到一个合适的栏目中在新闻页进行展示。新闻页面展示新闻的顺序是按照发布时间降序排序。

栏目管理

notion image
在新闻管理界面的右上角搜索框输入栏目名称并且回车即可创建一个新的栏目。
对于搜索列表内的所有栏目,你都可以对其进行编辑以及删除,若删除了该栏目,那之前与之关联的所有新闻并不会删除
点击栏目,可以直接筛选出当前栏目下的所有新闻。
notion image

创建新闻

点击「+ News」即可呼出新闻创建对话框。
notion image
  • Cover Image:新闻封面,你可以从 Image 媒体资源库以及本地上传图片,从本地直接选择的图片会被同步上传到 Image 媒体库中。
  • Title:起一个响亮的标题。
  • Category:当前新闻所出的栏目。
  • WeChat Official Link:微信公众号链接,如果有的话可以在此处填写。
  • Content:内容。对于图片上传,点击图片按钮,你可以像选择 Cover Image 那样插入图片,也可以直接复制粘贴,粘贴到文本框的图片会同步上传到 Image 资源库中。
  • isPublished:是否发布。
  • publishedAt:调整新闻的发布时间。主要影响到新闻页项目的先后顺序。

编辑新闻

编辑新闻所用到的对话框与创建新闻的对话框类似,你可以调整 Cover Image 等任何字段。
此外,编辑新闻的对话跨框中还添加了一个“👀”按钮,这个按钮可以预览当前新闻的效果。
notion image
notion image
预览效果,如果没什么问题,可以点击左上角「To List」快速回到新闻管理界面。

管理员界面(普通管理员)

普通管理员可以在 /settings 界面看到管理员基本信息,你可以修改头像(但是一般不动)。
notion image
管理员界面还集成了审计以及回溯操作(Audit & Restore)

Audit(审计统计)

审计统计主要记录了所有的管理员操作,管理员的所有操作类型在 Operate Type 中,你可以选择一个 Operate Type 并结合 Search 来筛选当前 Operate Type 的所有操作记录。
notion image
Entity Type 为操作对象的实体,与导航栏的功能名称一一对应。
notion image
Time Range 是按时间来检索操作日志。
notion image
在审计日志列表中 Entity Name 为操作的实体的具体记录名称。Description 由服务器生成,简述此次操作。Actions 中,你可以通过 Det. 来查看此次操作的具体信息。
notion image
其中 Old Data New Data 为此次操作前后的数据快照,你可以通过结构化的数据快速找到 diff。

回溯(Restore)

回溯操作是针对单一记录的操作历史进行回溯,每个记录从创建开始就对应一个版本号,此后对该记录的任何操作,都会累积更新其版本号。
点击 Ver. 来查看当前记录的历史版本。
notion image
点击 Compare 你可以看到当前版本与指定版本之间的差异。
notion image
点击 Restore 可以将当前版本回溯到指定的版本,并创建一个全新的版本。
notion image

root admin(超级管理员)

超级管理员用户可以对普通管理员进行操作,包括新增删除管理员、修改管理员权限(为超级管理员还是普通管理员)以及重置管理员密码。
notion image
此外超级管理员还可以编辑首页的项目展示。
notion image
这与编辑新闻的操作是类似的,就不过多赘述。