# 通用系统管理脚手架 (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 后端 | ✅ 完成 |