# 前端功能计划 — {{fe_id}} {{name}}

> 规格：docs/superpowers/specs/{{date}}-{{fe_id}}.md
> 关联原型：{{associated_prototypes}}
> 关联 REQ：{{associated_reqs}}
> 日期：{{date}}

## 一、依赖与前置条件

- 前置 FE：{{prerequisite_fes}}
- 共享组件：{{shared_components}}
- 路由配置文件：{{router_file}}

## 二、任务清单

每行一个任务，2-5 分钟可完成。`test_file::test_name` 先行写失败测试，`impl_file` 写最小实现使其通过。

| # | 任务 | 测试先行类型 | test_file::test_name | impl_file | 完成判据 |
|---|------|-------------|---------------------|-----------|---------|
{{task_rows}}

> **路径约束**：所有 `impl_file` 必须以 `frontend/`（或 docs/09 声明的前端根目录）开头。
> **测试先行类型**：`jsdom`（组件单测，vitest/jest）或 `e2e`（Playwright）。

## 三、组件 props 契约

| 组件 | props | 类型 | 必填 | 说明 |
|------|-------|------|------|------|
{{props_rows}}

## 四、状态管理

<!-- store hook 名 / 持有的 state 字段 / 暴露的 actions。如本 FE 不引入新 store，写"复用 <既有 store>"。 -->

{{state_management}}

## 五、API client 包装

| 函数名 | HTTP 方法 | 路径 | 入参 | 返回 |
|--------|----------|------|------|------|
{{api_client_rows}}

> 函数实现必须基于项目统一 API client（见 docs/04 § 一），不允许直接 `fetch` / `axios` 拼路径。

## 六、风险与回退

{{risks}}