52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# 通用系统管理脚手架 (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`。
|
||
|
||
**任何功能/变更请求，按以下流程推进：**
|
||
|
||
1. 用 `superpowers:brainstorming` 将请求分类为 spike / bounded / architectural。
|
||
2. architectural 工作 → 走 `/opsx:propose`（proposal → specs → design → tasks）。
|
||
3. 用 `superpowers:writing-plans` 生成实施计划（存 `docs/superpowers/plans/`）。
|
||
4. 执行期遵循 superpowers 过程技能：TDD、systematic-debugging、
|
||
requesting-code-review、verification-before-completion，并按 `/opsx:apply` 落地任务。
|
||
5. 完成并归档：`/opsx:archive` 更新主 spec。
|
||
|
||
**分工口诀**：openspec 管「要做什么」，superpowers 管「怎么一步步做对」，
|
||
harness 管「环境怎么配合」。
|
||
|
||
## Spec 约定（新会话必须遵守）
|
||
|
||
spec 的**组织 / 粒度 / 编号 / 铁律 / 模块清单 / 设计决策**唯一权威见
|
||
`docs/spec-conventions.md`，新会话与每个 change 必须遵守，此处不重复。
|
||
|
||
## 约定
|
||
|
||
- 提交信息遵循 Conventional Commits（feat/fix/chore/docs/refactor）。
|
||
- 不直接手改 `openspec/` 下手动生成的文件，优先用 `openspec` CLI。
|
||
|
||
## 当前进度
|
||
|
||
| 项 | 状态 |
|
||
|---|---|
|
||
| 前后端工程脚手架 + Git submodule | ✅ 完成 |
|
||
| SH 三层 spec（platform / data-model / api-contract） | ✅ 完成 |
|
||
| FE 管理后台 | ✅ 完成 |
|
||
| BE 后端 | ✅ 完成 |
|