项目背景

公司内部测试使用的手机历史不是很多，没有专门纳管。后面随着规模变大，测试手机也越来越多，测试、开发、设计等人员都会借用。时间长了不确定手机都在谁的手里，不方便管理。

测试提出需求，需要有个简单的小系统能进行手机统一管理。

需求有

1、管理员可以进行手机录入、修改、删除、查询等功能。

2、除了手机管理里面，测试、开发、设计等人员可以查看手机列表 、手机借用列表 以及申请手机 三个核心功能

3、测试、开发、设计等人员申请手机之后，自动发送消息（邮件）给管理员。然后找管理员认领手机

4、手机使用完毕归还时，先交还手机给 管理员，然后管理员修改 ”手机借用列表“ 中的对应记录的 ”归还时间“

设计思路

1、定义 Phone 和 BorrowRecord 两个模型

2、利用Django自带的后台快速实现

3、在Django后台自定义action，进行”手机申请“

4、申请按钮点击之后，同步给管理员发送消息（邮箱、钉钉）

进入开发

1、模型定义

这里除了手机序列号，还添加了 手机品牌和手机型号两个属性，便于后续扩展。

另外时间上设计了 采购时间、入库时间和报废时间三个属性。

手机的状态有 空闲中、被借走、已故障三种，当然你可以结合自己实际的情况设置其他状态。

# cmdb/models/phone.py
from django.db import models
from django.contrib.auth import get_user_model


User = get_user_model()


class Phone(models.Model):
    STATUS = (
        ('空闲中', '空闲中'),
        ('被借走', '被借走'),
        ('已故障', '已故障')
    )
    brand = models.CharField(max_length=32, unique=True, verbose_name='手机品牌')
    model = models.CharField(max_length=32, verbose_name='手机型号')
    serial_number = models.CharField(max_length=64, unique=True, verbose_name='手机序列号')
    create_time = models.DateTimeField(auto_now=True, verbose_name='入库时间')
    buy_time = models.DateField(null=True, blank=True, verbose_name='采购时间')
    fault_time = models.DateField(null=True, blank=True, verbose_name='故障时间')
    status = models.CharField(max_length=12, choices=STATUS, default='空闲中', verbose_name='手机状态')

    def __str__(self) -> str:
        return f'{self.model}/{self.serial_number}'
    
    class Meta:
        verbose_name = '测试手机管理'
        verbose_name_plural = verbose_name


class BorrowRecord(models.Model):
    user = models.ForeignKey(User, on_delete=models.SET_NULL, null=True, blank=True, verbose_name='手机借用人')
    phone = models.ForeignKey(Phone, on_delete=models.SET_NULL, null=True, blank=True, verbose_name='借用的手机')
    borrow_date = models.DateTimeField(auto_now_add=True, verbose_name='借用时间')
    return_date = models.DateTimeField(null=True, blank=True, verbose_name='归还时间')

    def __str__(self) -> str:
        return f'{self.user.get_username}/{self.phone.model}'
    
    class Meta:
        verbose_name = '手机借用/归还记录'
        verbose_name_plural = verbose_name

2、进行配置和绑定应用

# 配置可访问主机IP
ALLOWED_HOSTS = ['127.0.0.1']

# 绑定应用到项目
INSTALLED_APPS = [
    ... ...
    'cmdb'
]

# 设置 templates 根目录
# 默认会从 appname/templates/appname 目录寻找 （'APP_DIRS': True 参数决定）
TEMPLATES = [
    ... ...
    'DIRS': [os.path.join(BASE_DIR, 'templates')],
    ... ...
]

这里是项目演示，所以数据库使用默认的 Sqlite 数据库即可

3、后台的自定义

因为是借助于Django自带后台快速开发一个简易版手机管理系统，所有手机的管理和用户的借用都是在 Django默认后台实现的。

默认创建模型之后，在应用的 admin.py中进行绑定，然后就可以通过 自带的后台进行模型的管理，比如这里的 手机和手机借用记录的管理。

但是默认是没有”申请借用“的功能的，这个就需要我们开发对应的功能，并且添加到Django Admin后台去。

核心知识: 通过继承admin.ModelAdmin来实现自定义 模型的ModelAdmin 行为 （展示、搜索、排序、方法等）

这里先给出代码，然后进行代码分析

# cmdb/admin.py
from django.contrib import admin, messages
from cmdb.models import BorrowRecord, Phone
from django.http import HttpResponseRedirect
from django.urls import reverse


class PhoneAdmin(admin.ModelAdmin):
    list_display = ('brand', 'model', 'serial_number', 'fault_time', 'create_time', 'status', 'fault_time')
    list_filter = ('brand', 'status')
    search_fields = ('status', 'model', 'serial_number')
    actions = ['apply_for_borrow']
    def apply_for_borrow(self, request, queryset):
        if len(queryset) > 1:
            self.message_user(request, '抱歉，每次只能申请一台手机', level=messages.ERROR)
        else:
            if queryset[0].status != '空闲中':
                self.message_user(request, '抱歉，不能选择已故障或者被借走的手机', level=messages.ERROR)
            else:
                obj = queryset[0]
                next_url = '/admin/cmdb/phone/'
                base_url = reverse('cmdb:borrow-phone', kwargs={'pk': obj.id})
                borrow_url = f'{base_url}?next={next_url}'
                return HttpResponseRedirect(borrow_url)
    apply_for_borrow.short_description = '申请借用'


