系统介绍与功能总览信息化项目全流程管理系统源码逐行精讲一本系列文章配套完整源码已开源至 GitCodehttps://gitcode.com/u010972645/IAS-ProjectArchiveSystem读者可克隆或下载 ZIP 包配合本系列文章逐行学习。每篇文章对应源码中的具体文件跟着代码学开发直接上手做二次开发。前言你是否遇到过这样的困惑学了 Python 基础语法却不知道如何构建一个完整的桌面应用看了无数教程片段却始终拼凑不出一个真正可用的系统想学习 AI 大模型集成却找不到一个真实落地的项目参考本系列文章就是为了解决这个问题。我们将围绕一个真实上线运行的政务档案管理系统——信息化项目全流程管理系统IASIntelligent Archive System从项目架构到代码实现逐个文件、逐行代码进行完整讲解。这不是一个简单的 Demo而是一个包含 45 个 Python 源文件、约 18,000 行代码、集成 AI 大模型助手的完整系统。本文是系列第 1 篇将带你全面了解这个系统的定位、功能、技术栈和整体架构为后续逐行代码精讲打下基础。一、系统定位与核心价值1.1 系统是什么信息化项目全流程管理系统IAS是一款面向政务信息化项目的全流程档案管理桌面应用系统。系统以项目为核心围绕项目 → 分卷 → 附件三级档案结构提供完整的档案录入、查询、统计、导出和周期管理功能并深度集成 AI 智能助手支持自然语言交互查询与操作。简单来说这个系统解决的问题是政务信息化项目从立项到验收过程中产生的大量档案文件如何规范化管理、高效查询和智能分析。1.2 核心价值价值维度具体说明全流程管理覆盖项目立项、采购、建设、验收全生命周期的档案管理三级档案结构项目 → 分卷 → 附件的层级化组织符合政务档案管理规范AI 智能交互内置智能助手支持自然语言查询、统计、图表生成降低操作门槛数据安全业务数据全程本地存储AI 交互采用意图上云、数据留本地的安全架构规范导出支持按国家标准格式导出案卷目录、卷内目录、备考表、档案盒侧面、移交清单权限管控完善的用户-角色-权限三级权限体系满足政务系统安全要求跨平台部署同时支持 Windows 和银河麒麟 V10国产化适配1.3 适用场景政务信息化项目档案管理企事业单位基建/科研项目档案管理需要规范化档案归档与移交的场景希望通过 AI 提升档案查询与统计效率的场景学习场景想系统学习 Python 桌面应用开发、分层架构设计、AI 大模型集成的开发者二、技术栈总览2.1 技术选型一览技术领域技术选型选型理由开发语言Python 3.10语法简洁、生态丰富、AI 集成天然优势GUI 框架PySide6Qt 6官方支持、LGPL 许可、组件丰富、跨平台数据库SQLite 3零配置、单文件部署、桌面应用首选AI 大模型OpenAI 兼容 APIDeepSeek/通义千问等统一接口标准、灵活切换模型AI 编排LangChain工具调用编排、成熟的 LLM 生态文档导出python-docx纯 Python 生成 Word 文档跨平台兼容表格处理openpyxl读写 Excel 文件不依赖 OfficePDF 处理pypdf纯 Python 读取 PDF 页数跨平台图表生成Plotly Pandas交互式图表、数据清洗配置管理python-dotenv.env 文件管理配置简单直观打包工具PyInstaller打包为独立 exe/deb免安装部署2.2 依赖清单requirements.txt# 界面框架PySide6-WebEngine 已合并到 PySide6 主包中无需单独安装PySide6# AI大模型调度langchain langchain-openai langchain-community openai# 图表生成matplotlib plotly# Office文档操作跨平台兼容python-docx openpyxl pypdf# 日志、加密、工具cryptography python-dotenv pandas sqlalchemy源码文件requirements.txt。完整源码已开源至 GitCode 仓库读者可克隆后直接pip install -r requirements.txt安装依赖。2.3 为什么选 PySide6 而非 PyQt6 / Tkinter对比维度PySide6PyQt6Tkinter许可证LGPL商用友好GPL商用受限Python 自带Qt 版本Qt 6 官方绑定Qt 6 社区绑定非 Qt 体系UI 美观度原生级支持 QSS 样式同 PySide6较简陋组件丰富度极高含 WebEngine极高基础组件跨平台Windows/Linux/macOS同 PySide6同上Designer 工具Qt Designer可视化设计同上无本系统选择 PySide6 的核心理由LGPL 许可证允许闭源商用且QtWebEngineView组件可以嵌入网页渲染 Plotly 图表这是 Tkinter 无法实现的。三、系统功能总览3.1 功能架构图┌─────────────────────────────────────────────────────────────────────┐ │ 信息化项目全流程管理系统IAS │ ├──────────┬──────────┬──────────┬──────────┬──────────┬──────────────┤ │ 项目管理 │ 项目档案 │ 项目周期 │ 智能助手 │ 系统管理 │ 帮助中心 │ ├──────────┼──────────┼──────────┼──────────┼──────────┼──────────────┤ │ 项目列表 │ 分卷管理 │ 周期查询 │ 自然对话 │ 用户管理 │ 使用手册 │ │ 项目详情 │ 附件管理 │ 周期初始化 │ 意图识别 │ 部门管理 │ 关于信息 │ │ 新建项目 │ 归档导出 │ 周期保存 │ 技能调用 │ 角色管理 │ │ │ 编辑项目 │ 文件上传 │ 模板管理 │ 工作流 │ 权限管理 │ │ │ 删除项目 │ 页数计算 │ │ 图表生成 │ 字典管理 │ │ │ 状态跟踪 │ │ │ 统计分析 │ 配置管理 │ │ │ │ │ │ │ 日志管理 │ │ │ │ │ │ │ 模板管理 │ │ │ │ │ │ │ 技能管理 │ │ │ │ │ │ │ 工作流管理│ │ └──────────┴──────────┴──────────┴──────────┴──────────┴──────────────┘3.2 六大功能模块详解模块一项目管理项目管理是系统的核心入口提供项目的全生命周期管理。功能说明项目列表分页展示所有项目支持按编号/名称/部门/状态多条件筛选项目详情查看项目完整信息编号、名称、经理、部门、预算、实际成本、状态、日期新建项目创建项目时自动创建文件存储目录编辑/删除编辑项目信息删除前检查是否包含分卷级联保护权限过滤admin 角色查看全部项目普通用户仅查看本部门项目对应源码src/services/project_service.py业务逻辑、src/ui/main_window.py界面交互模块二项目档案项目档案模块实现项目 → 分卷 → 附件三级档案结构管理这是政务档案管理的标准规范。三级结构示意项目智慧政务平台P001 ├── 第一卷 │ ├── 0001 项目立项申请.pdf12页 │ ├── 0002 可行性研究报告.docx35页 │ └── 0003 党委会纪要.pdf5页 ├── 第二卷 │ ├── 0001 招标文件.pdf48页 │ └── 0002 中标通知书.pdf2页 └── 第三卷 └── 0001 验收报告.docx20页功能说明分卷管理分卷的增删改查设置保管期限永久/30年/10年总页数自动统计附件管理附件的增删改查支持文件上传、页数自动计算、文件类型分类归档导出一键导出案卷目录、卷内目录、备考表、档案盒侧面标签、移交清单Word 格式跨平台页数计算PDF 用 pypdf、DOCX 用 python-docx、XLSX 用 openpyxl不依赖 Microsoft Office对应源码src/services/volume_service.py、src/services/file_service.py、src/services/archive_export_service.py模块三项目周期项目周期模块管理项目从立项到验收的全流程实施进度以阶段 → 分阶段 → 要件三级结构跟踪每个环节的完成状态。功能说明周期查询查看项目的周期实施进度复选框标记完成状态周期初始化从模板创建空白周期表周期保存保存完成状态变更周期导出导出周期实施对照表为 Word 文档含合并单元格、颜色标记对应源码src/services/cycle_service.py、src/services/cycle_export_service.py模块四智能助手这是系统最具技术深度的模块——一个完整的 AI 智能助手支持自然语言交互。你可以这样和系统对话用户输入系统行为“查询所有项目”调用get_all_projects技能返回项目列表表格“项目1的详情”智能解析项目1ID匹配位置序号匹配返回项目完整信息“预算大于200的项目有哪些”工作流查全部项目 → filter过滤 → 返回结果“按部门统计项目数量”调用统计技能aggregate 分组聚合“生成项目状态分布图”调用图表技能Plotly 生成环形饼图“创建一个新项目编号P004名称云平台升级”调用create_project技能创建项目智能助手技术架构用户消息 │ ▼ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │ DialogManager│────▶│ 大模型云端 │────▶│ JSON 意图 │ │ 对话管理器 │ │ 只传意图不传数据 │ │ skillparams│ └──────────────┘ └──────────────────┘ └──────┬───────┘ │ ▼ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │ 模板引擎 │◀────│ Skill 执行 │◀────│ SkillRegistry│ │ 本地渲染答复 │ │ 本地数据操作 │ │ 66个技能注册 │ └──────────────┘ └──────────────────┘ └──────────────┘安全设计核心——“意图上云、数据留本地”大模型只接收用户消息 技能摘要 简短对话历史大模型只输出JSON 格式的调用指令选哪个技能 提取参数业务数据由本地 Skill 获取通过本地模板渲染原始数据永远不会传入云端大模型技术组件说明Skill 框架60 个服务技能 6 个图表技能八大分类体系工作流引擎7 种步骤类型call_skill/filter/sort/aggregate/loop/distinct/extract模板引擎60 答复模板本地渲染防止大模型幻觉对话管理器意图解析、参数转换、历史管理、失败降级对应源码src/ai/目录下 7 个核心文件dialog_manager.py、skill_base.py、workflow_engine.py、template_engine.py 等模块五系统管理系统管理模块提供完整的后台管理功能仅 admin 角色可见。子模块功能用户管理用户增删改查、密码管理、用户-角色-部门关联部门管理部门增删改查、层级结构、启用/禁用角色管理角色增删改查、角色-权限分配权限管理20 项权限定义编码规范如project:view、system:user:manage字典管理系统字典维护项目状态、保管期限、文件类型等配置管理5 大类配置项数据库/大模型/UI/存储/会话运行时可修改并写入 .env日志管理操作记录查询、按类型/模块/时间范围筛选、日志清理模板管理归档导出模板和周期模板的查看与编辑技能管理AI 技能的启用/禁用、元数据编辑、分类筛选工作流管理预定义工作流维护、触发关键词管理RBAC 权限体系数据流用户登录 → 查询角色 → 查询角色权限 → 返回 perm_codes 列表 │ ▼ UI 层根据 hasattr(perm_codes, xxx:xxx) │ ┌─────────┴─────────┐ │ │ 有权限 无权限 显示按钮 隐藏按钮对应源码src/services/user_service.py、src/services/role_service.py、src/services/permission_service.py、src/services/config_service.py模块六帮助中心功能说明使用手册内置 HTML 格式使用手册左侧目录树 右侧内容浏览器关于信息系统版本信息对应源码src/ui/manual_dialog.py四、系统架构设计4.1 四层分层架构系统采用经典的四层分层架构每层职责清晰、依赖单向┌─────────────────────────────────────────────────────┐ │ UI 层界面层 │ │ PySide6 Qt 组件MainWindow / ChatWidget / Dialog │ │ 职责界面渲染、事件处理、用户交互 │ ├─────────────────────────────────────────────────────┤ │ Service 层业务层 │ │ ProjectService / UserService / ArchiveExport... │ │ 职责业务逻辑、权限校验、数据校验、操作日志 │ ├─────────────────────────────────────────────────────┤ │ DAO 层数据访问层 │ │ BaseDAO / ProjectDAO / UserDAO / ... │ │ 职责SQL 执行、参数化查询、结果转换 │ ├─────────────────────────────────────────────────────┤ │ Model 层数据模型层 │ │ SQLiteprojects / project_volume / users / ... │ │ 职责数据存储、表结构定义、索引、种子数据 │ └─────────────────────────────────────────────────────┘ ┌─────────────────────────────────┐ │ AI 层横切模块 │ │ DialogManager / Skill / Workflow│ │ 通过 Skill 框架桥接 Service 层 │ └─────────────────────────────────┘依赖方向UI → Service → DAO → Model单向依赖不反向调用AI 层的特殊定位AI 层不是独立的一层而是横切在 Service 层之上的模块。它通过 Skill 框架调用 Service 层的方法复用业务逻辑通过模板引擎本地渲染答复。这意味着 AI 助手能做的操作和用户通过 UI 点击按钮做的操作走的是同一套业务逻辑和权限校验。4.2 完整数据流以用户点击查询项目为例完整数据流如下1. 用户在搜索栏输入条件点击查询按钮 ↓ UI 事件 2. MainWindow._search_projects() 被调用 ↓ 调用 Service 3. ProjectService.get_all_projects(user, filters) 执行 → 权限过滤admin 看全部普通用户看本部门 → 调用 DAO ↓ 调用 DAO 4. ProjectDAO.get_all(conditions) 执行 → 构建参数化 SQL → 执行查询 ↓ SQL 执行 5. SQLite 返回结果集 ↑ 逐层返回 6. DAO 将 sqlite3.Row 转为 dict 列表 ↑ 返回 Service 7. Service 返回数据 ↑ 返回 UI 8. MainWindow 填充 QTableWidget调整列宽显示数据4.3 数据库设计系统共 15 张数据表含 2 张迁移临时表核心表关系如下users ──┐ ├── role_permission ──── permission dept ───┘ │ │ projects ──── project_volume ──── project_file │ │ │ │ └── project_cycle sys_template sys_dict system_log ai_skill ai_workflow表名说明关键字段projects项目主表project_code(唯一)、project_name、manager、department、budget、statusproject_volume分卷表project_id(外键)、volume_no、volume_code(唯一)、retention_periodproject_file附件表project_id、volume_id、file_no、file_name、file_path、pages、file_typeusers用户表username(唯一)、password(SHA-256)、role_id、dept_idrole角色表role_code、role_name、enabledpermission权限表perm_code、perm_name、perm_typerole_permission角色权限关联表role_id、permission_iddept部门表dept_code、dept_name、enabledsys_dict系统字典表dict_type、dict_code、dict_valuesys_template系统模板表template_code、template_type、template_content(JSON)system_log操作日志表user_id、operate_type、module、content、operate_timeproject_cycle项目周期表project_id、template_id、cycle_data(JSON)ai_skillAI 技能表skill_name、category、enabled、display_nameai_workflowAI 工作流表workflow_code、steps(JSON)、trigger_keywords设计亮点project_volume表的UNIQUE(project_id, volume_no)组合唯一约束——同一项目内分卷编号唯一不同项目可重复project_file表的UNIQUE(file_no, volume_id)组合唯一约束——同一分卷内附件编号唯一外键约束ON DELETE CASCADE——删除项目自动级联删除关联的分卷和附件对应源码src/models/db_models.py817 行含建表语句、种子数据、数据库迁移、索引创建五、项目目录结构IAS/ ├── src/ # 源码目录 │ ├── main.py # 应用入口106行 │ ├── ai/ # AI 智能助手模块 │ │ ├── skill_base.py # Skill 框架基类与注册中心 │ │ ├── dialog_manager.py # 对话管理器核心调度引擎 │ │ ├── workflow_engine.py # 工作流引擎7种步骤类型 │ │ ├── template_engine.py # 答复模板引擎60模板 │ │ ├── assistant_init.py # 智能助手初始化 │ │ └── skills/ # Skill 实现 │ │ ├── service_skills.py # 60个服务技能1886行 │ │ └── tool_skills.py # 6个图表技能 │ ├── api/ # 外部 API 封装 │ │ └── LLM_api.py # 大模型 API 客户端 │ ├── dao/ # 数据访问层14个DAO │ │ ├── base_dao.py # DAO 基类通用CRUD模板 │ │ ├── project_dao.py # 项目 DAO │ │ ├── volume_dao.py # 分卷 DAO │ │ └── ... # 其他11个DAO │ ├── models/ # 数据模型层 │ │ └── db_models.py # 数据库定义817行 │ ├── services/ # 业务服务层19个Service │ │ ├── base_service.py # Service 基类 │ │ ├── meta_service.py # 服务注册中心113个服务映射 │ │ ├── project_service.py # 项目管理服务 │ │ ├── archive_export_service.py # 归档导出服务494行 │ │ └── ... # 其他15个Service │ ├── ui/ # UI 界面层 │ │ ├── main_window.py # 主窗口5678行9篇文章精讲 │ │ ├── chat_widget.py # 智能助手聊天界面632行 │ │ ├── login_widget.py # 登录窗口 │ │ ├── manual_dialog.py # 使用手册对话框 │ │ └── styles.py # 全局样式系统 │ └── utils/ # 工具层 │ ├── app_paths.py # 路径工具源码/打包兼容 │ ├── chart_generator.py # Plotly 图表生成 │ └── meta_utils.py # LangChain 工具封装 ├── assets/ # 静态资源 │ ├── logo.ico / logo.png # 应用图标 │ └── plotly.min.js # Plotly JS 库本地渲染用 ├── db/ # 数据库目录 │ └── archive.db # SQLite 数据库文件 ├── storage/ # 文件存储目录 ├── .env # 环境配置不上传含API Key ├── .env.example # 配置模板占位符 ├── requirements.txt # 依赖清单 ├── IAS.spec # PyInstaller Windows 打包配置 ├── IAS_kylin.spec # PyInstaller 银河麒麟打包配置 ├── build.bat # Windows 打包脚本 ├── build_kylin.sh # 银河麒麟打包脚本 ├── run.sh # Linux 启动脚本 ├── LICENSE # MIT 开源许可证 └── README.md # 项目说明源码统计统计项数量Python 源文件45 个代码总行数~18,000 行数据库表15 张AI 技能66 个60 服务技能 6 图表技能答复模板60 个系统服务113 个SERVICE_REGISTRY 映射UI 组件方法100 个main_window.py六、系统界面预览6.1 登录界面系统启动后首先展示登录窗口采用渐变背景 青绿色主题色设计# login_widget.py 核心设计self.setFixedSize(420,380)# 固定尺寸# 渐变背景QDialog{background:qlineargradient(x1:0,y1:0,x2:1,y2:1,stop:0#F7FAFC, stop:0.5 #EDF2F7, stop:1 #E2E8F0);}# 登录按钮渐变QPushButton{background:qlineargradient(x1:0,y1:0,x2:1,y2:1,stop:0#4ECDC4, stop:1 #45B7D1);}6.2 主窗口登录成功后进入主窗口采用 Tab 页布局┌──────────────────────────────────────────────────────────┐ │ 文件 帮助 │ ├──────────────────────────────────────────────────────────┤ │ 当前用户: admin | 角色: 管理员 | 部门: 信息化服务一部 │ ├──────────────────────────────────────────────────────────┤ │ [项目管理] [智能助手] [系统管理] │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ 搜索: [项目编号] [项目名称] [部门▼] [状态▼] [查询] │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ │ │ 编号 名称 经理 部门 预算 状态 操作 │ │ │ │ │ │ P001 智慧政务 张三 一部 200 验收 [档案] │ │ │ │ │ │ P002 数据中台 李四 二部 500 建设 [档案] │ │ │ │ │ │ P003 网络安全 王五 三部 100 采购 [档案] │ │ │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ [新建项目] [编辑] [删除] │ │ │ └──────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────┘权限控制admin 角色可见三个 Tab 页项目管理、智能助手、系统管理普通用户仅可见两个 Tab 页项目管理、智能助手系统管理 Tab 隐藏# main_window.py 权限控制核心逻辑is_adminself.user.get(role_code)adminifis_admin:self._init_system_management_tab()# 仅 admin 可见系统管理6.3 项目档案管理点击项目列表中的档案按钮进入三级档案管理界面左右分栏布局┌──────────────┬──────────────────────────────────────────┐ │ 分卷列表 │ 附件列表 │ ├──────────────┼──────────────────────────────────────────┤ │ 第一卷 │ 编号 文件名 责任单位 页数 日期 │ │ (120页) │ 0001 立项申请.pdf 办公室 12 2025-01 │ │ │ 0002 可研报告.docx 规划部 35 2025-01 │ │ 第二卷 │ 0003 党委会纪要.pdf 办公室 5 2025-02 │ │ (50页) │ │ │ │ │ │ 第三卷 │ │ │ (20页) │ │ ├──────────────┼──────────────────────────────────────────┤ │ [新建分卷] │ [新增附件] [编辑] [删除] [导出目录] │ │ [编辑] [删除]│ │ └──────────────┴──────────────────────────────────────────┘6.4 智能助手智能助手采用微信风格聊天界面用户消息右侧绿色气泡系统消息左侧白色气泡┌──────────────────────────────────────────────────────┐ │ 智能助手 [清空对话] │ ├──────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────┐ │ │ │ 你好我是智能项目档案 │ │ │ │ 管理助手可以帮你查询 │ │ │ │ 项目、管理档案、生成 │ │ │ │ 统计图表等。 │ │ │ └─────────────────────────┘ │ │ │ │ ┌──────────────────┐ │ │ │ 查询所有项目 │ │ │ └──────────────────┘ │ │ │ │ ┌──────────────────────────────────────────┐ │ │ │ 共找到 3 个项目 │ │ │ │ | 序号 | 编号 | 名称 | 经理 | 部门 | ... | │ │ │ | 1 | P001 | 智慧政务 | 张三 | ... | │ │ │ | 2 | P002 | 数据中台 | 李四 | ... | │ │ └──────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────┐ │ │ │ [Plotly 饼图渲染区] │ │ │ │ 状态分布统计图 │ │ │ └─────────────────────┘ │ │ │ ├──────────────────────────────────────────────────────┤ │ [输入消息...] [发送] │ └──────────────────────────────────────────────────────┘6.5 全局样式系统系统采用统一的 QSSQt Style Sheet样式系统主题色为青绿色#4ECDC4# styles.py 颜色常量体系classStyles:PRIMARY_COLOR#4ECDC4# 主色青绿色PRIMARY_DARK#3dbdb5# 深色变体SECONDARY_COLOR#45B7D1# 辅助色蓝色ACCENT_COLOR#FF6B6B# 强调色珊瑚红SUCCESS_COLOR#67C23A# 成功色WARNING_COLOR#E6A23C# 警告色ERROR_COLOR#F56C6C# 错误色BG_LIGHT#F8FAFC# 浅色背景BG_CARD#FFFFFF# 卡片背景TEXT_PRIMARY#1E293B# 主文本色TEXT_SECONDARY#64748B# 次要文本色BORDER_COLOR#E2E8F0# 边框色对应源码src/ui/styles.py全局 QSS 样式表覆盖 QMainWindow、QWidget、QTabWidget、QTableWidget、QPushButton 等 20 组件。七、系统演示视频暂无八、源码获取与运行8.1 获取源码完整源码已开源至 GitCode仓库地址https://gitcode.com/u010972645/IAS-ProjectArchiveSystem方式一Git 克隆推荐gitclone https://gitcode.com/u010972645/IAS-ProjectArchiveSystem.git方式二下载 ZIP 包访问仓库页面点击下载 ZIP按钮解压即可。8.2 环境准备# 1. 安装 Python 3.10推荐 3.10 或 3.11# 2. 创建虚拟环境python-mvenv venv# 3. 激活虚拟环境# Windows:venv\Scripts\activate# Linux:sourcevenv/bin/activate# 4. 安装依赖pipinstall-rrequirements.txt8.3 配置大模型 API# 复制配置模板cp.env.example .env# 编辑 .env填入你的 API Key# MODEL_API_KEYsk-你的真实API密钥# MODEL_BASE_URLhttps://api.deepseek.com/v1# MODEL_NAMEdeepseek-chat支持 DeepSeek、OpenAI、通义千问等任何 OpenAI 兼容接口。不配置 API Key 也能运行系统只是智能助手功能不可用其他功能全部正常。8.4 启动系统python src/main.py默认登录账号用户名密码角色adminadmin123管理员九、本系列文章规划本系列共 60 篇文章按模块分为 9 大篇章篇章主题范围篇数阅读顺序一、系统总览篇系统介绍、技术栈、目录结构、架构设计、数据库设计5 篇1→2→3→4→5二、数据模型与初始化篇db_models.py 逐行解析3 篇6→7→8三、数据访问层DAO篇BaseDAO 基类、业务 DAO、RBAC DAO4 篇9→10→11→12四、业务服务层篇19 个 Service 逐行精讲10 篇13→…→22五、UI 界面层篇入口、样式、主窗口(9篇)、聊天(2篇)15 篇23→…→37六、AI 智能助手模块篇LLM 客户端、Skill、DialogManager、Workflow12 篇38→…→49七、工具层与图表篇路径工具、图表生成、服务层补充3 篇50→51→52八、打包部署与运维篇Windows 打包、麒麟打包、跨平台兼容4 篇53→54→55→56九、二次开发指南篇新增模块、新增 Skill、自定义模板4 篇57→58→59→60建议阅读顺序1→2→3→4→5→23→24→25→6→9→13先建立整体认知再按层次深入。十、总结本文作为系列开篇从系统定位、技术栈、功能模块、架构设计、目录结构、界面预览、演示建议等多个维度全面介绍了信息化项目全流程管理系统IAS的全貌。系统核心亮点回顾真实项目不是教学 Demo是真实上线运行的政务系统全栈覆盖GUI 数据库 分层架构 AI 集成 跨平台打包AI 深度集成66 个技能 7 步工作流引擎 60 模板 安全隔离架构国产化适配同时支持 Windows 和银河麒麟 V10代码规范四层分层架构、参数化查询、权限校验、操作日志下一篇预告第 2 篇技术栈选型与环境搭建 将详解 PySide6 vs PyQt vs Tkinter 的技术选型理由手把手搭建开发环境逐项解析 requirements.txt 依赖。完整源码获取https://gitcode.com/u010972645/IAS-ProjectArchiveSystem克隆或下载 ZIP 包后配合本系列文章逐行学习。每篇文章标注了对应的源码文件建议边读文章边看代码动手实践效果更佳。本文为 CSDN 付费专栏「AI政务系统开发实战信息化项目全流程管理系统源码逐行精讲」第 1 篇专栏共 60 篇文章逐个文件、逐行代码完整讲解适合有 Python 基础的开发者跟着教程从零搭建同类系统。
系统介绍与功能总览信息化项目全流程管理系统源码逐行精讲一本系列文章配套完整源码已开源至 GitCodehttps://gitcode.com/u010972645/IAS-ProjectArchiveSystem读者可克隆或下载 ZIP 包配合本系列文章逐行学习。每篇文章对应源码中的具体文件跟着代码学开发直接上手做二次开发。前言你是否遇到过这样的困惑学了 Python 基础语法却不知道如何构建一个完整的桌面应用看了无数教程片段却始终拼凑不出一个真正可用的系统想学习 AI 大模型集成却找不到一个真实落地的项目参考本系列文章就是为了解决这个问题。我们将围绕一个真实上线运行的政务档案管理系统——信息化项目全流程管理系统IASIntelligent Archive System从项目架构到代码实现逐个文件、逐行代码进行完整讲解。这不是一个简单的 Demo而是一个包含 45 个 Python 源文件、约 18,000 行代码、集成 AI 大模型助手的完整系统。本文是系列第 1 篇将带你全面了解这个系统的定位、功能、技术栈和整体架构为后续逐行代码精讲打下基础。一、系统定位与核心价值1.1 系统是什么信息化项目全流程管理系统IAS是一款面向政务信息化项目的全流程档案管理桌面应用系统。系统以项目为核心围绕项目 → 分卷 → 附件三级档案结构提供完整的档案录入、查询、统计、导出和周期管理功能并深度集成 AI 智能助手支持自然语言交互查询与操作。简单来说这个系统解决的问题是政务信息化项目从立项到验收过程中产生的大量档案文件如何规范化管理、高效查询和智能分析。1.2 核心价值价值维度具体说明全流程管理覆盖项目立项、采购、建设、验收全生命周期的档案管理三级档案结构项目 → 分卷 → 附件的层级化组织符合政务档案管理规范AI 智能交互内置智能助手支持自然语言查询、统计、图表生成降低操作门槛数据安全业务数据全程本地存储AI 交互采用意图上云、数据留本地的安全架构规范导出支持按国家标准格式导出案卷目录、卷内目录、备考表、档案盒侧面、移交清单权限管控完善的用户-角色-权限三级权限体系满足政务系统安全要求跨平台部署同时支持 Windows 和银河麒麟 V10国产化适配1.3 适用场景政务信息化项目档案管理企事业单位基建/科研项目档案管理需要规范化档案归档与移交的场景希望通过 AI 提升档案查询与统计效率的场景学习场景想系统学习 Python 桌面应用开发、分层架构设计、AI 大模型集成的开发者二、技术栈总览2.1 技术选型一览技术领域技术选型选型理由开发语言Python 3.10语法简洁、生态丰富、AI 集成天然优势GUI 框架PySide6Qt 6官方支持、LGPL 许可、组件丰富、跨平台数据库SQLite 3零配置、单文件部署、桌面应用首选AI 大模型OpenAI 兼容 APIDeepSeek/通义千问等统一接口标准、灵活切换模型AI 编排LangChain工具调用编排、成熟的 LLM 生态文档导出python-docx纯 Python 生成 Word 文档跨平台兼容表格处理openpyxl读写 Excel 文件不依赖 OfficePDF 处理pypdf纯 Python 读取 PDF 页数跨平台图表生成Plotly Pandas交互式图表、数据清洗配置管理python-dotenv.env 文件管理配置简单直观打包工具PyInstaller打包为独立 exe/deb免安装部署2.2 依赖清单requirements.txt# 界面框架PySide6-WebEngine 已合并到 PySide6 主包中无需单独安装PySide6# AI大模型调度langchain langchain-openai langchain-community openai# 图表生成matplotlib plotly# Office文档操作跨平台兼容python-docx openpyxl pypdf# 日志、加密、工具cryptography python-dotenv pandas sqlalchemy源码文件requirements.txt。完整源码已开源至 GitCode 仓库读者可克隆后直接pip install -r requirements.txt安装依赖。2.3 为什么选 PySide6 而非 PyQt6 / Tkinter对比维度PySide6PyQt6Tkinter许可证LGPL商用友好GPL商用受限Python 自带Qt 版本Qt 6 官方绑定Qt 6 社区绑定非 Qt 体系UI 美观度原生级支持 QSS 样式同 PySide6较简陋组件丰富度极高含 WebEngine极高基础组件跨平台Windows/Linux/macOS同 PySide6同上Designer 工具Qt Designer可视化设计同上无本系统选择 PySide6 的核心理由LGPL 许可证允许闭源商用且QtWebEngineView组件可以嵌入网页渲染 Plotly 图表这是 Tkinter 无法实现的。三、系统功能总览3.1 功能架构图┌─────────────────────────────────────────────────────────────────────┐ │ 信息化项目全流程管理系统IAS │ ├──────────┬──────────┬──────────┬──────────┬──────────┬──────────────┤ │ 项目管理 │ 项目档案 │ 项目周期 │ 智能助手 │ 系统管理 │ 帮助中心 │ ├──────────┼──────────┼──────────┼──────────┼──────────┼──────────────┤ │ 项目列表 │ 分卷管理 │ 周期查询 │ 自然对话 │ 用户管理 │ 使用手册 │ │ 项目详情 │ 附件管理 │ 周期初始化 │ 意图识别 │ 部门管理 │ 关于信息 │ │ 新建项目 │ 归档导出 │ 周期保存 │ 技能调用 │ 角色管理 │ │ │ 编辑项目 │ 文件上传 │ 模板管理 │ 工作流 │ 权限管理 │ │ │ 删除项目 │ 页数计算 │ │ 图表生成 │ 字典管理 │ │ │ 状态跟踪 │ │ │ 统计分析 │ 配置管理 │ │ │ │ │ │ │ 日志管理 │ │ │ │ │ │ │ 模板管理 │ │ │ │ │ │ │ 技能管理 │ │ │ │ │ │ │ 工作流管理│ │ └──────────┴──────────┴──────────┴──────────┴──────────┴──────────────┘3.2 六大功能模块详解模块一项目管理项目管理是系统的核心入口提供项目的全生命周期管理。功能说明项目列表分页展示所有项目支持按编号/名称/部门/状态多条件筛选项目详情查看项目完整信息编号、名称、经理、部门、预算、实际成本、状态、日期新建项目创建项目时自动创建文件存储目录编辑/删除编辑项目信息删除前检查是否包含分卷级联保护权限过滤admin 角色查看全部项目普通用户仅查看本部门项目对应源码src/services/project_service.py业务逻辑、src/ui/main_window.py界面交互模块二项目档案项目档案模块实现项目 → 分卷 → 附件三级档案结构管理这是政务档案管理的标准规范。三级结构示意项目智慧政务平台P001 ├── 第一卷 │ ├── 0001 项目立项申请.pdf12页 │ ├── 0002 可行性研究报告.docx35页 │ └── 0003 党委会纪要.pdf5页 ├── 第二卷 │ ├── 0001 招标文件.pdf48页 │ └── 0002 中标通知书.pdf2页 └── 第三卷 └── 0001 验收报告.docx20页功能说明分卷管理分卷的增删改查设置保管期限永久/30年/10年总页数自动统计附件管理附件的增删改查支持文件上传、页数自动计算、文件类型分类归档导出一键导出案卷目录、卷内目录、备考表、档案盒侧面标签、移交清单Word 格式跨平台页数计算PDF 用 pypdf、DOCX 用 python-docx、XLSX 用 openpyxl不依赖 Microsoft Office对应源码src/services/volume_service.py、src/services/file_service.py、src/services/archive_export_service.py模块三项目周期项目周期模块管理项目从立项到验收的全流程实施进度以阶段 → 分阶段 → 要件三级结构跟踪每个环节的完成状态。功能说明周期查询查看项目的周期实施进度复选框标记完成状态周期初始化从模板创建空白周期表周期保存保存完成状态变更周期导出导出周期实施对照表为 Word 文档含合并单元格、颜色标记对应源码src/services/cycle_service.py、src/services/cycle_export_service.py模块四智能助手这是系统最具技术深度的模块——一个完整的 AI 智能助手支持自然语言交互。你可以这样和系统对话用户输入系统行为“查询所有项目”调用get_all_projects技能返回项目列表表格“项目1的详情”智能解析项目1ID匹配位置序号匹配返回项目完整信息“预算大于200的项目有哪些”工作流查全部项目 → filter过滤 → 返回结果“按部门统计项目数量”调用统计技能aggregate 分组聚合“生成项目状态分布图”调用图表技能Plotly 生成环形饼图“创建一个新项目编号P004名称云平台升级”调用create_project技能创建项目智能助手技术架构用户消息 │ ▼ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │ DialogManager│────▶│ 大模型云端 │────▶│ JSON 意图 │ │ 对话管理器 │ │ 只传意图不传数据 │ │ skillparams│ └──────────────┘ └──────────────────┘ └──────┬───────┘ │ ▼ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │ 模板引擎 │◀────│ Skill 执行 │◀────│ SkillRegistry│ │ 本地渲染答复 │ │ 本地数据操作 │ │ 66个技能注册 │ └──────────────┘ └──────────────────┘ └──────────────┘安全设计核心——“意图上云、数据留本地”大模型只接收用户消息 技能摘要 简短对话历史大模型只输出JSON 格式的调用指令选哪个技能 提取参数业务数据由本地 Skill 获取通过本地模板渲染原始数据永远不会传入云端大模型技术组件说明Skill 框架60 个服务技能 6 个图表技能八大分类体系工作流引擎7 种步骤类型call_skill/filter/sort/aggregate/loop/distinct/extract模板引擎60 答复模板本地渲染防止大模型幻觉对话管理器意图解析、参数转换、历史管理、失败降级对应源码src/ai/目录下 7 个核心文件dialog_manager.py、skill_base.py、workflow_engine.py、template_engine.py 等模块五系统管理系统管理模块提供完整的后台管理功能仅 admin 角色可见。子模块功能用户管理用户增删改查、密码管理、用户-角色-部门关联部门管理部门增删改查、层级结构、启用/禁用角色管理角色增删改查、角色-权限分配权限管理20 项权限定义编码规范如project:view、system:user:manage字典管理系统字典维护项目状态、保管期限、文件类型等配置管理5 大类配置项数据库/大模型/UI/存储/会话运行时可修改并写入 .env日志管理操作记录查询、按类型/模块/时间范围筛选、日志清理模板管理归档导出模板和周期模板的查看与编辑技能管理AI 技能的启用/禁用、元数据编辑、分类筛选工作流管理预定义工作流维护、触发关键词管理RBAC 权限体系数据流用户登录 → 查询角色 → 查询角色权限 → 返回 perm_codes 列表 │ ▼ UI 层根据 hasattr(perm_codes, xxx:xxx) │ ┌─────────┴─────────┐ │ │ 有权限 无权限 显示按钮 隐藏按钮对应源码src/services/user_service.py、src/services/role_service.py、src/services/permission_service.py、src/services/config_service.py模块六帮助中心功能说明使用手册内置 HTML 格式使用手册左侧目录树 右侧内容浏览器关于信息系统版本信息对应源码src/ui/manual_dialog.py四、系统架构设计4.1 四层分层架构系统采用经典的四层分层架构每层职责清晰、依赖单向┌─────────────────────────────────────────────────────┐ │ UI 层界面层 │ │ PySide6 Qt 组件MainWindow / ChatWidget / Dialog │ │ 职责界面渲染、事件处理、用户交互 │ ├─────────────────────────────────────────────────────┤ │ Service 层业务层 │ │ ProjectService / UserService / ArchiveExport... │ │ 职责业务逻辑、权限校验、数据校验、操作日志 │ ├─────────────────────────────────────────────────────┤ │ DAO 层数据访问层 │ │ BaseDAO / ProjectDAO / UserDAO / ... │ │ 职责SQL 执行、参数化查询、结果转换 │ ├─────────────────────────────────────────────────────┤ │ Model 层数据模型层 │ │ SQLiteprojects / project_volume / users / ... │ │ 职责数据存储、表结构定义、索引、种子数据 │ └─────────────────────────────────────────────────────┘ ┌─────────────────────────────────┐ │ AI 层横切模块 │ │ DialogManager / Skill / Workflow│ │ 通过 Skill 框架桥接 Service 层 │ └─────────────────────────────────┘依赖方向UI → Service → DAO → Model单向依赖不反向调用AI 层的特殊定位AI 层不是独立的一层而是横切在 Service 层之上的模块。它通过 Skill 框架调用 Service 层的方法复用业务逻辑通过模板引擎本地渲染答复。这意味着 AI 助手能做的操作和用户通过 UI 点击按钮做的操作走的是同一套业务逻辑和权限校验。4.2 完整数据流以用户点击查询项目为例完整数据流如下1. 用户在搜索栏输入条件点击查询按钮 ↓ UI 事件 2. MainWindow._search_projects() 被调用 ↓ 调用 Service 3. ProjectService.get_all_projects(user, filters) 执行 → 权限过滤admin 看全部普通用户看本部门 → 调用 DAO ↓ 调用 DAO 4. ProjectDAO.get_all(conditions) 执行 → 构建参数化 SQL → 执行查询 ↓ SQL 执行 5. SQLite 返回结果集 ↑ 逐层返回 6. DAO 将 sqlite3.Row 转为 dict 列表 ↑ 返回 Service 7. Service 返回数据 ↑ 返回 UI 8. MainWindow 填充 QTableWidget调整列宽显示数据4.3 数据库设计系统共 15 张数据表含 2 张迁移临时表核心表关系如下users ──┐ ├── role_permission ──── permission dept ───┘ │ │ projects ──── project_volume ──── project_file │ │ │ │ └── project_cycle sys_template sys_dict system_log ai_skill ai_workflow表名说明关键字段projects项目主表project_code(唯一)、project_name、manager、department、budget、statusproject_volume分卷表project_id(外键)、volume_no、volume_code(唯一)、retention_periodproject_file附件表project_id、volume_id、file_no、file_name、file_path、pages、file_typeusers用户表username(唯一)、password(SHA-256)、role_id、dept_idrole角色表role_code、role_name、enabledpermission权限表perm_code、perm_name、perm_typerole_permission角色权限关联表role_id、permission_iddept部门表dept_code、dept_name、enabledsys_dict系统字典表dict_type、dict_code、dict_valuesys_template系统模板表template_code、template_type、template_content(JSON)system_log操作日志表user_id、operate_type、module、content、operate_timeproject_cycle项目周期表project_id、template_id、cycle_data(JSON)ai_skillAI 技能表skill_name、category、enabled、display_nameai_workflowAI 工作流表workflow_code、steps(JSON)、trigger_keywords设计亮点project_volume表的UNIQUE(project_id, volume_no)组合唯一约束——同一项目内分卷编号唯一不同项目可重复project_file表的UNIQUE(file_no, volume_id)组合唯一约束——同一分卷内附件编号唯一外键约束ON DELETE CASCADE——删除项目自动级联删除关联的分卷和附件对应源码src/models/db_models.py817 行含建表语句、种子数据、数据库迁移、索引创建五、项目目录结构IAS/ ├── src/ # 源码目录 │ ├── main.py # 应用入口106行 │ ├── ai/ # AI 智能助手模块 │ │ ├── skill_base.py # Skill 框架基类与注册中心 │ │ ├── dialog_manager.py # 对话管理器核心调度引擎 │ │ ├── workflow_engine.py # 工作流引擎7种步骤类型 │ │ ├── template_engine.py # 答复模板引擎60模板 │ │ ├── assistant_init.py # 智能助手初始化 │ │ └── skills/ # Skill 实现 │ │ ├── service_skills.py # 60个服务技能1886行 │ │ └── tool_skills.py # 6个图表技能 │ ├── api/ # 外部 API 封装 │ │ └── LLM_api.py # 大模型 API 客户端 │ ├── dao/ # 数据访问层14个DAO │ │ ├── base_dao.py # DAO 基类通用CRUD模板 │ │ ├── project_dao.py # 项目 DAO │ │ ├── volume_dao.py # 分卷 DAO │ │ └── ... # 其他11个DAO │ ├── models/ # 数据模型层 │ │ └── db_models.py # 数据库定义817行 │ ├── services/ # 业务服务层19个Service │ │ ├── base_service.py # Service 基类 │ │ ├── meta_service.py # 服务注册中心113个服务映射 │ │ ├── project_service.py # 项目管理服务 │ │ ├── archive_export_service.py # 归档导出服务494行 │ │ └── ... # 其他15个Service │ ├── ui/ # UI 界面层 │ │ ├── main_window.py # 主窗口5678行9篇文章精讲 │ │ ├── chat_widget.py # 智能助手聊天界面632行 │ │ ├── login_widget.py # 登录窗口 │ │ ├── manual_dialog.py # 使用手册对话框 │ │ └── styles.py # 全局样式系统 │ └── utils/ # 工具层 │ ├── app_paths.py # 路径工具源码/打包兼容 │ ├── chart_generator.py # Plotly 图表生成 │ └── meta_utils.py # LangChain 工具封装 ├── assets/ # 静态资源 │ ├── logo.ico / logo.png # 应用图标 │ └── plotly.min.js # Plotly JS 库本地渲染用 ├── db/ # 数据库目录 │ └── archive.db # SQLite 数据库文件 ├── storage/ # 文件存储目录 ├── .env # 环境配置不上传含API Key ├── .env.example # 配置模板占位符 ├── requirements.txt # 依赖清单 ├── IAS.spec # PyInstaller Windows 打包配置 ├── IAS_kylin.spec # PyInstaller 银河麒麟打包配置 ├── build.bat # Windows 打包脚本 ├── build_kylin.sh # 银河麒麟打包脚本 ├── run.sh # Linux 启动脚本 ├── LICENSE # MIT 开源许可证 └── README.md # 项目说明源码统计统计项数量Python 源文件45 个代码总行数~18,000 行数据库表15 张AI 技能66 个60 服务技能 6 图表技能答复模板60 个系统服务113 个SERVICE_REGISTRY 映射UI 组件方法100 个main_window.py六、系统界面预览6.1 登录界面系统启动后首先展示登录窗口采用渐变背景 青绿色主题色设计# login_widget.py 核心设计self.setFixedSize(420,380)# 固定尺寸# 渐变背景QDialog{background:qlineargradient(x1:0,y1:0,x2:1,y2:1,stop:0#F7FAFC, stop:0.5 #EDF2F7, stop:1 #E2E8F0);}# 登录按钮渐变QPushButton{background:qlineargradient(x1:0,y1:0,x2:1,y2:1,stop:0#4ECDC4, stop:1 #45B7D1);}6.2 主窗口登录成功后进入主窗口采用 Tab 页布局┌──────────────────────────────────────────────────────────┐ │ 文件 帮助 │ ├──────────────────────────────────────────────────────────┤ │ 当前用户: admin | 角色: 管理员 | 部门: 信息化服务一部 │ ├──────────────────────────────────────────────────────────┤ │ [项目管理] [智能助手] [系统管理] │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ 搜索: [项目编号] [项目名称] [部门▼] [状态▼] [查询] │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ │ │ 编号 名称 经理 部门 预算 状态 操作 │ │ │ │ │ │ P001 智慧政务 张三 一部 200 验收 [档案] │ │ │ │ │ │ P002 数据中台 李四 二部 500 建设 [档案] │ │ │ │ │ │ P003 网络安全 王五 三部 100 采购 [档案] │ │ │ │ │ └─────────────────────────────────────────────────┘ │ │ │ │ [新建项目] [编辑] [删除] │ │ │ └──────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────┘权限控制admin 角色可见三个 Tab 页项目管理、智能助手、系统管理普通用户仅可见两个 Tab 页项目管理、智能助手系统管理 Tab 隐藏# main_window.py 权限控制核心逻辑is_adminself.user.get(role_code)adminifis_admin:self._init_system_management_tab()# 仅 admin 可见系统管理6.3 项目档案管理点击项目列表中的档案按钮进入三级档案管理界面左右分栏布局┌──────────────┬──────────────────────────────────────────┐ │ 分卷列表 │ 附件列表 │ ├──────────────┼──────────────────────────────────────────┤ │ 第一卷 │ 编号 文件名 责任单位 页数 日期 │ │ (120页) │ 0001 立项申请.pdf 办公室 12 2025-01 │ │ │ 0002 可研报告.docx 规划部 35 2025-01 │ │ 第二卷 │ 0003 党委会纪要.pdf 办公室 5 2025-02 │ │ (50页) │ │ │ │ │ │ 第三卷 │ │ │ (20页) │ │ ├──────────────┼──────────────────────────────────────────┤ │ [新建分卷] │ [新增附件] [编辑] [删除] [导出目录] │ │ [编辑] [删除]│ │ └──────────────┴──────────────────────────────────────────┘6.4 智能助手智能助手采用微信风格聊天界面用户消息右侧绿色气泡系统消息左侧白色气泡┌──────────────────────────────────────────────────────┐ │ 智能助手 [清空对话] │ ├──────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────┐ │ │ │ 你好我是智能项目档案 │ │ │ │ 管理助手可以帮你查询 │ │ │ │ 项目、管理档案、生成 │ │ │ │ 统计图表等。 │ │ │ └─────────────────────────┘ │ │ │ │ ┌──────────────────┐ │ │ │ 查询所有项目 │ │ │ └──────────────────┘ │ │ │ │ ┌──────────────────────────────────────────┐ │ │ │ 共找到 3 个项目 │ │ │ │ | 序号 | 编号 | 名称 | 经理 | 部门 | ... | │ │ │ | 1 | P001 | 智慧政务 | 张三 | ... | │ │ │ | 2 | P002 | 数据中台 | 李四 | ... | │ │ └──────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────┐ │ │ │ [Plotly 饼图渲染区] │ │ │ │ 状态分布统计图 │ │ │ └─────────────────────┘ │ │ │ ├──────────────────────────────────────────────────────┤ │ [输入消息...] [发送] │ └──────────────────────────────────────────────────────┘6.5 全局样式系统系统采用统一的 QSSQt Style Sheet样式系统主题色为青绿色#4ECDC4# styles.py 颜色常量体系classStyles:PRIMARY_COLOR#4ECDC4# 主色青绿色PRIMARY_DARK#3dbdb5# 深色变体SECONDARY_COLOR#45B7D1# 辅助色蓝色ACCENT_COLOR#FF6B6B# 强调色珊瑚红SUCCESS_COLOR#67C23A# 成功色WARNING_COLOR#E6A23C# 警告色ERROR_COLOR#F56C6C# 错误色BG_LIGHT#F8FAFC# 浅色背景BG_CARD#FFFFFF# 卡片背景TEXT_PRIMARY#1E293B# 主文本色TEXT_SECONDARY#64748B# 次要文本色BORDER_COLOR#E2E8F0# 边框色对应源码src/ui/styles.py全局 QSS 样式表覆盖 QMainWindow、QWidget、QTabWidget、QTableWidget、QPushButton 等 20 组件。七、系统演示视频暂无八、源码获取与运行8.1 获取源码完整源码已开源至 GitCode仓库地址https://gitcode.com/u010972645/IAS-ProjectArchiveSystem方式一Git 克隆推荐gitclone https://gitcode.com/u010972645/IAS-ProjectArchiveSystem.git方式二下载 ZIP 包访问仓库页面点击下载 ZIP按钮解压即可。8.2 环境准备# 1. 安装 Python 3.10推荐 3.10 或 3.11# 2. 创建虚拟环境python-mvenv venv# 3. 激活虚拟环境# Windows:venv\Scripts\activate# Linux:sourcevenv/bin/activate# 4. 安装依赖pipinstall-rrequirements.txt8.3 配置大模型 API# 复制配置模板cp.env.example .env# 编辑 .env填入你的 API Key# MODEL_API_KEYsk-你的真实API密钥# MODEL_BASE_URLhttps://api.deepseek.com/v1# MODEL_NAMEdeepseek-chat支持 DeepSeek、OpenAI、通义千问等任何 OpenAI 兼容接口。不配置 API Key 也能运行系统只是智能助手功能不可用其他功能全部正常。8.4 启动系统python src/main.py默认登录账号用户名密码角色adminadmin123管理员九、本系列文章规划本系列共 60 篇文章按模块分为 9 大篇章篇章主题范围篇数阅读顺序一、系统总览篇系统介绍、技术栈、目录结构、架构设计、数据库设计5 篇1→2→3→4→5二、数据模型与初始化篇db_models.py 逐行解析3 篇6→7→8三、数据访问层DAO篇BaseDAO 基类、业务 DAO、RBAC DAO4 篇9→10→11→12四、业务服务层篇19 个 Service 逐行精讲10 篇13→…→22五、UI 界面层篇入口、样式、主窗口(9篇)、聊天(2篇)15 篇23→…→37六、AI 智能助手模块篇LLM 客户端、Skill、DialogManager、Workflow12 篇38→…→49七、工具层与图表篇路径工具、图表生成、服务层补充3 篇50→51→52八、打包部署与运维篇Windows 打包、麒麟打包、跨平台兼容4 篇53→54→55→56九、二次开发指南篇新增模块、新增 Skill、自定义模板4 篇57→58→59→60建议阅读顺序1→2→3→4→5→23→24→25→6→9→13先建立整体认知再按层次深入。十、总结本文作为系列开篇从系统定位、技术栈、功能模块、架构设计、目录结构、界面预览、演示建议等多个维度全面介绍了信息化项目全流程管理系统IAS的全貌。系统核心亮点回顾真实项目不是教学 Demo是真实上线运行的政务系统全栈覆盖GUI 数据库 分层架构 AI 集成 跨平台打包AI 深度集成66 个技能 7 步工作流引擎 60 模板 安全隔离架构国产化适配同时支持 Windows 和银河麒麟 V10代码规范四层分层架构、参数化查询、权限校验、操作日志下一篇预告第 2 篇技术栈选型与环境搭建 将详解 PySide6 vs PyQt vs Tkinter 的技术选型理由手把手搭建开发环境逐项解析 requirements.txt 依赖。完整源码获取https://gitcode.com/u010972645/IAS-ProjectArchiveSystem克隆或下载 ZIP 包后配合本系列文章逐行学习。每篇文章标注了对应的源码文件建议边读文章边看代码动手实践效果更佳。本文为 CSDN 付费专栏「AI政务系统开发实战信息化项目全流程管理系统源码逐行精讲」第 1 篇专栏共 60 篇文章逐个文件、逐行代码完整讲解适合有 Python 基础的开发者跟着教程从零搭建同类系统。
)
