377bf86076
- CLAUDE.md 精简为入口：保留铁律+约定，移除内联重复，新增文档地图 - openspec-superpowers-bridge/SKILL.md 成为工作流五步唯一权威源 - docs/architecture.md 移除重复的阶段映射表，改为引用 bridge Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
# 投云长护系统 (touyun-elderly-care)
|
||
|
||
面向老年人的养老服务与管理平台。需求与规格权威见 `docs/requirements/`（产品方案 + PRD）。
|
||
|
||
## 技术栈
|
||
|
||
待定（占位，后续在 PRD 中明确）
|
||
|
||
## 铁律（必须遵守，违反即返工）
|
||
|
||
1. **需求文档（PRD）是约束/规范的唯一权威，原型仅作视觉参考**；PRD 内部冲突以全局规范为准。
|
||
2. **数据库 schema 是字段一致性的唯一锚点**：`data-model` spec（字段字典）先行，前后端引用同一字段名，禁止各自命名。
|
||
3. **前端先行 + Mock**：前端对 Mock 验收，后端对 `api-contract` 契约实现。
|
||
4. **字段/接口变更先改 `shared/`，再改对应 spec**。
|
||
|
||
## 开发工作流
|
||
|
||
本项目用三支柱协作：**openspec** 管「要做什么」、**superpowers** 管「怎么一步步做对」、
|
||
**harness** 管「环境怎么配合」。任何功能/变更请求都按此推进。
|
||
|
||
- **怎么走流程**（分类 → 开 change → 计划 → 应用 → 归档，含 openspec↔superpowers 映射）：权威见
|
||
`.claude/skills/openspec-superpowers-bridge/SKILL.md`。
|
||
- **三支柱架构与分工**：见 `docs/architecture.md`。
|
||
- **spec 组织/粒度/编号/四段式结构**：见 `docs/spec-conventions.md`。
|
||
|
||
## 约定
|
||
|
||
- 提交信息遵循 Conventional Commits（feat/fix/chore/docs/refactor）。
|
||
- 不直接手改 `openspec/` 下由 CLI 生成的文件，优先用 `openspec` CLI。
|
||
|
||
## 文档地图
|
||
|
||
| 文档 | 内容 |
|
||
|---|---|
|
||
| `docs/spec-conventions.md` | spec 组织/粒度/编号/四段式结构（唯一权威） |
|
||
| `docs/architecture.md` | 三支柱架构图（职责/协作/技术分层/变更生命周期） |
|
||
| `.claude/skills/openspec-superpowers-bridge/SKILL.md` | 工作流五步 + openspec↔superpowers 映射（唯一权威） |
|
||
| `docs/requirements/` | 产品方案 + PRD + 原型 |
|
||
| `docs/superpowers/plans/` / `specs/` | 实施计划 / 设计文档 |
|
||
|
||
## 当前进度
|
||
|
||
<!-- 进度表：随开发更新，示例格式见下 -->
|
||
<!--
|
||
| 层/端 | 状态 |
|
||
|---|---|
|
||
| SH 三层 spec（platform / data-model / api-contract） | ⏳ 待启动 |
|
||
| FE 前端 | ⏳ 待启动 |
|
||
| BE 后端 | ⏳ 待启动 |
|
||
-->
|