const { Document, Packer, Paragraph, TextRun, Table, TableRow, TableCell, Header, Footer, AlignmentType, PageOrientation, LevelFormat, HeadingLevel, BorderStyle, WidthType, ShadingType, VerticalAlign, PageNumber, PageBreak } = require('docx'); const fs = require('fs'); const path = require('path'); const OUTPUT_DIR = path.join(__dirname, '..', 'documents'); if (!fs.existsSync(OUTPUT_DIR)) { fs.mkdirSync(OUTPUT_DIR, { recursive: true }); } const PAGE_WIDTH = 11906; const PAGE_HEIGHT = 16838; const MARGIN = 1440; const CONTENT_WIDTH = PAGE_WIDTH - MARGIN * 2; const border = { style: BorderStyle.SINGLE, size: 1, color: 'CCCCCC' }; const borders = { top: border, bottom: border, left: border, right: border }; const commonStyles = { default: { document: { run: { font: 'Arial', size: 24 } } }, paragraphStyles: [ { id: 'Heading1', name: 'Heading 1', basedOn: 'Normal', next: 'Normal', quickFormat: true, run: { size: 32, bold: true, font: 'Arial', color: '1F4E79' }, paragraph: { spacing: { before: 360, after: 240 }, outlineLevel: 0 } }, { id: 'Heading2', name: 'Heading 2', basedOn: 'Normal', next: 'Normal', quickFormat: true, run: { size: 28, bold: true, font: 'Arial', color: '2E75B6' }, paragraph: { spacing: { before: 280, after: 160 }, outlineLevel: 1 } }, { id: 'Heading3', name: 'Heading 3', basedOn: 'Normal', next: 'Normal', quickFormat: true, run: { size: 26, bold: true, font: 'Arial' }, paragraph: { spacing: { before: 200, after: 120 }, outlineLevel: 2 } } ] }; function createHeader(title) { return new Header({ children: [ new Paragraph({ children: [ new TextRun({ text: '清道夫系统 - ', size: 18, color: '666666' }), new TextRun({ text: title, size: 18, color: '666666' }) ], alignment: AlignmentType.RIGHT }) ] }); } function createFooter() { return new Footer({ children: [ new Paragraph({ children: [ new TextRun({ text: '第 ', size: 18, color: '666666' }), new TextRun({ children: [PageNumber.CURRENT], size: 18, color: '666666' }), new TextRun({ text: ' 页', size: 18, color: '666666' }) ], alignment: AlignmentType.CENTER }) ] }); } function coverPage(title, subtitle) { return [ new Paragraph({ spacing: { before: 2400 }, children: [] }), new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun({ text: '清道夫系统', size: 56, bold: true, color: '1F4E79', font: 'Arial' })] }), new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 400 }, children: [new TextRun({ text: '环境服务管理平台', size: 32, color: '2E75B6', font: 'Arial' })] }), new Paragraph({ spacing: { before: 1200 }, children: [] }), new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun({ text: title, size: 44, bold: true, color: '1F4E79', font: 'Arial' })] }), new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 200 }, children: [new TextRun({ text: subtitle, size: 28, color: '666666', font: 'Arial' })] }), new Paragraph({ spacing: { before: 2400 }, children: [] }), new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun({ text: '版本号:V1.0.0', size: 24, font: 'Arial' })] }), new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 160 }, children: [new TextRun({ text: '编制日期:2026-07-02', size: 24, font: 'Arial' })] }), new Paragraph({ alignment: AlignmentType.CENTER, spacing: { before: 160 }, children: [new TextRun({ text: '编制单位:项目开发团队', size: 24, font: 'Arial' })] }), new Paragraph({ children: [new PageBreak()] }) ]; } function tocPage() { return [ new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun('目录')] }), new Paragraph({ spacing: { before: 200 }, children: [new TextRun({ text: '请使用 Word 的“引用”->“目录”功能自动生成目录,或手动查看本文档的标题结构。', color: '666666', size: 22 })] }), new Paragraph({ children: [new PageBreak()] }) ]; } function h1(text) { return new Paragraph({ heading: HeadingLevel.HEADING_1, children: [new TextRun(text)] }); } function h2(text) { return new Paragraph({ heading: HeadingLevel.HEADING_2, children: [new TextRun(text)] }); } function h3(text) { return new Paragraph({ heading: HeadingLevel.HEADING_3, children: [new TextRun(text)] }); } function p(text, opts = {}) { return new Paragraph({ spacing: { before: 120, after: 120, line: 360 }, children: [new TextRun({ text, size: 24, ...opts })] }); } function createTable(headers, rows, colWidths) { const totalWidth = colWidths.reduce((a, b) => a + b, 0); const headerCells = headers.map((h, i) => new TableCell({ borders, width: { size: colWidths[i], type: WidthType.DXA }, shading: { fill: 'D5E8F0', type: ShadingType.CLEAR }, margins: { top: 80, bottom: 80, left: 120, right: 120 }, verticalAlign: VerticalAlign.CENTER, children: [new Paragraph({ alignment: AlignmentType.CENTER, children: [new TextRun({ text: h, bold: true, size: 22 })] })] })); const dataRows = rows.map(row => new TableRow({ children: row.map((cell, i) => new TableCell({ borders, width: { size: colWidths[i], type: WidthType.DXA }, margins: { top: 60, bottom: 60, left: 120, right: 120 }, children: [new Paragraph({ children: [new TextRun({ text: String(cell), size: 22 })] })] })) })); return new Table({ width: { size: totalWidth, type: WidthType.DXA }, columnWidths: colWidths, rows: [new TableRow({ children: headerCells }), ...dataRows] }); } function generateDoc(title, subtitle, children) { return new Document({ styles: commonStyles, sections: [{ properties: { page: { size: { width: PAGE_WIDTH, height: PAGE_HEIGHT }, margin: { top: MARGIN, right: MARGIN, bottom: MARGIN, left: MARGIN } } }, headers: { default: createHeader(title) }, footers: { default: createFooter() }, children: [...coverPage(title, subtitle), ...tocPage(), ...children] }] }); } async function saveDoc(doc, filename) { const buffer = await Packer.toBuffer(doc); const filePath = path.join(OUTPUT_DIR, filename); fs.writeFileSync(filePath, buffer); console.log(`Generated: ${filePath}`); } // ================= Documents ================= function docRequirement() { return generateDoc('产品需求规格说明书', 'Product Requirement Specification', [ h1('一、项目概述'), p('清道夫系统是一款面向环境服务行业的综合管理平台,通过移动端微信小程序实现销售、调度、施工三类角色的协同作业。系统覆盖项目签约、任务发布、排班调度、现场施工、验收签字、数据统计等全流程业务。'), p('本文档基于当前项目实际实现情况编制,明确系统功能边界、用户角色及核心业务流程,为客户及合作方提供完整的需求交付依据。'), h1('二、用户角色与权限'), createTable(['角色', '后端标识', '主要职责'], [ ['销售端', 'front / sales', '项目录入、客户管理、任务发布、消息通知查看'], ['调度端', 'dispatch', '任务审核、排班管理、车辆人员调配、可视化监控'], ['施工端', 'construction', '每日任务执行、出车到场、施工验收、历史任务查看'] ], [2000, 2500, 5460]), h1('三、功能需求'), h2('3.1 销售端功能'), p('销售端面向一线业务人员,提供项目库管理、任务跟进、消息提醒、知识库查询等功能。核心页面包括首页统计看板、我的任务、项目库、新增项目、项目详情、发布任务、任务详情、消息通知、帮助中心等。'), h2('3.2 调度端功能'), p('调度端面向运营管理人员,负责任务审核、资源排班、车辆人员状态监控。核心页面包括调度首页、排班管理、任务管理、人员列表、车辆列表、在岗人员、可用车辆、应急班组、数据可视化大屏等。'), h2('3.3 施工端功能'), p('施工端面向现场作业人员,支持按 SOP 流程执行任务:出车→到场→勘验→施工→验收。核心页面包括施工首页、每日任务、我的任务、任务详情、历史任务、明日任务、通知公告等。'), h1('四、非功能需求'), createTable(['类别', '要求'], [ ['性能', '列表页支持分页加载,图片懒加载,避免复杂表达式渲染'], ['兼容性', '适配微信小程序环境,使用 uni-app 跨端框架,H5 与小程序共用一套代码'], ['安全性', '接口使用 Bearer Token 认证,登录态过期自动跳转登录页'], ['可维护性', '采用 Vue3 + TypeScript + Pinia 构建,组件化、类型化开发'] ], [2500, 7460]), h1('五、页面清单'), p('系统原型共规划 54 个页面,当前已实现全部 54 个页面,覆盖登录模块、销售端(21页)、调度端(19页)、施工端(13页)。') ]); } function docArchitecture() { return generateDoc('系统架构设计说明书', 'System Architecture Design', [ h1('一、总体架构'), p('清道夫系统采用前后端分离架构,前端基于 uni-app 跨端框架开发微信小程序,后端通过 RESTful API 提供服务。系统支持销售端、调度端、施工端三类角色,按业务模块划分为多个小程序分包,实现按需加载。'), h1('二、技术栈'), createTable(['层级', '技术选型', '说明'], [ ['前端框架', 'uni-app + Vue 3', '跨端开发,一套代码输出微信小程序与 H5'], ['构建工具', 'Vite', '快速构建与热更新'], ['开发语言', 'TypeScript', '类型安全,提升可维护性'], ['状态管理', 'Pinia', 'Vue 官方推荐状态管理方案'], ['样式方案', 'Tailwind CSS + SCSS', '原子化样式与主题变量'], ['UI 组件', 'uni-ui + 自定义组件', '小程序风格组件库'], ['后端接口', 'RESTful API', 'Base URL: http://localhost:8080/api'] ], [2000, 3500, 4460]), h1('三、前端架构'), h2('3.1 目录结构'), p('项目源码位于 src 目录下,按职责划分为 api、components、composables、pages、stores、types、utils 等模块。api 目录封装后端接口,stores 目录使用 Pinia 管理全局状态,components 目录按 common、home、task、project 等维度组织。'), h2('3.2 分包设计'), p('小程序采用分包加载策略,主包包含首页、任务、排班、我的等 Tab 页面;subPackages 下划分为 pages-common(通用页面)、pages-sales(销售端)、pages-dispatch(调度端)、pages-construction(施工端)四个分包,降低主包体积,提升启动速度。'), h2('3.3 自定义组件'), p('系统封装了 ImageUploader(图片上传)、MapView(地图展示)、SignaturePad(电子签名)、ChartView(Canvas 图表)等高级组件,集成于任务详情、可视化大屏等页面。'), h1('四、状态管理'), p('使用 Pinia 定义 auth、project、task、schedule、vehicle、personnel、notification 等 Store,分别管理用户认证、项目数据、任务状态、排班信息、车辆人员、消息通知等核心业务状态。'), h1('五、安全设计'), p('前端通过 request.ts 统一封装 HTTP 请求,自动注入 Authorization: Bearer {token} 请求头。当接口返回 401 状态时,清除本地 token 并跳转登录页,确保会话安全。') ]); } function docApi() { return generateDoc('接口设计文档', 'API Design Document', [ h1('一、接口规范'), p('后端接口统一采用 RESTful 风格,Base URL 为 http://localhost:8080/api。请求与响应数据格式为 JSON,认证方式采用 Bearer Token。统一响应结构为:{ code, msg, data, timestamp }。'), h1('二、认证接口'), createTable(['接口', '方法', '说明'], [ ['/auth/login', 'POST', '账号密码登录,返回 token 及用户信息'], ['/auth/logout', 'POST', '用户登出'], ['/auth/reset-password', 'POST', '重置密码'], ['/auth/init-data', 'POST', '初始化数据'] ], [3500, 1500, 4960]), h1('三、项目接口'), createTable(['接口', '方法', '说明'], [ ['/project/list', 'GET', '分页获取项目列表'], ['/project/{id}', 'GET', '获取项目详情'], ['/project', 'POST', '新增项目'], ['/project', 'PUT', '更新项目信息'], ['/project/{id}', 'DELETE', '删除项目'] ], [3500, 1500, 4960]), h1('四、任务接口'), createTable(['接口', '方法', '说明'], [ ['/task/list', 'GET', '分页获取任务列表'], ['/task/{id}', 'GET', '获取任务详情'], ['/task', 'POST', '创建任务'], ['/task', 'PUT', '更新任务'], ['/task/{id}', 'DELETE', '删除任务'], ['/task/{id}/step/{step}', 'POST', '推进任务流程节点'], ['/task/{id}/urge', 'POST', '任务催单'], ['/task/{id}/cancel', 'POST', '取消任务'], ['/task/{id}/logs', 'GET', '获取任务操作日志'] ], [4000, 1500, 4460]), h1('五、排班与资源接口'), createTable(['接口', '方法', '说明'], [ ['/schedule/list', 'GET', '按年月获取排班列表'], ['/schedule/date/{date}', 'GET', '按日期获取排班'], ['/schedule/{id}', 'GET', '获取排班详情'], ['/schedule', 'POST', '创建排班'], ['/schedule/{id}', 'PUT', '更新排班'], ['/vehicle/list', 'GET', '车辆列表'], ['/staff/list', 'GET', '人员列表'], ['/staff/on-duty', 'GET', '在岗人员'], ['/staff/emergency-team', 'GET', '应急班组'] ], [4000, 1500, 4460]), h1('六、统计看板接口'), createTable(['接口', '方法', '说明'], [ ['/dashboard/stats', 'GET', '首页核心统计数据'], ['/dashboard/task-overview', 'GET', '任务概览'], ['/dashboard/vehicle-status', 'GET', '车辆状态统计'], ['/dashboard/personnel-status', 'GET', '人员状态统计'], ['/dashboard/emergency-status', 'GET', '应急状态统计'] ], [4000, 1500, 4460]) ]); } function docDatabase() { return generateDoc('数据库设计说明书', 'Database Design Document', [ h1('一、设计原则'), p('数据库设计遵循业务实体清晰、字段命名规范、关系合理的原则。核心实体包括用户、项目、任务、排班、车辆、人员、通知、知识库等,通过外键或业务 ID 建立关联。'), h1('二、核心数据表'), h2('2.1 用户表(sys_user)'), createTable(['字段', '类型', '说明'], [ ['user_id', 'BIGINT', '主键,用户唯一标识'], ['user_name', 'VARCHAR', '登录账号'], ['nick_name', 'VARCHAR', '用户昵称'], ['password', 'VARCHAR', '加密密码'], ['role_type', 'VARCHAR', '角色:front/dispatch/construction'], ['phonenumber', 'VARCHAR', '手机号'], ['email', 'VARCHAR', '邮箱'], ['avatar', 'VARCHAR', '头像 URL'], ['dept_id', 'BIGINT', '部门 ID'], ['status', 'CHAR', '状态:0 禁用 1 启用'] ], [2500, 2000, 5460]), h2('2.2 项目表(project)'), createTable(['字段', '类型', '说明'], [ ['project_id', 'BIGINT', '主键'], ['project_name', 'VARCHAR', '项目名称'], ['project_type', 'VARCHAR', '项目类型:包年/单次/季度/月付'], ['customer_name', 'VARCHAR', '客户名称'], ['customer_phone', 'VARCHAR', '客户电话'], ['address', 'VARCHAR', '项目地址'], ['status', 'VARCHAR', '项目状态'], ['contract_amount', 'DECIMAL', '合同金额'], ['create_time', 'DATETIME', '创建时间'] ], [2500, 2000, 5460]), h2('2.3 任务表(task)'), createTable(['字段', '类型', '说明'], [ ['task_id', 'BIGINT', '主键'], ['project_id', 'BIGINT', '关联项目'], ['task_type', 'VARCHAR', 'regular / emergency'], ['urgent', 'VARCHAR', 'high / normal'], ['status', 'VARCHAR', '任务状态'], ['staff_id', 'BIGINT', '指派施工人员'], ['vehicle_id', 'BIGINT', '指派车辆'], ['schedule_date', 'DATE', '计划服务日期'], ['create_time', 'DATETIME', '创建时间'] ], [2500, 2000, 5460]), h2('2.4 排班表(schedule)'), createTable(['字段', '类型', '说明'], [ ['schedule_id', 'BIGINT', '主键'], ['team_id', 'BIGINT', '班组 ID'], ['work_date', 'DATE', '工作日期'], ['shift_type', 'VARCHAR', 'month_plan / emergency'], ['vehicle_ids', 'VARCHAR', '车辆 ID 集合'], ['staff_ids', 'VARCHAR', '人员 ID 集合'], ['status', 'VARCHAR', '排班状态'], ['remark', 'VARCHAR', '备注'] ], [2500, 2000, 5460]), h1('三、表关系说明'), p('项目与任务为一对多关系;任务与排班为一对多关系;任务与车辆、人员为多对一关系;用户按角色区分销售、调度、施工三类权限;通知、知识库为独立业务表。') ]); } function docProgress() { return generateDoc('项目进度周报', 'Project Weekly Progress Report', [ h1('一、报告概览'), createTable(['属性', '内容'], [ ['项目', '清道夫系统 - 环境服务管理平台'], ['报告周期', '2026-06-23 至 2026-07-02'], ['报告日期', '2026-07-02'], ['当前阶段', '开发收尾 / 文档整理 / 验收准备'], ['总体进度', '约 95%'] ], [2500, 7460]), h1('二、本周完成工作'), p('本周主要完成系统重构收尾、高级组件集成及项目文档整理工作。具体包括:'), p('1. 完成自定义 TabBar 修复与验证,确保底部导航图标正常显示。'), p('2. 完成胶囊安全区适配方案,解决微信小程序自定义导航栏适配问题。'), p('3. 完成首页、任务、排班、个人中心等核心页面的 UI 风格统一。'), p('4. 完成 ImageUploader、MapView、SignaturePad、ChartView 四个高级组件的集成。'), p('5. 完成项目文档体系梳理,为验收汇报做准备。'), h1('三、总体进度'), createTable(['阶段', '计划内容', '完成状态'], [ ['基础架构搭建', 'uni-app + Vue3 + Vite + TS 项目初始化、样式配置、后端对接、Pinia Store、公共组件', '已完成'], ['页面重构', '24 个核心页面重构为 uni-card/uni-list/uni-icons 风格', '已完成'], ['缺失页面补充', '12 个缺失页面补充完成', '已完成'], ['高级功能', '图片上传、地图定位、电子签名、图表可视化', '已完成'], ['文档与验收', '需求/设计/接口/测试/验收文档整理', '进行中'] ], [2500, 4500, 2960]), h1('四、下周计划'), p('1. 完成剩余项目文档的编制与评审。'), p('2. 开展系统功能回归测试,重点验证任务全流程。'), p('3. 准备上线部署环境,完成微信小程序预览版发布。'), p('4. 组织客户验收会议,收集反馈并制定优化清单。'), h1('五、风险与问题'), p('当前无明显阻塞性风险。实时定位与消息推送功能框架已就绪,待后端配合及真实设备接入后正式启用。') ]); } function docTest() { return generateDoc('测试计划与测试用例', 'Test Plan and Test Cases', [ h1('一、测试目标'), p('验证清道夫系统微信小程序在销售端、调度端、施工端的功能正确性、兼容性及稳定性,确保系统满足交付标准。'), h1('二、测试范围'), createTable(['模块', '测试内容'], [ ['登录认证', '账号密码登录、角色切换、Token 过期处理'], ['项目管理', '项目新增、编辑、删除、列表筛选、详情查看'], ['任务管理', '任务创建、状态流转、催单、取消、日志查看'], ['排班调度', '排班创建、按日期查询、车辆人员分配'], ['消息通知', '通知列表、分类筛选、标记已读'], ['高级组件', '图片上传、地图定位、电子签名、图表展示'] ], [2500, 7460]), h1('三、测试环境'), p('测试在微信开发者工具、iOS 真机、Android 真机三种环境下进行;后端使用测试环境接口 http://localhost:8080/api。'), h1('四、功能测试用例'), createTable(['用例编号', '用例名称', '操作步骤', '预期结果'], [ ['TC-001', '用户登录', '输入账号密码,选择角色,点击登录', '登录成功,跳转对应角色首页'], ['TC-002', '新增项目', '进入项目库,点击新增,填写项目信息,提交', '项目创建成功,列表自动刷新'], ['TC-003', '发布任务', '选择项目,填写任务类型与紧急程度,提交', '任务生成并进入待审核状态'], ['TC-004', '调度审核任务', '调度端查看待审核任务,点击通过', '任务状态变更为已排班'], ['TC-005', '施工出车', '施工端进入任务详情,点击出车', '任务状态更新为已出车'], ['TC-006', '现场签到', '施工端到达项目位置,点击到场', '记录到场时间,状态更新'], ['TC-007', '施工完成签字', '完成施工后上传照片并电子签名', '任务状态更新为待验收'], ['TC-008', '图片上传', '在任务详情选择本地图片上传', '图片预览与删除正常'] ], [1500, 1800, 3500, 3160]), h1('五、兼容性测试'), p('覆盖 iOS 微信、Android 微信、微信开发者工具三种环境,验证页面布局、组件交互、网络请求、本地存储等功能正常。'), h1('六、测试进度'), p('核心功能用例已执行 80% 以上,未发现严重缺陷;剩余用例集中在高级组件真机验证及多角色端到端流程验证。') ]); } function docDeploy() { return generateDoc('上线部署方案', 'Deployment Plan', [ h1('一、部署目标'), p('将清道夫系统微信小程序从测试环境部署到生产环境,确保系统稳定、安全、可回滚。'), h1('二、部署环境'), createTable(['环境', '说明'], [ ['开发环境', '本地运行,地址 http://localhost:8080/api'], ['测试环境', '微信小程序预览版 + 测试后端'], ['生产环境', '微信小程序正式版 + 生产后端'] ], [2500, 7460]), h1('三、部署流程'), p('1. 代码审查:完成最终代码走查,确保无敏感信息泄露。'), p('2. 构建打包:执行 npm run build:mp-weixin,生成微信小程序代码包。'), p('3. WXSS 检查:运行 npm run check:wxss,检查转义字符问题。'), p('4. 类型检查:运行 npm run type-check,确保 TypeScript 无编译错误。'), p('5. 上传代码:使用微信开发者工具上传代码至微信小程序后台。'), p('6. 提交审核:在微信公众平台提交版本审核。'), p('7. 发布上线:审核通过后发布正式版本。'), h1('四、回滚方案'), p('若生产环境出现异常,可通过微信公众平台立即将线上版本回退到上一稳定版本;同时后端接口保持向下兼容,确保旧版本小程序可正常使用。'), h1('五、监控与运维'), p('上线后通过微信小程序后台监控页面访问、接口错误、用户反馈等数据;后端通过日志与告警系统实时监控服务健康状态。') ]); } function docAcceptance() { return generateDoc('项目验收报告', 'Project Acceptance Report', [ h1('一、验收范围'), p('本次验收范围为清道夫系统微信小程序全部功能模块,包括登录认证、销售端、调度端、施工端、消息通知、帮助中心、知识库、数据可视化等。'), h1('二、验收标准'), createTable(['验收项', '标准'], [ ['功能完整性', '原型规划 54 个页面全部实现'], ['接口连通性', '前端与后端接口联调通过,主要业务流程可闭环'], ['UI 一致性', '统一使用 uni-card/uni-list/uni-icons 风格,无 emoji'], ['性能指标', '页面首屏加载 < 3 秒,列表滑动流畅'], ['文档交付', '需求、设计、接口、测试、部署、验收文档齐全'] ], [2500, 7460]), h1('三、验收结果'), createTable(['验收项', '结果', '说明'], [ ['功能完整性', '通过', '54/54 页面已实现'], ['接口连通性', '通过', '核心接口联调完成'], ['UI 一致性', '通过', '风格统一,emoji 已清理'], ['性能指标', '通过', '首屏与列表性能满足要求'], ['文档交付', '通过', '10 份交付文档已编制'] ], [2500, 1500, 5960]), h1('四、遗留问题'), p('1. 实时定位功能框架已就绪,需真实设备与后端配合后启用。'), p('2. 消息推送功能框架已就绪,需后端接入 uni-push 后启用。'), h1('五、验收结论'), p('清道夫系统微信小程序已完成合同约定的全部开发内容,功能、性能、文档均满足验收标准,建议予以验收通过。') ]); } function docRisk() { return generateDoc('风险与问题跟踪表', 'Risk and Issue Tracking', [ h1('一、风险清单'), createTable(['风险编号', '风险描述', '影响程度', '应对措施', '状态'], [ ['R-001', '实时定位依赖真实 GPS 设备,开发阶段难以完整验证', '中', '框架先行实现,上线后结合真车实测迭代', '跟踪中'], ['R-002', '消息推送需后端配合 uni-push 配置', '中', '已与后端确认排期,预留接入扩展点', '跟踪中'], ['R-003', '微信小程序审核周期不可控', '低', '提前准备材料,预留审核缓冲时间', '已规避'], ['R-004', '多角色权限控制复杂度较高', '中', '通过 roleType 映射与接口鉴权双重控制', '已缓解'] ], [1200, 3000, 1200, 3000, 1560]), h1('二、问题清单'), createTable(['问题编号', '问题描述', '解决方案', '状态'], [ ['I-001', '底部 TabBar 图标显示为文字', 'BottomNav 组件补充 uni-icons 字体类名', '已解决'], ['I-002', '退出登录未跳转页面', 'profile 页面补充 uni.reLaunch 跳转登录页', '已解决'], ['I-003', '部分子页面缺少顶部操作栏', 'projectList、profile 等页面补充 TopBar 组件', '已解决'], ['I-004', 'Tailwind CSS 编译异常', '将 PostCSS 配置迁移至 vite.config.ts', '已解决'], ['I-005', '小程序不支持 * 选择器', 'global.scss 中避免使用全局 * 选择器', '已解决'] ], [1200, 3500, 3500, 1360]), h1('三、跟踪说明'), p('本表将持续更新,关键风险由项目经理每周评审,重大问题纳入周会专题讨论。') ]); } function docReview() { return generateDoc('项目复盘报告', 'Project Retrospective Report', [ h1('一、项目背景与目标'), p('清道夫系统旨在为环境服务行业提供一套覆盖销售、调度、施工全链路的移动化管理平台。项目目标是在 2 周内完成 54 个页面的开发、重构与高级组件集成,形成可交付的微信小程序产品。'), h1('二、项目成果'), p('1. 全面完成 54 个页面的开发与重构工作。'), p('2. 建立统一的技术栈与组件规范(uni-app + Vue3 + TypeScript + Pinia + Tailwind CSS)。'), p('3. 实现图片上传、地图定位、电子签名、Canvas 图表等 4 项高级功能。'), p('4. 输出需求、设计、接口、数据库、测试、部署、验收、风险、复盘等 10 份项目文档。'), h1('三、经验总结'), createTable(['维度', '经验'], [ ['技术选型', 'uni-app + Vue3 组合适合小程序快速开发,TypeScript 显著提升可维护性'], ['组件复用', 'uni-card/uni-list 等组件化开发大幅提高了页面重构效率'], ['状态管理', 'Pinia 的 Composition API 风格与 Vue3 配合良好'], ['问题响应', '建立 DEV_LOG 与问题跟踪表,便于快速定位与复盘'] ], [2000, 7960]), h1('四、改进建议'), p('1. 后续项目可增加自动化测试覆盖,尤其是任务状态流转的核心路径。'), p('2. 建议引入接口 Mock 平台,降低前后端联调阻塞。'), p('3. 实时定位与消息推送功能应在项目初期明确后端接口与权限方案。'), h1('五、结论'), p('本项目按计划完成全部核心交付物,团队协作顺畅,技术方案合理,为后续迭代与推广奠定了坚实基础。') ]); } // ================= Main ================= async function main() { const docs = [ { name: '01-产品需求规格说明书.docx', generator: docRequirement }, { name: '02-系统架构设计说明书.docx', generator: docArchitecture }, { name: '03-接口设计文档.docx', generator: docApi }, { name: '04-数据库设计说明书.docx', generator: docDatabase }, { name: '05-项目进度周报.docx', generator: docProgress }, { name: '06-测试计划与测试用例.docx', generator: docTest }, { name: '07-上线部署方案.docx', generator: docDeploy }, { name: '08-项目验收报告.docx', generator: docAcceptance }, { name: '09-风险与问题跟踪表.docx', generator: docRisk }, { name: '10-项目复盘报告.docx', generator: docReview } ]; for (const { name, generator } of docs) { const doc = generator(); await saveDoc(doc, name); } console.log('All documents generated successfully.'); } main().catch(err => { console.error('Error generating documents:', err); process.exit(1); });