# feature 业务功能方案

`feature` 目录用于按业务功能组织产品方案。这里关注“一个功能如何从入口走到完成”，不是单个页面长什么样。

## 功能目录结构

每个业务功能只保留两个文件：

```text
feature/<feature-name>/
├── index.html
└── description.md
```

不要默认增加 `states.md`、`api.md`、`copy.md`、`changelog.md` 或决策记录。重要状态、规则、文案和数据说明统一写进 `description.md`。

## index.html

`index.html` 是功能流程展示页，建议包含：

```text
功能简介
用户流程
页面原型 iframe
关键说明
详细描述入口
```

iframe 可以引用 `web` 下的主页面和状态页面，例如：

```text
../../web/app/me.html
../../web/app/credits-detail.html
../../web/app/buy-credits.html
```

## description.md

`description.md` 是详细产品描述，建议包含：

```text
# 功能名称

## 功能目标

## 使用入口

## 主流程

## 页面与状态

## 关键规则

## 补充说明
```

内容保持简洁，但需要覆盖团队理解和研发落地所需的关键点。

## 命名建议

功能目录使用英文短横线：

```text
ai-chat
credits
subscription
invite
system-task
onboarding
model-switch
data-contribution
quick-review
collection-task
```