8 changed files with 292 additions and 124 deletions
@ -0,0 +1,125 @@
@@ -0,0 +1,125 @@
|
||||
# 组件复用性分析与优化计划 |
||||
|
||||
## 项目概述 |
||||
对药品查询微信小程序进行全面的组件复用性分析与优化,建立标准化的组件体系,提升代码质量和开发效率。 |
||||
|
||||
## 执行步骤 |
||||
|
||||
### 第一阶段:组件梳理与评估(预计2-3小时) |
||||
|
||||
#### 1.1 组件盘点 |
||||
- [ ] 扫描项目所有页面和组件目录 |
||||
- [ ] 识别所有自定义组件(components目录) |
||||
- [ ] 识别页面内重复使用的UI片段 |
||||
- [ ] 识别可复用的业务逻辑模块 |
||||
|
||||
#### 1.2 复用价值评估 |
||||
建立评估矩阵,从以下维度评估: |
||||
- 使用频率(≥3次为高频) |
||||
- 功能独立性(是否耦合业务逻辑) |
||||
- 通用性(跨页面/跨业务可用性) |
||||
- 复杂度(提取难度) |
||||
|
||||
### 第二阶段:公共控件提取(预计4-6小时) |
||||
|
||||
#### 2.1 基础组件提取 |
||||
- [ ] **导航栏组件(navbar)** - 已存在,评估优化空间 |
||||
- [ ] **分页组件(pagination)** - 已存在,评估使用一致性 |
||||
- [ ] **弹窗组件(popup)** - 已存在,评估功能扩展 |
||||
- [ ] **标签栏组件(doctor-tab-bar/ground-tab-bar)** - 评估合并可能性 |
||||
|
||||
#### 2.2 业务组件提取 |
||||
- [ ] **项目选择器** - 地推端/药店端/患者端均有项目切换功能 |
||||
- [ ] **日期选择器** - 多处使用日期范围选择 |
||||
- [ ] **状态标签** - 审核状态、跳转状态等标签展示 |
||||
- [ ] **患者卡片** - 患者列表卡片展示 |
||||
- [ ] **统计卡片** - 首页统计数据展示卡片 |
||||
|
||||
#### 2.3 复合组件提取 |
||||
- [ ] **上传材料弹窗** - popup + 上传功能的复合组件 |
||||
- [ ] **筛选栏组件** - 搜索+筛选条件的组合 |
||||
|
||||
### 第三阶段:组件体系构建(预计2-3小时) |
||||
|
||||
#### 3.1 目录结构规划 |
||||
``` |
||||
src/ |
||||
├── components/ |
||||
│ ├── base/ # 基础组件 |
||||
│ │ ├── navbar/ |
||||
│ │ ├── pagination/ |
||||
│ │ └── popup/ |
||||
│ ├── business/ # 业务组件 |
||||
│ │ ├── project-picker/ |
||||
│ │ ├── date-picker/ |
||||
│ │ ├── status-tag/ |
||||
│ │ └── patient-card/ |
||||
│ └── composite/ # 复合组件 |
||||
│ ├── upload-material/ |
||||
│ └── filter-bar/ |
||||
``` |
||||
|
||||
#### 3.2 命名规范制定 |
||||
- 基础组件:小写短横线命名 |
||||
- 业务组件:业务前缀+功能命名 |
||||
- 复合组件:功能组合命名 |
||||
|
||||
### 第四阶段:组件文档编写(预计3-4小时) |
||||
|
||||
为每个提取的组件编写: |
||||
- 功能描述 |
||||
- 使用场景 |
||||
- 参数列表(类型、默认值、必填、说明) |
||||
- 使用示例 |
||||
- 事件回调说明 |
||||
- 注意事项 |
||||
|
||||
### 第五阶段:代码替换实施(预计6-8小时) |
||||
|
||||
#### 5.1 组件替换 |
||||
- [ ] 替换地推端首页项目选择器 |
||||
- [ ] 替换药店端首页项目选择器 |
||||
- [ ] 替换患者端首页项目选择器 |
||||
- [ ] 替换患者列表日期筛选 |
||||
- [ ] 替换统计页面日期筛选 |
||||
- [ ] 替换审核状态标签 |
||||
- [ ] 替换患者卡片 |
||||
|
||||
#### 5.2 验证测试 |
||||
- [ ] 功能完整性测试 |
||||
- [ ] 样式一致性测试 |
||||
- [ ] 交互逻辑测试 |
||||
|
||||
### 第六阶段:成果交付(预计2小时) |
||||
|
||||
#### 6.1 文档输出 |
||||
- [ ] 组件复用性分析报告 |
||||
- [ ] 组件库目录结构说明 |
||||
- [ ] 组件使用文档 |
||||
- [ ] 代码替换实施指南 |
||||
|
||||
#### 6.2 代码审查 |
||||
- [ ] 组件代码质量检查 |
||||
- [ ] 引用替换完整性检查 |
||||
|
||||
## 预期成果 |
||||
|
||||
1. **组件库目录**:标准化的组件分类体系 |
||||
2. **公共组件**:提取5-8个高频复用组件 |
||||
3. **技术文档**:完整的组件使用文档 |
||||
4. **代码优化**:减少重复代码30%以上 |
||||
|
||||
## 时间预估 |
||||
总计:约19-26小时 |
||||
|
||||
## 风险评估 |
||||
|
||||
| 风险点 | 影响 | 应对措施 | |
||||
|--------|------|----------| |
||||
| 组件耦合度高 | 提取困难 | 先解耦再提取 | |
||||
| 样式差异大 | 统一困难 | 制定样式规范 | |
||||
| 替换影响功能 | 回归测试 | 分阶段替换验证 | |
||||
|
||||
## 下一步行动 |
||||
|
||||
等待用户确认计划后,开始第一阶段:组件梳理与评估。 |
||||
File diff suppressed because one or more lines are too long
Loading…
Reference in new issue