# 通用系统管理脚手架 (sysmgr)

通用系统管理脚手架：用户/角色/资源/组织/审计/字典/日志等后台基础能力的统一管理。
单一事实源为 `openspec/specs/`；spec 约定见 `docs/spec-conventions.md`，架构见 `docs/architecture.md`。

## 技术栈

| 端 | 工程 | 栈 |
|---|---|---|
| 后端 | `sources/sysmgr-nest` | NestJS 12 · TypeScript · Vitest |
| 管理后台前端 | `sources/sysmgr-admin` | Vue 3 · Vite · TypeScript · Pinia · UnoCSS |

运行时 Node 22.23.1 · 包管理 pnpm 12.10.1。

## 三支柱

- **harness** — Claude Code（规范见 `CLAUDE.md`）
- **openspec** — 需求/变更单一事实源（`openspec/`，spec-driven）
- **superpowers** — 过程方法论（全局插件 + `.claude/skills/`）

架构详图见 `docs/architecture.md`。

## 快速开始

```bash
openspec new change <name>   # 建立变更提案
openspec validate            # 校验 spec/change
openspec list                # 列变更
openspec view                # 交互式看板
```

克隆（含子模块）：

```bash
git clone --recurse-submodules ssh://git@git.dianyunshouhu.com:2222/touyun_liuyun/System_Management.git
```

## 目录

- `CLAUDE.md` / `AGENTS.md` — 项目规范与工作流
- `openspec/` — 规范与变更
- `docs/requirements/` — 功能文档（边实现边补）
- `docs/spec-conventions.md` — spec 约定（组织/粒度/编号/模块清单）
- `docs/architecture.md` — 三支柱架构图
- `docs/superpowers/` — 设计文档 / 实施计划
- `.claude/skills/` — 项目级技能
- `sources/` — 源码（前后端 Git submodule，前缀 `sysmgr-`）