作品

Dashboard Console

内部运营控制台与任务、日志、事件状态管理

状态
MVP
类型
控制台
更新

一个面向个人网站运营的控制台,聚合任务、日志、事件和系统状态,帮助项目进入可维护状态。

可验证入口

体验与源码

不提供公开 Demo

控制台包含内部任务、事件、日志和部署状态,并依赖管理员鉴权,因此不开放公共 Demo。

源码证据

从 API 实现进入仓库,可同时查看配套的 dashboard-web 客户端和测试。

证据

状态聚合

任务、日志、事件和系统状态被收敛到统一控制台模型

冲突边界

OSS 与 ETag 冲突作为设计约束被保留

扩展方向

后续可承接内容运营、部署记录和 Knock 摘要

资产状态

只展示仓库中可验证的 product mock、公开文档或明确的暂无公开图说明。

资产类型: 架构图

Dashboard Console 当前架构:管理员 JWT 与自动 ingest 分路进入 API,再读写带 ETag 边界的 OSS JSON
仅展示当前已实现的双鉴权、存储与一致性边界,不含真实标识或运营数据;内容编辑、部署记录和 Knock 摘要标为 roadmap。

资产类型: 文档链接

查看 Dashboard 架构计划

公开文档记录 monorepo 结构、OSS 数据布局、API surface、ETag 规则和测试要求。

查看 Dashboard 架构计划

问题

内容、部署、日志和任务散落在不同位置,长期维护时难以快速判断系统当前状态与下一步优先级。

方案

通过 dashboard-api 读写任务和事件数据,dashboard-web 展示可操作的状态视图,并保留 OSS 与 ETag 冲突边界。

我的工作

  • API 设计
  • OSS 存储接入
  • 冲突处理
  • 控制台信息架构

技术栈

  • Node.js
  • TypeScript
  • React
  • OSS

亮点

  • 读写路径有错误边界
  • 任务状态可追踪
  • 适合扩展内容运营模块

架构与实现

控制台由 dashboard-api 负责任务和事件读写,dashboard-web 渲染运营状态视图;存储层暂以 OSS 对象和 ETag 边界处理并发冲突。

  1. 步骤 01

    dashboard-web

    Next.js 客户端完成管理员登录,并读取当前状态和最近事件。

  2. 步骤 02

    双鉴权入口

    管理员 API 使用 JWT;自动事件 ingest 使用独立 INGEST_TOKEN。

  3. 步骤 03

    dashboard-api

    Express 路由提供 state、events、tasks、logs 和 status 的读写边界。

  4. 步骤 04

    OSS JSON 文档

    状态、任务、每日事件和日志按固定 key 保存到对象存储。

  5. 步骤 05

    ETag 冲突处理

    任务和追加数组使用条件写入与有限重试,冲突时返回明确错误或重试。

关键决策与影响

  1. 决策 01

    把 dashboard-web 与 dashboard-api 分开部署

    为什么这样做
    界面迭代和运营数据读写具有不同运行边界,API 也需要被自动事件入口调用。
    带来的影响
    前后端职责清楚,但部署时必须正确配置 API base、CORS 和反向代理。
  2. 决策 02

    管理员与自动 ingest 使用不同令牌

    为什么这样做
    自动任务只需要写事件,不应该获得管理员读取和修改控制台数据的权限。
    带来的影响
    权限面更小,但运维时需要分别管理 JWT secret、管理员密码和 INGEST_TOKEN。
  3. 决策 03

    以 OSS JSON 和 ETag 处理低频运营数据

    为什么这样做
    个人项目的数据量和写入频率可以优先换取低成本、易备份的对象存储。
    带来的影响
    无需常驻数据库,但并发写入必须显式处理 412/409 冲突。

取舍

  • 先做运营只读和状态管理,避免直接编辑 MDX 带来的内容破坏风险。
  • OSS 对象存储便于低成本部署,但并发编辑需要更严格冲突处理。
  • 控制台聚合能力优先于复杂权限,权限与审计需要后续增强。

Roadmap

  • 增加 Content 只读模块
  • 接入部署记录和健康状态
  • 补权限、审计和 Knock 运行摘要

当前限制

  • 当前不直接编辑 MDX
  • 权限与审计仍需继续增强

下一步

  • 增加 Content 只读模块
  • 接入部署记录
  • 聚合 Knock 运行摘要

继续浏览

相关入口