从零搭建可直接落地使用的标本数字档案馆系统实操指南

一、前期环境准备

本系统基于Python+Django开发，零门槛部署，仅需准备2个基础工具：

• Python 3.10（兼容3.9-3.12版本），下载地址：https://www.python.org/downloads/release/python-31011/，安装时必须勾选「Add Python to PATH」选项，这是最常见的卡壳点。
• 命令行工具：Windows按Win+R输入cmd回车即可打开，Mac直接打开终端即可，无需额外安装。

二、项目依赖安装

打开命令行工具，依次执行以下命令，每一步等待执行完成再进行下一步：

``` 创建项目文件夹并进入 mkdir specimen-archive && cd specimen-archive 创建虚拟环境（避免依赖冲突） python -m venv venv 激活虚拟环境（Windows执行这行） venv\Scripts\activate 激活虚拟环境（Mac/Linux执行这行，把上面一行注释掉） source venv/bin/activate 安装所有核心依赖 pip install django==4.2 djangorestframework==3.14.0 django-filter==23.3 pillow==10.1.0 ```

激活成功后命令行前缀会出现(venv)标识，如果没有说明Python没有添加到系统PATH，需要重新安装Python。

三、项目初始化与核心配置

3.1 初始化项目结构

在激活虚拟环境的状态下，执行以下命令初始化项目：

``` django-admin startproject archive_system . python manage.py startapp specimen ```

执行完成后会自动生成所有项目基础目录。

3.2 修改核心配置文件

用文本编辑器打开archive_system/settings.py，找到INSTALLED_APPS配置项，替换为以下完整可复制内容：

``` INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 新增以下配置 'rest_framework', 'specimen', ] 文件末尾新增以下配置 MEDIA_URL = '/media/' MEDIA_ROOT = BASE_DIR / 'media' STATIC_ROOT = BASE_DIR / 'static' ```

接下来打开archive_system/urls.py，替换全部内容为以下代码：

``` from django.contrib import admin from django.urls import path from django.conf import settings from django.conf.urls.static import static urlpatterns = [ path('admin/', admin.site.urls), ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) ```

以上配置完成了标本扫描件存储、静态资源路径的配置，不需要修改任何参数即可直接使用。

四、核心数据模型搭建

打开specimen/models.py，替换全部内容为以下代码，该模型已经覆盖标本档案的核心存储需求：

``` from django.db import models class Specimen(models.Model): specimen_no = models.CharField(max_length=50, unique=True, verbose_name='标本编号') name = models.CharField(max_length=100, verbose_name='标本名称') category = models.CharField(max_length=50, verbose_name='标本分类') store_location = models.CharField(max_length=100, verbose_name='存放位置') collect_date = models.DateField(verbose_name='采集日期', null=True, blank=True) scan_file = models.FileField(upload_to='specimen_scan/', verbose_name='档案扫描件', null=True, blank=True) description = models.TextField(verbose_name='备注描述', null=True, blank=True) create_time = models.DateTimeField(auto_now_add=True, verbose_name='录入时间') class Meta: verbose_name = '标本档案' verbose_name_plural = verbose_name ordering = ['-create_time'] ```

接下来执行数据库迁移，创建数据表，依次执行命令：

``` python manage.py makemigrations python manage.py migrate ```

然后创建后台管理的超级管理员账号，执行命令：

``` python manage.py createsuperuser ```

按照提示输入用户名、邮箱、密码即可，输入密码时命令行不会显示字符，属于正常现象，输入完成回车即可，密码要求长度不小于8位。

五、后台管理功能配置

打开specimen/admin.py，替换全部内容为以下代码，即可实现可直接用的标本档案管理后台：

``` from django.contrib import admin from .models import Specimen @admin.register(Specimen) class SpecimenAdmin(admin.ModelAdmin): list_display = ('specimen_no', 'name', 'category', 'store_location', 'collect_date', 'create_time') search_fields = ('specimen_no', 'name', 'category') list_filter = ('category', 'collect_date') ```

该配置已经默认开启了编号、名称搜索，分类、日期筛选，满足日常档案管理需求。

六、启动验证

执行启动命令：

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

打开浏览器，输入地址http://127.0.0.1:8000/admin，输入刚才创建的超级管理员账号密码，登录后即可看到「标本档案」管理入口，你可以直接新增标本信息、上传扫描件、搜索筛选已有档案，系统已经可以正常使用。

七、长期部署（可选）

如果需要长期外网访问，可以把项目部署到云服务器，执行以下步骤：

1. 安装生产服务器依赖：pip install gunicorn
2. 收集静态文件：python manage.py collectstatic
3. 添加Nginx配置，替换以下内容到你的Nginx配置文件：

   ```
   server {
   listen 80;
   server_name 你的服务器IP或域名;
   location /static/ {
   root /你的项目绝对路径/specimen-archive;
   }
   location /media/ {
   root /你的项目绝对路径/specimen-archive;
   }
   location / {
   proxy_pass http://127.0.0.1:8000;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   }
   }
   ```
   

4. 重启Nginx，用gunicorn archive_system.wsgi:application -b 127.0.0.1:8000启动服务即可。

整个系统已经完成核心功能开发，所有步骤都可以直接复制操作，不需要额外编写代码即可落地使用，可支持上万份标本档案的存储管理。