zhjwxt/开发任务分配和质量控制.md

Word合同模板系统开发任务分配和质量控制

🎯 项目管理者严格质量要求

核心质量原则

1. 数据一致性第一：页面显示数据与数据库数据必须100%一致
2. 功能完整性第一：每个功能都要完整实现，不允许半成品
3. 用户体验第一：每个交互都要符合预期，不允许异常
4. 代码质量第一：不合格代码绝不允许合并

📋 详细任务分配

🔧 后端开发任务（PHP开发者）

第一阶段：数据库和基础架构（3天）

严格验收标准：

• 数据库表结构100%正确，字段类型、长度、索引完整
• 模型类关联关系正确，查询结果与预期完全一致
• 基础API框架搭建完成，路由配置正确

具体任务：

1. 创建数据库表

   -- 必须严格按照设计创建以下表
   CREATE TABLE `school_document_data_source_config` (...)
   CREATE TABLE `school_document_generate_log` (...)
   -- 为现有表添加必要字段
   ALTER TABLE `school_contract_sign` ADD COLUMN `signature_image` varchar(500) DEFAULT NULL COMMENT '签名图片路径';
   

2. 创建模型类

   // app/model/document/DocumentDataSourceConfig.php
   // app/model/document/DocumentGenerateLog.php
   // 每个模型必须有完整的关联关系和搜索器
   

3. 基础服务类框架

   // app/service/admin/document/DocumentTemplateService.php
   // app/service/admin/contract/ContractDistributionService.php
   // app/service/api/contract/ContractService.php
   

质量检查项：

• 数据库表创建成功，字段完整
• 模型类查询结果正确
• 服务类基础方法可正常调用

第二阶段：Word模板处理（4天）

严格验收标准：

• Word文档上传功能完整，支持.docx格式
• 占位符解析100%准确，不能遗漏任何占位符
• 数据源配置功能完整，支持各种字段类型
• 模板预览功能正常，显示内容与实际模板一致

具体任务：

1. Word文档处理服务

   class DocumentTemplateService {
       // 上传Word模板
       public function uploadTemplate(array $data): array
       // 解析占位符
       public function parsePlaceholders(string $filePath): array
       // 配置数据源
       public function configDataSource(int $contractId, array $config): bool
       // 预览模板
       public function previewTemplate(int $contractId): array
   }
   

2. 文件存储集成

   • 腾讯云存储上传
   • 文件路径管理
   • 安全验证

质量检查项：

• 上传的Word文件能正确存储到腾讯云
• 占位符解析结果与手动检查结果一致
• 数据源配置能正确保存到数据库
• 模板预览显示正确的占位符信息

第三阶段：合同分发系统（3天）

严格验收标准：

• 手动分发功能完整，支持批量分发
• 自动分发事件监听器正常工作
• 分发记录完整保存，状态更新正确
• 与支付系统集成无异常

具体任务：

1. 合同分发服务

   class ContractDistributionService {
       // 手动分发合同
       public function manualDistribute(int $contractId, array $personnelIds): bool
       // 自动分发合同（课程购买触发）
       public function autoDistribute(array $orderData): bool
       // 获取分发记录
       public function getDistributionRecords(array $params): array
   }
   

2. 事件监听器

   class ContractDistributionListener {
       public function handle(array $params): void
   }
   

质量检查项：

• 手动分发后数据库记录正确
• 课程购买后自动分发正常触发
• 分发状态更新正确
• 分发记录查询结果准确

第四阶段：文档生成系统（4天）

严格验收标准：

• 队列任务处理正常，支持异步生成
• Word文档生成100%正确，占位符全部替换
• 生成状态跟踪准确，错误信息详细
• 文件下载功能正常

具体任务：

1. 文档生成Job

   class DocumentGenerateJob extends BaseJob {
       public function doJob(array $data): bool
   }
   

2. 文档生成服务

   class DocumentGenerateService {
       // 生成Word文档
       public function generateDocument(int $contractSignId): bool
       // 获取生成状态
       public function getGenerateStatus(int $logId): array
       // 下载生成的文档
       public function downloadDocument(int $logId): array
   }
   

