# web 页面交互稿

`web` 目录用于存放页面级交互稿。这里的页面关注“页面长什么样、怎么点、不同状态如何展示”。

## 平台目录

```text
web/
├── app/         # App 或 H5 页面
├── agent_web/   # Web Agent 平台页面
└── task_web/    # Web Task 平台页面
```

## 页面组织

页面先按平台归类。后续页面变多时，在平台目录下按模块继续拆分：

```text
web/app/chat/
web/app/credits/
web/app/subscription/
```

当前已有的扁平页面可以继续保留，不需要为了目录规范立即迁移。

## 多状态页面

如果一个页面存在关键状态，建议创建独立页面展示：

```text
chat.html
chat-empty.html
chat-loading.html
chat-error.html
credits-detail.html
credits-empty.html
```

如果已经使用模块目录，也可以这样组织：

```text
web/app/chat/index.html
web/app/chat/empty.html
web/app/chat/loading.html
web/app/chat/error.html
```

这些状态页面可以被 `feature` 目录中的 iframe 直接引用，用来组成完整业务流程。

## 维护要求

- 页面保持最新，不添加草稿、评审中、已确认等状态标签。
- 页面说明保持简短，重点写入口、用途和关键状态。
- 不在 `web` 下写业务功能 PRD；业务流程放到 `feature`。