# -*- coding: utf-8 -*- """生成「还车应结款」用户操作说明 Word 文档及原型配图（脚本可重复运行）""" import os from pathlib import Path from docx import Document from docx.shared import Pt, Inches, Cm from docx.enum.text import WD_ALIGN_PARAGRAPH from docx.oxml.ns import qn from docx.oxml import OxmlElement try: from PIL import Image, ImageDraw, ImageFont except ImportError: Image = None ROOT = Path(__file__).resolve().parent OUT_DOC = ROOT / "还车应结款-用户操作说明.docx" LIST_SCREENSHOT = Path( "/Users/sylvawong/.cursor/projects/Users-sylvawong-Desktop-CURSOR-ONE-OS/assets/" "2230B49A-9740-471C-ADE4-FC7723DC4CA9_4_5005_c-70f13b01-98b2-42e3-a4f5-6824f02f1838.png" ) def set_cell_shading(cell, fill_hex): """Word 表格单元格背景色""" shading = OxmlElement("w:shd") shading.set(qn("w:fill"), fill_hex) cell._tc.get_or_add_tcPr().append(shading) def add_heading_cn(doc, text, level): h = doc.add_heading(text, level=level) for r in h.runs: r.font.name = "PingFang SC" r._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") return h def add_para_cn(doc, text, bold=False): p = doc.add_paragraph() run = p.add_run(text) run.font.size = Pt(11) run.font.name = "PingFang SC" run._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") run.bold = bold return p def make_prototype_figure(path: Path, title: str, lines: list): """根据原型结构生成示意配图（非系统实拍，便于培训对照 JSX页面区块）""" if Image is None: return False w, h = 900, 520 img = Image.new("RGB", (w, h), (250, 250, 250)) draw = ImageDraw.Draw(img) draw.rectangle([0, 0, w - 1, h - 1], outline=(200, 200, 200), width=2) try: font_title = ImageFont.truetype("/System/Library/Fonts/PingFang.ttc", 22, index=1) font_body = ImageFont.truetype("/System/Library/Fonts/PingFang.ttc", 17, index=1) font_small = ImageFont.truetype("/System/Library/Fonts/PingFang.ttc", 14, index=1) except OSError: font_title = font_body = font_small = ImageFont.load_default() y = 20 draw.text((24, y), title, fill=(17, 24, 39), font=font_title) y += 44 draw.line([(24, y), (w - 24, y)], fill=(217, 217, 217), width=1) y += 16 for line in lines: draw.text((32, y), line, fill=(51, 51, 51), font=font_body) y += 28 note = "说明：本图为原型页面结构示意，正式文档可替换为系统实拍截图。" draw.text((24, h - 36), note, fill=(120, 120, 120), font=font_small) img.save(path, "PNG") return True def build(): ROOT.mkdir(parents=True, exist_ok=True) fig_view = ROOT / "配图-还车应结款-查看页-原型结构.png" fig_fee = ROOT / "配图-还车应结款-费用明细-原型结构.png" make_prototype_figure( fig_view, "还车应结款 · 查看页（原型 还车应结款-查看.jsx）", [ "面包屑：财务管理 / 还车应结款 / 查看", "卡片① 还车车辆明细表（车牌、合同、项目、客户、交还车时间）", " · 易损保 / 轮胎保 / 养护保（是/否 + 提示图标说明）", "卡片② 还车费用明细", " · 统计：保证金、待结算、应退还、应补缴（可点开分项）", " · 业务服务组 / 能源组 / 运维部 / 安全组（只读展示）", "底部：返回列表", ], ) make_prototype_figure( fig_fee, "还车应结款 · 费用明细页（原型 还车应结款-费用明细.jsx）", [ "面包屑：财务管理 / 还车应结款（含「查看需求说明」）", "卡片 还车车辆明细（同上）", "卡片 还车费用明细：顶部四统计 + 可折叠四组", " · 业务服务组：固定费用行 + 可增删行；车辆租金三块", " · 能源采购组：氢量差/交还车氢量/单价/氢电费/预付款退费", " · 运维部：清洗保养维修等；轮胎磨损说明气泡；无忧包减免", " · 安全组：违章清单 + 事故清单；保存/提交/撤回", "底栏：提交审核（15天倒计时+四组已提交） / 取消", ], ) doc = Document() sect = doc.sections[0] sect.page_height = Cm(29.7) sect.page_width = Cm(21.0) sect.left_margin = Cm(2.2) sect.right_margin = Cm(2.2) title = doc.add_paragraph() title.alignment = WD_ALIGN_PARAGRAPH.CENTER r = title.add_run("数字化资产 ONEOS 运管平台\n还车应结款 · 用户操作说明（培训版）") r.bold = True r.font.size = Pt(18) r.font.name = "PingFang SC" r._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") add_para_cn( doc, "适用范围：财务管理模块下的「还车应结款」列表、只读查看页、费用明细协作页。" "配图说明：图1 为同类财务列表界面实拍（布局与还车应结款列表一致）；" "图 2、图 3 为依据原型 JSX 页面结构整理的示意配图，可在定稿前替换为系统截图。", ) add_heading_cn(doc, "一、模块作用与入口", 1) add_para_cn( doc, "用于车辆还车后汇总安全、业务服务、运维、能源等数据，形成待结算金额并进入审批/账单流程。" "入口：左侧菜单 财务管理 → 还车应结款。", ) add_heading_cn(doc, "二、列表页：筛选与查询", 1) add_para_cn(doc, "筛选区支持：合同编号、客户名称、项目名称（可展开后：车牌号、还车时间范围、审批状态）。按钮：重置、查询。") tbl = doc.add_table(rows=8, cols=2) tbl.style = "Table Grid" hdr = ["条件", "说明"] for j, t in enumerate(hdr): tbl.rows[0].cells[j].text = t set_cell_shading(tbl.rows[0].cells[j], "E6F4EA") rows_data = [ ("合同编号", "下拉 + 输入模糊匹配"), ("客户名称", "同上"), ("项目名称", "同上"), ("车牌号", "展开后，同上"), ("还车时间", "起止日期，精确到日"), ("审批状态", "待提交/待审批/审批中/审批完成/审批驳回/撤回"), ("导出", "列表卡片右上角导出当前结果"), ] for i, (a, b) in enumerate(rows_data, start=1): tbl.rows[i].cells[0].text = a tbl.rows[i].cells[1].text = b add_heading_cn(doc, "三、列表页：表格字段与审批状态", 1) add_para_cn(doc, "提交情况四列：安全组、业务服务组、运维组、能源组。绿点=已提交，灰点=未提交，后接提交人姓名。") add_para_cn(doc, "审批状态含义：待提交=四组未齐且未提审批；待审批=已提审无人处理；审批中=有节点已通过未完；审批完成=流程结束；审批驳回=任一节点的驳回；撤回=终审前主动撤回。") add_heading_cn(doc, "四、列表页：操作按钮", 1) ops = [ "查看：进入只读「查看」页。", "生成账单：仅「待审批」显示；弹窗账单并可打印（需允许浏览器弹窗）。", "费用明细：待审批/审批中/审批完成 时隐藏；其余可编辑阶段进入费用明细。", "撤回：仅待审批、审批中显示；确认后状态改为撤回。", ] for o in ops: p = doc.add_paragraph(style="List Bullet") r = p.add_run(o) r.font.name = "PingFang SC" r._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") r.font.size = Pt(11) add_heading_cn(doc, "五、配图", 1) p_cap1 = doc.add_paragraph() p_cap1.alignment = WD_ALIGN_PARAGRAPH.CENTER r1 = p_cap1.add_run( "图 1 财务管理 · 列表页布局参考（实拍；与「还车应结款」列表同一套：侧栏、筛选、表格、分页）" ) r1.font.size = Pt(10) r1.font.name = "PingFang SC" r1._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") r1.italic = True if LIST_SCREENSHOT.is_file(): doc.add_picture(str(LIST_SCREENSHOT), width=Inches(6.2)) doc.paragraphs[-1].alignment = WD_ALIGN_PARAGRAPH.CENTER else: add_para_cn(doc, "（未找到图1源文件，请将财务列表截图置于文档此处）", bold=True) p_cap2 = doc.add_paragraph() p_cap2.alignment = WD_ALIGN_PARAGRAPH.CENTER r2 = p_cap2.add_run("图 2 还车应结款 · 查看页（原型结构示意）") r2.font.size = Pt(10) r2.font.name = "PingFang SC" r2._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") r2.italic = True if fig_view.is_file(): doc.add_picture(str(fig_view), width=Inches(6.2)) doc.paragraphs[-1].alignment = WD_ALIGN_PARAGRAPH.CENTER p_cap3 = doc.add_paragraph() p_cap3.alignment = WD_ALIGN_PARAGRAPH.CENTER r3 = p_cap3.add_run("图 3 还车应结款 · 费用明细页（原型结构示意）") r3.font.size = Pt(10) r3.font.name = "PingFang SC" r3._element.rPr.rFonts.set(qn("w:eastAsia"), "PingFang SC") r3.italic = True if fig_fee.is_file(): doc.add_picture(str(fig_fee), width=Inches(6.2)) doc.paragraphs[-1].alignment = WD_ALIGN_PARAGRAPH.CENTER add_heading_cn(doc, "六、查看页（只读）要点", 1) add_para_cn( doc, "车辆明细含三项保险及提示文案。费用区四张统计卡可点击展开分项。" "业务服务组、能源组、运维部、安全组为只读表格；轮胎磨损可悬停查看逐胎明细。底部返回列表。", ) add_heading_cn(doc, "七、费用明细页：各组分工", 1) add_para_cn( doc, "业务服务组：5 项固定费用 + 可新增行；车辆租金（已收/实际/应退，实际租金默认按日折算可手改）。保存/提交/撤回；已提交后锁定至撤回。", ) add_para_cn( doc, "能源采购组：交还车氢量、单价只读；交车氢量大于还车时氢量差补缴自动算；氢费/电费/预付款退费可填；最后一辆车红色提示。", ) add_para_cn( doc, "运维部：清洗、保养、维修、车损等；证件丢失按规则自动计价；送/接车服务费禁用反写；轮胎磨损与胎纹合计规则见需求说明；无忧包减免与三项保险挂钩。", ) add_para_cn( doc, "安全组：违章清单、事故清单；确认后提交。", ) add_heading_cn(doc, "八、金额计算（口径）", 1) add_para_cn( doc, "待结算总额 = 业务服务组费用合计 + 车辆应退租金 + 氢量差补缴 + 氢费补缴 + 电费补缴 − 预付款退费 + 运维部费用合计。", ) add_para_cn( doc, "应退还总额：保证金 − 待结算 为正时取该值。应补缴总额：保证金 − 待结算 为负时取绝对值。", ) add_heading_cn(doc, "九、提交审核条件", 1) add_para_cn( doc, "原型规则：单据生成后满 15 天倒计时结束，且业务服务组、能源采购组、运维部、安全组均为「已提交」，" "底部「提交审核」才可点；否则按钮禁用并显示剩余天/小时。提交前系统校验各必填金额与无忧包减免等。", ) add_heading_cn(doc, "十、修订记录", 1) add_para_cn(doc, "文档版本：V1.0 生成依据：web端/财务管理/还车应结款.jsx、还车应结款-查看.jsx、还车应结款-费用明细.jsx 内嵌需求说明。") doc.save(OUT_DOC) print("Wrote:", OUT_DOC) if __name__ == "__main__": build()