一、准备运行环境

操作系统：Windows 10/11 或 macOS 10.15+，需安装 Python 3.8 及以上版本。执行以下命令验证版本：

```python --version```

若未安装，直接从官方地址下载对应版本：Windows 64位下载地址：https://www.python.org/ftp/python/3.11.4/python-3.11.4-amd64.exe；macOS 下载地址：https://www.python.org/ftp/python/3.11.4/python-3.11.4-macos11.pkg。安装时务必勾选“Add Python to PATH”，完成后打开命令提示符（Windows）或终端（macOS），执行依赖安装命令：

```pip install flask flask-sqlalchemy flask-wtf python-dotenv```

等待依赖安装完成，无报错即为环境就绪。

二、创建项目核心文件

新建文件夹命名为admin_mediation_archive，在该文件夹内新建3个核心文件和1个子文件夹：app.py、config.py、.env、templates（用于存放前端页面）。

2.1 配置文件（config.py）

完整代码直接复制，无修改需求：

```python import os from dotenv import load_dotenv load_dotenv() class Config: SECRET_KEY = os.getenv('SECRET_KEY', 'admin_mediation_2024') SQLALCHEMY_DATABASE_URI = os.getenv('DATABASE_URL', 'sqlite:///./mediation.db') SQLALCHEMY_TRACK_MODIFICATIONS = False ```

2.2 应用核心代码（app.py）

完整代码直接复制，可直接运行：

```python from flask import Flask, render_template, request, redirect, url_for from flask_sqlalchemy import SQLAlchemy from flask_wtf import FlaskForm from wtforms import StringField, TextAreaField, DateField, SubmitField from wtforms.validators import DataRequired app = Flask(__name__) app.config.from_object('config.Config') db = SQLAlchemy(app) 行政调解档案数据库模型 class MediationArchive(db.Model): id = db.Column(db.Integer, primary_key=True) case_no = db.Column(db.String(50), nullable=False, unique=True) party_a = db.Column(db.String(100), nullable=False) party_b = db.Column(db.String(100), nullable=False) mediation_date = db.Column(db.Date, nullable=False) content = db.Column(db.Text, nullable=False) result = db.Column(db.Text, nullable=False) 档案录入表单定义 class ArchiveForm(FlaskForm): case_no = StringField('案件编号', validators=[DataRequired()]) party_a = StringField('申请人', validators=[DataRequired()]) party_b = StringField('被申请人', validators=[DataRequired()]) mediation_date = DateField('调解日期 (YYYY-MM-DD)', validators=[DataRequired()]) content = TextAreaField('调解内容', validators=[DataRequired()]) result = TextAreaField('调解结果', validators=[DataRequired()]) submit = SubmitField('提交') 初始化数据库（仅需执行一次） with app.app_context(): db.create_all() 首页路由：录入+查询 @app.route('/', methods=['GET', 'POST']) def index(): form = ArchiveForm() if form.validate_on_submit(): new_archive = MediationArchive( case_no=form.case_no.data, party_a=form.party_a.data, party_b=form.party_b.data, mediation_date=form.mediation_date.data, content=form.content.data, result=form.result.data ) db.session.add(new_archive) db.session.commit() return redirect(url_for('index')) archives = MediationArchive.query.all() return render_template('index.html', form=form, archives=archives) if __name__ == '__main__': app.run(host='0.0.0.0', port=5000, debug=True) ```

2.3 环境变量文件（.env）

完整内容直接复制，无需修改：

``` SECRET_KEY=admin_mediation_2024 DATABASE_URL=sqlite:///./mediation.db ```

2.4 前端模板（templates/index.html）

在templates文件夹内新建index.html，完整代码：

```html 行政调解档案管理系统

---

档案录入

{{ form.hidden_tag() }}

{{ form.case_no.label }} {{ form.case_no() }}

{{ form.party_a.label }} {{ form.party_a() }}

{{ form.party_b.label }} {{ form.party_b() }}

{{ form.mediation_date.label }} {{ form.mediation_date() }}

{{ form.content.label }} {{ form.content(rows=5) }}

{{ form.result.label }} {{ form.result(rows=3) }}

{{ form.submit() }}

---

已录入档案

{% for archive in archives %} {% endfor %} ```

三、启动并使用系统

打开命令提示符/终端，进入admin_mediation_archive文件夹，按顺序执行以下3条命令：

1. 验证文件完整性：执行dir（Windows）或ls（macOS），应显示app.py、config.py、.env、templates文件夹
2. 初始化数据库（仅需执行一次）：执行python app.py，看到终端输出数据库创建信息后，按Ctrl+C停止服务
3. 启动服务：再次执行python app.py

服务启动后，在浏览器输入地址：http://localhost:5000，即可访问系统。

四、核心操作细节

4.1 录入档案

所有表单字段必须完整填写，日期需为YYYY-MM-DD格式（如2024-05-20），点击“提交”后自动跳转，页面会显示新增的档案记录。

4.2 查看档案

系统自动展示所有已录入档案，无需额外操作，每条记录包含案件编号、当事人、日期、内容和结果，可直接查看。

五、可选扩展：导出档案为Excel

如需导出档案，先安装依赖：pip install pandas openpyxl，在app.py末尾添加以下路由：

```python from flask import send_file import pandas as pd import io @app.route('/export') def export(): archives = MediationArchive.query.all() data = [{ '案件编号': a.case_no, '申请人': a.party_a, '被申请人': a.party_b, '调解日期': a.mediation_date.strftime('%Y-%m-%d'), '调解内容': a.content, '调解结果': a.result } for a in archives] df = pd.DataFrame(data) output = io.BytesIO() with pd.ExcelWriter(output, engine='openpyxl') as writer: df.to_excel(writer, index=False, sheet_name='行政调解档案') output.seek(0) return send_file(output, as_attachment=True, download_name='行政调解档案.xlsx') ```

重启服务后，修改templates/index.html的

标签后添加导出按钮：

```html 导出Excel ```

再次启动服务后，页面右上角会显示“导出Excel”按钮，点击即可下载所有档案的Excel文件。