行政裁决档案管理软件从零搭建全流程实操零门槛落地指南

前期准备：环境与依赖安装

1. 安装基础运行环境

本文采用开源轻量方案，零成本适配行政裁决档案的分类存储、权限管控、涉密检索要求，所有步骤零门槛，跟着操作即可落地。首先安装Python 3.10稳定版，直接打开下载地址获取对应系统的安装包：https://www.python.org/ftp/python/3.10.11/

关键注意项：安装时必须勾选「Add Python to PATH」选项，否则后续命令无法运行，安装完成后打开终端（Windows为命令提示符CMD，Mac/Linux为自带终端），输入以下命令验证安装：

``` python --version ```

终端输出Python 3.10.x即为安装成功。接下来安装Git用来拉取源码，不同系统执行对应命令即可：

• Windows（已预装winget）：winget install Git.Git
• Mac（已预装brew）：brew install git
• Debian/Ubuntu Linux：sudo apt install git -y

安装完成后输入git --version，输出版本号即为成功。

2. 获取项目源码

在终端执行以下命令，拉取适配好行政裁决需求的源码：

``` git clone https://gitee.com/OpenTMS/admin-ruling-archive.git cd admin-ruling-archive ```

接下来安装项目依赖，如果安装慢可以使用国内清华源，执行命令：

``` pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt ```

等待依赖安装完成，没有报错即可进入下一步。

核心配置：适配本单位管理需求

1. 修改基础配置文件

用文本编辑器打开项目根目录下的config.py，删除原有内容，替换为以下完整可运行配置，可根据实际需求修改对应参数：

``` import os 服务端口配置，修改为未被占用的端口即可 PORT = 8080 生产部署请保持False，仅本地调试开启True DEBUG = False 加密密钥，生产环境请自行修改为随机字符串 SECRET_KEY = "admin-ruling-archive-2024@your-unit" 档案文件存储配置 实体档案扫描件存储路径，不要放在中文路径下 ARCHIVE_STORAGE_PATH = os.path.join(os.getcwd(), "archive_files") 数据库文件存储路径 DATABASE_PATH = os.path.join(os.getcwd(), "ruling_archive.db") 默认管理员账号密码，部署完成后请立即修改 ADMIN_USERNAME = "admin" ADMIN_PASSWORD = "ChangeMe@2024" ```

关键提醒：不要将存储路径放在带有中文的目录下，否则会出现文件读取失败的问题；必须修改默认管理员密码，避免权限泄露

2. 初始化数据库

配置完成后，在终端执行以下命令，自动生成行政裁决档案所需的数据库表结构：

``` python init_db.py ```

终端输出「行政裁决档案数据库初始化完成」即为操作成功，如有报错请检查前面的Python安装和配置步骤。

启动服务与核心功能操作

1. 启动服务验证

本地测试直接执行以下命令启动：

``` python app.py ```

启动完成后，打开浏览器访问地址 http://127.0.0.1:8080（修改了端口就替换为对应端口），能打开登录页即为部署成功，输入你设置的管理员账号密码即可登录后台。

如果需要部署到单位服务器长期运行，Linux系统执行以下命令让服务后台运行：nohup python app.py &，Windows系统可以使用nssm工具将命令封装为系统服务，实现开机自启动。

2. 核心功能实操步骤

• 档案录入归档：登录后点击左侧菜单「档案录入」，依次填写案件编号、裁决类型、申请人、被申请人、裁决日期、归档人信息，上传裁决文书扫描件（支持PDF、JPG、PNG格式，单文件最大50M），点击「提交归档」后，系统会自动生成唯一档案编码，完成归档。
• 档案检索调阅：点击左侧菜单「档案检索」，可通过案件编号、当事人名称、裁决类型、日期区间四个维度组合筛选，输入关键词后点击搜索，即可调出对应档案，支持在线预览文书，无需下载。
• 权限分工管控：管理员进入「系统设置-用户管理」，可新增经办人、查询人两种角色，经办人仅可录入和修改自己经办的档案，查询人仅可调阅非涉密档案，满足行政裁决档案的保密管理要求。
• 批量导出统计：勾选需要移交的档案，点击「批量导出」，系统会自动将所有文书打包为ZIP压缩包，同时生成包含所有档案元信息的Excel目录，方便移交和统计。

常见卡壳问题解决

• 启动提示端口被占用：打开config.py修改PORT参数为其他未占用端口（如8081），重启服务即可。
• 上传文件提示保存失败：检查存储路径是否有读写权限，路径是否包含中文，修正后重启服务即可。
• 忘记管理员密码：打开项目根目录的reset_pwd.py，修改第2行的新密码，保存后执行python reset_pwd.py即可完成重置。

生产部署安全要求

部署到单位正式环境时，务必完成三个安全配置：1. 修改默认的SECRET_KEY为随机字符串，不要使用默认值；2. 仅开放端口给单位内网访问，不要将服务暴露到公网，符合档案保密规定；3. 定期备份archive_files文件夹和ruling_archive.db文件，避免数据丢失。