class BorrowRecordAdmin(admin.ModelAdmin):
    list_display = ('phone', 'user', 'borrow_date', 'return_date')
        
# Register your models here.
admin.site.register(Phone, PhoneAdmin)
admin.site.register(BorrowRecord, BorrowRecordAdmin)

上面定义了 PhoneAdmin 和 BorrowRecordAdmin 两个ModelAdmin类，然后通过 admin.site.register 把 ModelAdmin 类绑定到 模型上，注册到Django的后台去。

其中

• list_display
• list_filter
• search_fields
• actions 存放自定义的”操作性方法“，比如我们需要的 ”申请借用“ 的功能

这里在 PhoneAdmin 中定义方法 apply_for_borrow， 在这个方法中我们进行”申请借用“ 资源的限制 （因为是从后台选择定义然后进行处理）

3.1、每次只能选择一个手机 len(queryset) 只能等于1

3.2、选择的手机状态只能是 ”空闲中“ 的

3.3、选择 ”一个空闲中“的手机之后，跳转到 ”借用“逻辑处理的view视图，进行实际的借用逻辑处理。

3.4、这里做了个特殊的处理，就是借用逻辑处理完毕之后，再跳回到当前后台的手机记录页面。

4、借用逻辑开发

这里先给出完整代码，然后进行分析说明

# cmdb/views.py
from django.shortcuts import render, HttpResponse, redirect
from django.contrib.auth.decorators import login_required
from cmdb.models import Phone, BorrowRecord
from django.utils import timezone
from django.http import HttpResponseRedirect
from django.contrib import messages


@login_required
def borrow_phone(request, pk):
    """
    申请借用手机视图
    """
    phone = Phone.objects.get(pk=pk)
    pr = BorrowRecord()
    pr.user = request.user
    pr.borrow_date = timezone.now()
    pr.phone = phone
    pr.save()
    
    phone.status = '被借走'
    phone.save()
    
    messages.success(request, '手机借用成功')
    return redirect(request.GET.get('next', 'admin:index'))

4.1、这里先获取到待借用的手机 （phone = Phone.objects.get(pk=pk)）

4.2、然后新增借用记录 15到19行，其中配置了借用人（request.user）、借用时间 （timezone.now() 当期时间）已经借用的手机，就是第14行获取到的手机。

4.3、同时记得修改手机的状态，从 “空闲中“ 修改为 "被借走"

4.4、这里额外使用的 Django的message机制，通过它可以在Django后台进行页面消息提示 （第24行）

4.5、最后根据获取到的next 跳转回到之前的页面。

5、消息通知开发

这是主要是通过发送邮件，让管理员知道“谁在借用手机，借用的是哪个手机”，好提前做准备。

具体功能也是通过Django的 send_mail 函数来实现。

5.1、settings配置

# proj/settings.py
# 配置邮件信息
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.qiye.163.com'
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = 'ops@colinspace.com'
EMAIL_HOST_PASSWORD = 'xxxxxxxx'
DEFAULT_FROM_EMAIL = 'ops@colinspace.com'
# 管理员邮箱
ADMIN_EMAIL = 'admin@colinspace.com'

5.2、views中借用逻辑修改

# cmdb/views.pu
@login_required
def borrow_phone(request, pk):
    """
    申请借用手机视图
    """
    ... ...

    # 发送邮件逻辑
    subject = f'[{request.user}] 申请借用手机'
    message = f'[{request.user}] 申请借用手机 ({phone.brand} - {phone.model} - {phone.serial_number})'
    recipient_list = [settings.ADMIN_EMAIL]
    send_mail(subject, message, settings.DEFAULT_FROM_EMAIL, recipient_list)
    
    messages.success(request, '手机借用成功')
    return redirect(request.GET.get('next', 'admin:index'))

然后普通用户在后台申请借用手机之后，管理员就会收到如下的邮件信息

image.png

6、权限管控配置

主要是在Django Admin后台新增用户的时候，配置相关权限（User permissions） 如下图所示

image.png

只给 两个视图的view（查看）权限即可。

在ModelAdmin类中定义的方法，是没有做权限限制的

每个人都可以使用申请借用的功能

下图所示是普通用户James登录看到的效果，他只有 两个视图的view的权限

看到左侧没有”➕“ 不能新增模型记录，然后在列表的action中，只有 ”申请借用“ 选项，而没有默认的 ”Deleted select 测试手机管理“ 选项。

image.png

通过如上的开发和配置，我们就实现测试提出的 手机管理系统的基本需求。

然后给服务配置域名，就可以交付给测试组进行使用了。是不是很快就上手了一个小系统呢~

系统的详细代码详见 https://gitee.com/colin5063/django-examples/tree/main/django_phone_management （复制到浏览器再打开哦）

克隆到本地之后，按照 django_phone_management/ReadMe.md 提示进行操作即可运行项目。

有问题及时反馈哦~

如果你觉得有所收获，欢迎关注公众号"菩提老鹰"进行点赞和喜欢哦~

一起交流，分享知识，快乐生活，我是老鹰，我们下一期见~