48 lines
1.6 KiB
Markdown
48 lines
1.6 KiB
Markdown
# 通用系统管理脚手架 (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-`）
|