You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
126 lines
3.8 KiB
126 lines
3.8 KiB
7 days ago
|
# 组件复用性分析与优化计划
|
||
|
|
|
||
|
|
## 项目概述
|
||
|
|
对药品查询微信小程序进行全面的组件复用性分析与优化，建立标准化的组件体系，提升代码质量和开发效率。
|
||
|
|
|
||
|
|
## 执行步骤
|
||
|
|
|
||
|
|
### 第一阶段：组件梳理与评估（预计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小时
|
||
|
|
|
||
|
|
## 风险评估
|
||
|
|
|
||
|
|
| 风险点 | 影响 | 应对措施 |
|
||
|
|
|--------|------|----------|
|
||
|
|
| 组件耦合度高 | 提取困难 | 先解耦再提取 |
|
||
|
|
| 样式差异大 | 统一困难 | 制定样式规范 |
|
||
|
|
| 替换影响功能 | 回归测试 | 分阶段替换验证 |
|
||
|
|
|
||
|
|
## 下一步行动
|
||
|
|
|
||
|
|
等待用户确认计划后，开始第一阶段：组件梳理与评估。
|