# React / Next Baseline

## 目标

- 统一 React / Next 项目的默认工程落点，减少“同仓库多种写法并存”的治理成本。

## 默认原则

- 服务端优先：能在服务端准备的数据不要默认丢给浏览器。
- 客户端最小化：只有需要浏览器事件、即时交互或本地状态的区域才进入 client 组件。
- 页面编排和通用组件分离：路由层负责组织，组件层负责呈现与交互。
- 状态分层明确：服务端数据、UI 状态、表单状态、派生状态不要混放。

## 推荐结构

- 页面或路由文件：负责组合、参数读取、权限和数据入口。
- Section / Feature 组件：负责一组相关交互或业务区块。
- Base 组件：负责通用视觉与交互基元。
- Hooks / Services：负责复用逻辑、请求适配、复杂交互状态。

## 交付要求

- 每个页面都必须定义 loading、empty、error、success 的表现。
- 关键组件应说明是否沿用现有 token、是否新增交互模式、是否会影响响应式。