手把手教你用Python搭建实物档案管理系统

发布时间: 2026年09月15日 13:50:01 来源: 安答联动浏览量: 0

环境搭建与项目初始化

在开始构建实物档案管理系统之前，我们需要准备一个干净且独立的Python开发环境。本系统基于Python 3.9和Django 4.2 LTS框架开发，数据库使用SQLite，无需额外安装数据库服务，确保零门槛快速启动。

在终端中执行以下命令创建项目目录并激活虚拟环境：

 创建项目文件夹
mkdir archive_system
cd archive_system
创建虚拟环境
python -m venv venv
激活虚拟环境（Windows用户）
venv\Scripts\activate
激活虚拟环境（Mac/Linux用户）
source venv/bin/activate

环境激活后，安装Django框架。为了确保稳定性，我们指定具体的版本号：

pip install django==4.2.7

接下来，初始化Django项目和应用。我们将项目命名为config，核心功能应用命名为core：

 创建Django项目
django-admin startproject config .
创建核心应用
python manage.py startapp core

项目创建完成后，必须将core应用注册到项目中。打开config/settings.py文件，找到INSTALLED_APPS列表，在末尾添加'core'：

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'core',   新增这一行
]

设计实物档案管理数据模型

数据模型是系统的核心。对于实物档案管理，我们需要记录档案的名称、编号、物理存放位置、状态以及入库时间。打开core/models.py文件，将原有代码替换为以下完整代码：

from django.db import models
class ArchiveItem(models.Model):
STATUS_CHOICES = [
('in_stock', '在库'),
('borrowed', '借出'),
('lost', '遗失'),
('maintenance', '维护中'),
]
档案名称
name = models.CharField(max_length=200, verbose_name="档案名称")
档案唯一编号（如条形码或RFID码）
archive_code = models.CharField(max_length=50, unique=True, verbose_name="档案编号")
档案分类
category = models.CharField(max_length=100, verbose_name="档案分类")
物理存放位置（如：A区-01架-02层）
physical_location = models.CharField(max_length=100, verbose_name="物理位置")
档案当前状态
status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='in_stock', verbose_name="状态")
入库时间
entry_date = models.DateTimeField(auto_now_add=True, verbose_name="入库时间")
备注
remarks = models.TextField(blank=True, null=True, verbose_name="备注")
class Meta:
verbose_name = "实物档案"
verbose_name_plural = "实物档案"
ordering = ['-entry_date']
def __str__(self):
return f"{self.archive_code} - {self.name}"

模型定义完成后，需要执行数据库迁移命令以生成对应的数据表。在终端依次执行：

python manage.py makemigrations
python manage.py migrate

配置后台管理界面

Django自带强大的后台管理系统，我们只需进行简单配置即可实现档案的增删改查。为了提升操作效率，我们将配置列表展示字段、搜索功能和筛选器。

打开core/admin.py文件，输入以下代码：

手把手教你用Python搭建实物档案管理系统

from django.contrib import admin
from .models import ArchiveItem
@admin.register(ArchiveItem)
class ArchiveItemAdmin(admin.ModelAdmin):
列表页展示的字段
list_display = ('archive_code', 'name', 'category', 'physical_location', 'status', 'entry_date')
每页显示的记录数
list_per_page = 20
启用顶部搜索框，支持按编号、名称和位置搜索
search_fields = ('archive_code', 'name', 'physical_location')
启用右侧筛选栏，可按状态和分类快速过滤
list_filter = ('status', 'category', 'entry_date')
点击字段即可进入编辑页面
list_display_links = ('archive_code', 'name')
在详情页中，将字段分组显示，使界面更整洁
fieldsets = (
('基本信息', {
'fields': ('name', 'archive_code', 'category')
}),
('管理信息', {
'fields': ('physical_location', 'status', 'remarks')
}),
)