《林业部门档案管理软件零基础部署与日常操作实操指南》

准备工作

需提前安装3类基础工具，直接复制对应地址下载安装：

• Git：https://git-scm.com/download/win（Windows）、https://git-scm.com/download/mac（Mac），安装时勾选“添加到PATH”；
• Python3.8+：https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe，安装时勾选“Add Python to PATH”；
• MySQL5.7+：https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.34.0.msi，安装时设置root密码为“LyAdmin@2024”（便于后续配置）。

项目部署步骤

1. 克隆项目代码

打开终端（Windows按Win+R输入cmd，Mac打开终端），执行：

```git clone https://github.com/forestry-admin/forestry-archive.git && cd forestry-archive```

2. 创建虚拟环境并激活

虚拟环境用于隔离项目依赖，执行命令：

```python -m venv venv```

Windows激活虚拟环境：

```venv\Scripts\activate```

Mac/Linux激活虚拟环境：

```source venv/bin/activate```

必须激活虚拟环境，终端提示符前会显示(venv)标识，否则依赖安装会混乱。

3. 安装项目依赖

执行命令安装所有必要包，requirements.txt内容如下，直接复制保存为根目录同名文件：

``` Django==4.2.7 mysqlclient==2.2.0 pillow==10.1.0 django-crispy-forms==2.0 ```

然后执行安装命令：

```pip install -r requirements.txt```

4. 配置数据库连接

在MySQL中创建项目数据库，执行SQL（打开MySQL终端或Navicat）：

```CREATE DATABASE forestry_db DEFAULT CHARACTER SET utf8mb4;```

打开项目根目录下的forestry_archive/settings.py，找到DATABASES节点，完整配置如下：

``` DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'forestry_db', 'USER': 'root', 'PASSWORD': 'LyAdmin@2024', 'HOST': '127.0.0.1', 'PORT': '3306', } } ```

需确保MySQL服务已启动，否则会报错无法连接数据库。

5. 初始化数据库并创建管理员

执行数据库迁移命令生成表结构：

```python manage.py makemigrations```

```python manage.py migrate```

创建后台管理员账号，按提示输入信息：

```python manage.py createsuperuser```

输入示例：用户名admin，邮箱admin@forestry.com，密码LyAdmin@2024

密码需包含字母、数字、特殊字符，长度至少8位，否则无法创建。

6. 启动服务验证

执行启动命令，终端输出对应地址则成功：

```python manage.py runserver```

打开浏览器访问http://127.0.0.1:8000/admin，输入刚才创建的管理员账号，即可进入后台管理页面。

日常操作核心流程

档案录入

登录后台后，点击左侧菜单“档案管理”→“新增档案”，需填写以下必填项：

• 档案编号：按林业规范格式填写，如LY-2024-001；
• 分类：选择对应林业档案类别（营林、采伐、防火等）；
• 日期：档案形成日期；
• 内容：档案核心信息摘要；
• 存储位置：实际存放地点（如档案柜3层A区）。

所有字段填写完成后点击“提交”，即可完成档案录入。

档案查询

在“档案列表”页面，顶部搜索框支持两种查询方式：

• 关键词搜索：输入档案编号、分类、内容中的任意内容，点击“搜索”；
• 高级筛选：点击“筛选”按钮，选择日期范围、分类后筛选结果。

数据备份

为防止数据丢失，需定期执行备份命令，备份文件存放在项目根目录：

```python manage.py dumpdata --exclude auth.permission --exclude contenttypes > backup.json```

每月至少执行1次备份，备份文件需复制到非系统盘的专属文件夹。

常见问题快速解决

• MySQL连接失败：检查settings.py中PORT是否为3306，确认MySQL服务已启动；
• 依赖安装失败：升级pip版本，执行python -m pip install --upgrade pip，重新运行安装命令；
• 数据库迁移报错：删除项目根目录下所有app的migrations文件夹中除__init__.py外的所有文件，重新执行makemigrations和migrate命令；
• 页面无法访问：确认服务启动时的端口是否被占用，更换端口执行python manage.py runserver 8001。