质量检查项：

• 队列任务能正常执行
• 生成的Word文档占位符全部正确替换
• 生成状态实时更新
• 文件下载链接有效

🎨 前端管理界面任务（Vue3开发者）

第一阶段：基础框架（2天）

严格验收标准：

• 页面路由配置正确，所有页面可正常访问
• API请求封装完整，错误处理机制完善
• 基础布局组件符合设计规范

具体任务：

1. 路由配置

   // 合同模板管理路由
   // 合同分发管理路由
   // 生成记录管理路由
   

2. API封装

   // api/contract.js
   export const contractApi = {
       uploadTemplate,
       getTemplateList,
       configDataSource,
       distributeContract,
       getGenerateLog
   }
   

质量检查项：

• 所有路由可正常访问
• API请求返回数据格式正确
• 错误处理提示用户友好

第二阶段：模板管理界面（4天）

严格验收标准：

• 模板列表显示数据与数据库完全一致
• 模板上传功能完整，进度提示正确
• 占位符配置界面操作流畅，数据保存正确
• 模板预览功能正常，显示内容准确

具体任务：

1. 模板列表页面

   <template>
     <!-- 模板列表表格 -->
     <!-- 搜索筛选功能 -->
     <!-- 操作按钮 -->
   </template>
   

2. 模板上传组件

   <template>
     <!-- 文件上传组件 -->
     <!-- 上传进度显示 -->
     <!-- 上传结果反馈 -->
   </template>
   

3. 占位符配置组件

   <template>
     <!-- 占位符列表 -->
     <!-- 数据源配置表单 -->
     <!-- 配置保存确认 -->
   </template>
   

质量检查项：

• 模板列表数据与数据库一致
• 上传功能正常，文件正确保存
• 占位符配置保存成功
• 预览功能显示正确

第三阶段：合同管理界面（3天）

严格验收标准：

• 合同分发界面操作简单明了
• 分发记录列表数据准确
• 生成状态监控实时更新

具体任务：

1. 合同分发组件
2. 分发记录组件
3. 生成状态监控组件

质量检查项：

• 分发操作成功，数据库记录正确
• 分发记录显示准确
• 生成状态实时更新

📱 UniApp小程序任务（UniApp开发者）

第一阶段：基础页面（3天）

严格验收标准：

• 严格保持暗黑主题，颜色不允许偏差
• 合同列表数据与数据库完全一致
• 用户身份验证正确

具体任务：

1. 合同列表页面

   <template>
     <view class="contract-list" style="background-color: #181A20;">
       <!-- 严格按照暗黑主题设计 -->
     </view>
   </template>
   

2. 合同详情页面

3. 用户身份验证

质量检查项：

• 页面主题颜色严格符合规范
• 合同列表数据正确
• 用户身份验证正常

第二阶段：数据收集功能（4天）

严格验收标准：

• 动态表单生成正确，字段类型匹配
• 数据验证完整，提交成功
• 手写签名组件正常工作
• 离线状态处理完善

具体任务：

1. 动态表单组件
2. 手写签名组件
3. 数据提交处理

质量检查项：

• 表单字段与配置一致
• 数据验证规则正确
• 签名功能正常
• 数据提交成功

🔍 严格的质量控制流程

每日质量检查

1. 代码审查：每行代码都要检查
2. 功能测试：每个功能都要测试
3. 数据验证：页面数据与数据库数据对比
4. 性能监控：API响应时间和页面加载速度

阶段验收标准

• 功能完整性：100%实现，无异常
• 数据一致性：前后端数据完全一致
• 用户体验：操作流畅，符合预期
• 代码质量：规范、安全、高效

不合格处理

• 立即回退不合格代码
• 要求重新开发，不允许修补
• 详细问题分析报告
• 重新走完整审查流程

---

项目管理者承诺：严格把控每个环节，确保交付高质量的产品！