2.1 KiB
2.1 KiB
通用系统管理脚手架 (sysmgr)
通用系统管理脚手架：用户/角色/资源/组织/审计/字典/日志等后台基础能力的统一管理。
单一事实源 = openspec/specs/；spec 约定见 docs/spec-conventions.md，三支柱架构见 docs/architecture.md。
技术栈
- 后端：NestJS 12（
sources/sysmgr-nest） - 管理后台前端：Vue 3（
sources/sysmgr-admin） - 运行时 Node 22.23.1 · 包管理 pnpm 12.10.1
开发工作流（三支柱编排）
| 支柱 | 定位 | 载体 |
|---|---|---|
| harness (Claude Code) | 执行环境：规范、权限 | 本文件、.claude/settings.json |
| openspec | 需求与变更单一事实源 | openspec/（spec-driven） |
| superpowers | 过程方法论驱动 | 全局插件 + .claude/skills/ |
架构图与协作分工详见 docs/architecture.md。
任何功能/变更请求，按以下流程推进：
- 用
superpowers:brainstorming将请求分类为 spike / bounded / architectural。 - architectural 工作 → 走
/opsx:propose（proposal → specs → design → tasks）。 - 用
superpowers:writing-plans生成实施计划（存docs/superpowers/plans/）。 - 执行期遵循 superpowers 过程技能：TDD、systematic-debugging、
requesting-code-review、verification-before-completion，并按
/opsx:apply落地任务。 - 完成并归档：
/opsx:archive更新主 spec。
分工口诀：openspec 管「要做什么」，superpowers 管「怎么一步步做对」， harness 管「环境怎么配合」。
Spec 约定（新会话必须遵守）
spec 的组织 / 粒度 / 编号 / 铁律 / 模块清单 / 设计决策唯一权威见
docs/spec-conventions.md，新会话与每个 change 必须遵守，此处不重复。
约定
- 提交信息遵循 Conventional Commits（feat/fix/chore/docs/refactor）。
- 不直接手改
openspec/下手动生成的文件，优先用openspecCLI。
当前进度
| 项 | 状态 |
|---|---|
| 前后端工程脚手架 + Git submodule | ✅ 完成 |
| SH 三层 spec（platform / data-model / api-contract） | ✅ 完成 |
| FE 管理后台 | ✅ 完成 |
| BE 后端 | ✅ 完成 |