综合档案管理系统一体化管理：从零搭建分步实操技术指南

环境准备

安装必需工具

1. 安装Python3.9（适配所有依赖），直接执行对应命令：

```bash Ubuntu/Debian系统 sudo apt update && sudo apt install python3.9 python3.9-venv python3-pip -y Windows系统直接下载：https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe，安装时勾选Add Python to PATH ```

2. 创建项目隔离环境，避免依赖冲突：

```bash python3.9 -m venv arch_venv source arch_venv/bin/activate Linux/Mac执行 arch_venv\Scripts\activate Windows执行 ```

3. 安装核心依赖：

```bash pip install django==4.2.7 django-simple-history==3.4.0 Pillow==10.1.0 ```

系统初始化与基础配置

创建Django项目与档案应用

1. 执行命令初始化项目和应用：

```bash django-admin startproject arch_integrate cd arch_integrate python manage.py startapp archive ```

2. 配置项目settings.py（完整可复制）：

```python arch_integrate/settings.py核心配置 INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'archive', 'simple_history', ] MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.common.CommonMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', 'simple_history.middleware.HistoryRequestMiddleware', ] DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / 'db.sqlite3', } } LANGUAGE_CODE = 'zh-hans' TIME_ZONE = 'Asia/Shanghai' DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField' ```

3. 创建档案模型（archive/models.py，核心字段完整）：

```python from django.db import models from simple_history.models import HistoricalRecords class ArchiveCategory(models.Model): name = models.CharField(max_length=50, unique=True, verbose_name='分类名称') code = models.CharField(max_length=20, unique=True, verbose_name='分类编码') parent = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, verbose_name='上级分类') is_active = models.BooleanField(default=True, verbose_name='是否启用') class Meta: verbose_name = '档案分类' verbose_name_plural = '档案分类' class ArchiveRecord(models.Model): title = models.CharField(max_length=200, verbose_name='档案标题') category = models.ForeignKey(ArchiveCategory, on_delete=models.PROTECT, verbose_name='所属分类') file = models.FileField(upload_to='archives/%Y/%m/', verbose_name='档案文件') create_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间') operator = models.CharField(max_length=50, verbose_name='操作人') history = HistoricalRecords() class Meta: verbose_name = '档案记录' verbose_name_plural = '档案记录' ```

一体化管理核心功能实现

分类与归集一体化规则配置

重点操作：确保分类层级关联正确，归档时自动匹配编码规则

1. 创建分类初始化脚本（archive/management/commands/init_categories.py）：

```python from django.core.management.base import BaseCommand from archive.models import ArchiveCategory class Command(BaseCommand): help = '初始化标准档案分类' def handle(self, args, options): 一级分类创建 business = ArchiveCategory.objects.create(name='业务档案', code='BUS') admin = ArchiveCategory.objects.create(name='行政档案', code='ADM') 二级分类关联创建 ArchiveCategory.objects.create(name='合同档案', code='BUS_CON', parent=business) ArchiveCategory.objects.create(name='人事档案', code='ADM_PE', parent=admin) self.stdout.write(self.style.SUCCESS('分类初始化完成')) ```

2. 执行脚本生成分类：

```bash python manage.py init_categories ```

一体化检索接口配置

在archive/views.py添加通用检索接口，支持按标题、分类编码过滤：

```python from django.http import JsonResponse from django.views.decorators.http import require_GET from archive.models import ArchiveRecord @require_GET def search_archive(request): keyword = request.GET.get('keyword', '') category_code = request.GET.get('category', '') records = ArchiveRecord.objects.filter(title__icontains=keyword) if category_code: records = records.filter(category__code=category_code) data = [{'title': r.title, 'file_url': r.file.url, 'operator': r.operator} for r in records] return JsonResponse({'code': 0, 'total': len(data), 'data': data}) ```

配置项目URL路由（arch_integrate/urls.py）：

```python from django.contrib import admin from django.urls import path from archive.views import search_archive urlpatterns = [ path('admin/', admin.site.urls), path('api/archive/search/', search_archive, name='archive_search'), ] ```

测试与一体化部署

核心功能测试

1. 启动开发服务，验证基础功能：

```bash python manage.py runserver 0.0.0.0:8000 ```

2. 创建后台管理员账号：

```bash python manage.py createsuperuser ```

3. 验证步骤：访问http://localhost:8000/admin上传档案，调用检索接口http://localhost:8000/api/archive/search/?keyword=合同，确认返回对应档案，一体化管理生效。

中小团队轻量部署

1. 安装uWSGI作为服务器：

```bash pip install uwsgi ```

2. 创建uWSGI配置文件（uwsgi.ini，修改为你的项目路径）：

```ini [uwsgi] http = 0.0.0.0:8000 chdir = /home/yourname/arch_integrate wsgi-file = arch_integrate/wsgi.py processes = 2 threads = 4 virtualenv = /home/yourname/arch_venv master = true pidfile = uwsgi.pid daemonize = uwsgi.log ```

3. 启动服务：

```bash uwsgi --ini uwsgi.ini ```