# -*- coding: utf-8 -*-
|
"""生成《交通统计报表审核系统-用户使用说明书》Word 文档。"""
|
import os
|
from docx import Document
|
from docx.shared import Pt, Inches, RGBColor
|
from docx.enum.text import WD_ALIGN_PARAGRAPH
|
from docx.enum.table import WD_TABLE_ALIGNMENT
|
from docx.oxml.ns import qn
|
|
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
|
SHOT_DIR = os.path.join(BASE_DIR, "usage_screenshots")
|
OUT_PATH = os.path.join(BASE_DIR, "交通统计报表审核系统-用户使用说明书.docx")
|
|
SCREENSHOTS = [
|
("01_工作台.jpg", "一、工作台", [
|
"工作台是登录系统后的首页，顶部为系统名称与当前页面名称，左侧为功能菜单（工作台、数据导入、数据查看、企业解释、审核结果、报表生成、规则管理、用户管理）。",
|
"页面主体展示统计数据卡片，方便用户快速了解本报表期的数据概况（如企业数、车辆数、轨迹里程、审核结果等关键指标）。",
|
"左侧菜单与顶部区域固定不动，页面内容较多时仅内容区域滚动，便于用户随时切换功能。",
|
]),
|
("02_数据导入.jpg", "二、数据导入", [
|
"数据导入用于把用户整理的 Excel 模板数据批量导入系统，支持的数据类型包括：交企统H203-2表（道路货物运输月度生产情况）、运政车辆、轨迹里程、规上规下拆分运输量、货运量周转量等。",
|
"操作步骤：①选择数据类型；②选择报表期（以页面选择的月份为准，导入当月与1-当月累计数据）；③点击“上传”选择 Excel 文件；④点击“导入”。",
|
"导入时系统会逐行校验数据，导入失败的行会提示行号，方便用户在 Excel 中定位并修改错误数据后重新导入。",
|
]),
|
("03_数据查看.jpg", "三、数据查看", [
|
"数据查看用于查询已经导入系统的数据，便于核对与追溯。",
|
"可按数据类型（分类）、报表期（选择具体月份）筛选，并支持输入关键字搜索企业等信息。",
|
"查询结果以表格展示，表格数据较多时仅表格内部滚动，标题与筛选条件区保持固定，方便持续浏览。",
|
]),
|
("04_企业解释.jpg", "四、企业解释", [
|
"企业解释用于查看企业在审核中提交的解释说明，并可使用 AI 对每一条解释进行智能分析。",
|
"点击某条解释的“AI分析”后弹出对话窗口：窗口上方展示 AI 的分析输出，下方为用户的输入框，可与 AI 进行多轮对话，进一步获得处置建议。",
|
"对话过程中，AI 可自动查询数据库中的相关数据，给出有数据支撑的建议，而不是凭空推断。",
|
]),
|
("05_审核结果.jpg", "五、审核结果", [
|
"审核结果页用于执行审核并查看审核结论。",
|
"操作步骤：①选择报表期；②点击“执行审核”重新计算，或点击“查询结果”查看历史审核结果。",
|
"审核结果较多时，可按“企业名称”（关键字）和“审核规则”进行过滤，帮助用户快速定位重点企业。",
|
"结果表格包含企业名称、审核规则、实际值、阈值/对比、偏差说明、等级、状态与操作列；对误报的记录可点击“确认忽略”。",
|
]),
|
("06_报表生成.jpg", "六、报表生成", [
|
"报表生成用于按选定的报表期自动计算并导出各类统计报表。",
|
"选择报表期后点击相应按钮即可生成并下载报表，当前支持：货运量周转量、货运量分市州明细、货运量排名、周转量排名。",
|
"报表数据由系统根据已导入的数据自动计算生成，无需人工整理。",
|
]),
|
("07_规则管理.jpg", "七、规则管理", [
|
"规则管理用于维护审核规则（如阈值、对比方式等）。",
|
"当前演示版本中该页面为占位页，正式版本将支持规则的查看、新增、修改与启停管理。",
|
]),
|
("08_用户管理.jpg", "八、用户管理", [
|
"用户管理用于维护系统登录用户及其权限。",
|
"当前演示版本中该页面为占位页，正式版本将支持用户的增删改查与角色权限分配。",
|
]),
|
]
|
|
def set_font(run, size=12, bold=False, color=None, name="微软雅黑"):
|
run.font.size = Pt(size)
|
run.font.bold = bold
|
run.font.name = name
|
r = run._element.rPr.rFonts
|
r.set(qn("w:eastAsia"), name)
|
if color:
|
run.font.color.rgb = RGBColor(*color)
|
|
def add_heading(doc, text, size=16, color=(0x1F, 0x4E, 0x79), space_before=18, space_after=10):
|
p = doc.add_paragraph()
|
p.paragraph_format.space_before = Pt(space_before)
|
p.paragraph_format.space_after = Pt(space_after)
|
run = p.add_run(text)
|
set_font(run, size=size, bold=True, color=color)
|
return p
|
|
def add_body(doc, text, size=11, indent=0.3, space_after=6):
|
p = doc.add_paragraph()
|
p.paragraph_format.space_after = Pt(space_after)
|
p.paragraph_format.first_line_indent = Inches(indent)
|
p.paragraph_format.line_spacing = 1.4
|
run = p.add_run(text)
|
set_font(run, size=size)
|
return p
|
|
def main():
|
doc = Document()
|
# 页面设置：A4
|
for section in doc.sections:
|
section.page_width = Inches(8.27)
|
section.page_height = Inches(11.69)
|
section.left_margin = Inches(0.9)
|
section.right_margin = Inches(0.9)
|
section.top_margin = Inches(0.9)
|
section.bottom_margin = Inches(0.9)
|
|
# ===== 封面 =====
|
for _ in range(6):
|
doc.add_paragraph()
|
p = doc.add_paragraph()
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
run = p.add_run("交通统计报表审核系统")
|
set_font(run, size=30, bold=True, color=(0x1F, 0x4E, 0x79))
|
p = doc.add_paragraph()
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
run = p.add_run("用户使用说明书")
|
set_font(run, size=24, bold=True, color=(0x33, 0x33, 0x33))
|
for _ in range(4):
|
doc.add_paragraph()
|
p = doc.add_paragraph()
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
run = p.add_run("（演示版 Demo）")
|
set_font(run, size=14, color=(0x88, 0x88, 0x88))
|
p = doc.add_paragraph()
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
run = p.add_run("2026 年 8 月")
|
set_font(run, size=14, color=(0x88, 0x88, 0x88))
|
doc.add_page_break()
|
|
# ===== 文档说明 =====
|
add_heading(doc, "文档说明", size=18, space_before=6)
|
add_body(doc, "本说明书面向系统使用者，介绍“交通统计报表审核系统”各功能页面的用途与操作方法。系统围绕交通运输企业统计数据的上报、导入、查看、审核与报表生成等环节设计，帮助企业用户和审核人员高效完成数据填报质量核查工作。")
|
add_body(doc, "系统主要功能包括：数据导入、数据查看、企业解释（含 AI 智能分析）、审核结果（含 AI 处置建议）、报表生成，以及规则管理、用户管理等管理功能。")
|
add_body(doc, "本文档中的页面截图取自演示环境，页面布局与正式环境可能略有差异，功能与操作方式以实际系统为准。")
|
doc.add_page_break()
|
|
# ===== 各页面章节 =====
|
for fname, title, descs in SCREENSHOTS:
|
add_heading(doc, title, size=18, space_before=6)
|
for d in descs:
|
add_body(doc, d)
|
shot_path = os.path.join(SHOT_DIR, fname)
|
if os.path.exists(shot_path):
|
p = doc.add_paragraph()
|
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
run = p.add_run()
|
run.add_picture(shot_path, width=Inches(6.2))
|
cap = doc.add_paragraph()
|
cap.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
r = cap.add_run(f"图：{title.replace('、', ' ')}页面")
|
set_font(r, size=9, color=(0x88, 0x88, 0x88))
|
doc.add_page_break()
|
|
doc.save(OUT_PATH)
|
print("OK:", OUT_PATH)
|
|
if __name__ == "__main__":
|
main()
|
