# 投云长护系统 (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 后端 | ⏳ 待启动 |
-->