1. 项目背景与核心需求
农产品库存管理系统是农业信息化建设中的重要一环。我在去年参与某县域农业合作社的数字化改造时，亲眼目睹了他们还在用纸质台账记录库存的窘境——经常出现账实不符、临期产品未及时处理、采购决策缺乏数据支持等问题。这正是我们选择用Django开发农产品库存管理系统的现实意义所在。
这个毕业设计项目需要解决几个核心痛点：
- 农产品具有季节性、易腐性等特殊属性，需要区别于普通商品的库存管理逻辑
- 中小型农业企业通常缺乏专业IT团队，系统必须足够简单易用
- 需要适应不同角色的操作需求：仓库管理员关注出入库，财务人员需要报表，经营者要看数据分析
提示：农产品库存系统与常规ERP的最大区别在于需要特别关注保质期管理和批次追溯，这在后续数据库设计中要重点考虑。
2. 技术选型与架构设计
2.1 为什么选择Django框架
经过对比Flask、FastAPI等Python框架后，我们最终选择Django的原因有三：
-
开箱即用的Admin后台：内置的Django Admin可以快速搭建基础CRUD界面，这对初期原型开发特别重要。通过简单配置就能实现带权限管理的操作界面，比从零开发节省至少60%时间。
-
完善的ORM支持：农产品涉及多表关联（产品表、仓库表、批次表等），Django ORM的ForeignKey、ManyToManyField等关系字段能完美映射这些业务关系。例如定义产品与仓库的关系：
python复制class Product(models.Model):
name = models.CharField(max_length=100)
shelf_life = models.IntegerField() # 保质期天数
class Warehouse(models.Model):
location = models.CharField(max_length=200)
products = models.ManyToManyField(Product, through='Inventory')
- 成熟的生态体系：Django-REST-framework便于后续扩展API，django-crispy-forms能快速美化表单，这些第三方包在开发中能显著提升效率。
2.2 系统架构设计
采用经典的三层架构：
- 表现层：基于Bootstrap的前端界面 + Django模板引擎
- 业务逻辑层：Django视图处理核心业务规则
- 数据访问层：Django ORM + PostgreSQL数据库
特别在数据库设计时，我们为农产品增加了几个关键字段：
python复制class Inventory(models.Model):
product = models.ForeignKey(Product)
warehouse = models.ForeignKey(Warehouse)
batch_number = models.CharField(max_length=50) # 批次号
production_date = models.DateField() # 生产日期
expiry_date = models.DateField() # 过期日期（根据生产日期+保质期自动计算）
current_stock = models.DecimalField(max_digits=10, decimal_places=2)
3. 核心功能实现细节
3.1 智能预警模块开发
农产品的临期预警是核心功能。我们在models.py中编写了自定义方法：
python复制from django.db import models
from datetime import date, timedelta
class Inventory(models.Model):
# ...其他字段...
@property
def expiry_status(self):
remaining_days = (self.expiry_date - date.today()).days
if remaining_days < 0:
return '已过期'
elif remaining_days <= 3:
return '紧急'
elif remaining_days <= 7:
return '预警'
return '正常'
然后在admin.py中配置列表显示和自动过滤：
python复制from django.contrib import admin
@admin.register(Inventory)
class InventoryAdmin(admin.ModelAdmin):
list_display = ('product', 'batch_number', 'expiry_date', 'expiry_status')
list_filter = ('expiry_status',)
3.2 出入库流水设计
采用"事务"思想确保库存变更的原子性：
python复制from django.db import transaction
@transaction.atomic
def stock_in(product_id, warehouse_id, quantity, batch_info):
try:
product = Product.objects.get(pk=product_id)
warehouse = Warehouse.objects.get(pk=warehouse_id)
# 创建库存记录
inventory = Inventory.objects.create(
product=product,
warehouse=warehouse,
**batch_info
)
# 记录流水
TransactionLog.objects.create(
inventory=inventory,
type='IN',
quantity=quantity,
operator=request.user
)
return True
except Exception as e:
transaction.set_rollback(True)
raise e
4. 关键问题与解决方案
4.1 并发库存更新问题
当多个用户同时操作同一商品库存时，会出现竞态条件。我们采用Django的select_for_update实现行级锁：
python复制from django.db import transaction
@transaction.atomic
def update_stock(inventory_id, delta):
inventory = Inventory.objects.select_for_update().get(pk=inventory_id)
inventory.current_stock += delta
inventory.save()
4.2 数据报表性能优化
农产品需要按日/周/月生成销售和库存报表。我们使用Django的annotate和aggregate实现高效统计：
python复制from django.db.models import Sum, F, ExpressionWrapper, fields
daily_report = TransactionLog.objects.filter(
date__range=(start_date, end_date)
).values('date').annotate(
total_in=Sum('quantity', filter=Q(type='IN')),
total_out=Sum('quantity', filter=Q(type='OUT')),
turnover=ExpressionWrapper(
Sum(F('quantity') * F('inventory__product__price')),
output_field=fields.DecimalField()
)
)
5. 项目部署实践
5.1 宝塔面板部署要点
-
Python项目管理器中：
- 选择Python版本（建议3.8+）
- 启动方式选uWSGI
- 勾选"安装项目依赖"
-
Nginx配置关键参数：
nginx复制location /static/ {
alias /path/to/your/static/;
expires 30d;
}
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:8000;
}
5.2 常见部署问题排查
问题1：静态文件404错误
- 解决方案：确保执行了
python manage.py collectstatic - 检查Nginx配置中的alias路径是否正确
问题2：数据库连接失败
- 检查settings.py中的数据库配置
- PostgreSQL需要额外安装psycopg2-binary包
6. 毕业设计扩展建议
-
移动端适配：使用Django REST Framework开发API，配合Vue.js或React Native实现移动端应用
-
物联网集成：通过RFID或二维码实现农产品批次自动识别，增加溯源功能
-
数据分析模块：集成Pandas和Matplotlib，实现销售预测和库存优化建议
注意：在论文写作时，建议用UML图展示系统架构，用E-R图说明数据库设计，并附上关键模块的流程图。实测数据最好来自真实农场或合作社的运营数据。