数据库及实现

主题

数据表创建 ​

字数
1691 字
阅读时间
8 分钟

示例选题介绍 ​

本平台是一个简单的宠物领养系统，主要功能包括：

  • 展示可供领养的宠物信息，允许用户申请领养或取消申请；
  • 后台管理员管理宠物信息并审核领养请求。

下图展示了本系统的数据库表结构： 数据库表结构

users 表（用户信息） ​

Django 默认的用户模型 User 基于 AbstractUser 类进行扩展，提供了身份验证、权限管理和用户信息存储等功能。以下是基于 User 模型扩展的 users 表字段说明：

字段名类型非空唯一默认值
idSERIAL是是自动递增
usernameVARCHAR(150)是是-
passwordVARCHAR(128)是否-
emailVARCHAR(254)是是-
first_nameVARCHAR(30)否否-
last_nameVARCHAR(30)否否-
phone_numberVARCHAR(11)否否-
addressVARCHAR(255)否否-
is_staffBOOLEAN是否FALSE
is_superuserBOOLEAN否否FALSE
is_activeBOOLEAN是否TRUE
date_joinedTIMESTAMP是否CURRENT_TIMESTAMP

用户信息表基于 Django 默认用户模型进行扩展，旨在支持区分普通用户与具有后台管理权限的管理员。该表记录每个用户的基本信息，确保 username 和 email 字段唯一，以便通过这些字段唯一标识用户。字段 is_staff 和 is_superuser 用于区分普通用户与拥有管理权限的用户，而 is_active 表示用户账户的活动状态。字段 date_joined 用于记录用户的注册时间。

pets 表（宠物信息） ​

字段名类型非空唯一默认值
idSERIAL是是自动递增
nameVARCHAR(100)是否-
ageINT是否-
speciesVARCHAR(100)是否-
descriptionTEXT否否-
statusVARCHAR(20)是否CHECK 约束限制
created_atTIMESTAMP是否CURRENT_TIMESTAMP
updated_atTIMESTAMP是否CURRENT_TIMESTAMP

宠物信息表记录了每只宠物的基本信息及其领养状态。表中的 status 字段通过 CHECK 约束限定可能的值为 available（可领养）或 adopted（已领养）。此外，created_at 和 updated_at 字段分别记录了宠物信息的创建时间和最后更新时间，确保信息的时效性和一致性。

adoption_requests 表（领养申请） ​

字段名类型非空唯一默认值
idSERIAL是是自动递增
user_idINT是否外键 → users(id)
pet_idINT是否外键 → pets(id)
statusVARCHAR(20)是否CHECK约束限制
created_atTIMESTAMP是否CURRENT_TIMESTAMP
updated_atTIMESTAMP是否CURRENT_TIMESTAMP

领养申请表记录了每个用户对宠物的领养申请。表中的 user_id 和 pet_id 组合为唯一约束，确保一个用户不能对同一只宠物提交多个领养申请。字段 status 通过 CHECK 约束限定了状态的可能值为 pending（待审核）、approved（已批准）或 cancelled（已取消）。此外，created_at 和 updated_at 字段分别记录了申请的创建时间和最后更新时间，确保数据的时效性和准确性。

pet_images 表（宠物图片） ​

字段名类型非空唯一默认值
idSERIAL是是自动递增
pet_idINT是否外键 → pets(id)
image_urlVARCHAR(255)是否-
created_atTIMESTAMP是否CURRENT_TIMESTAMP

宠物图片表用于存储与每只宠物相关的多张图片。每张图片的 URL 地址存储在 image_url 字段中，pet_id 作为外键，指向 pets 表中的对应记录，确保图片与宠物之间的关联性。字段 created_at 记录了图片上传的时间，确保图片数据的有效性和时效性。

在项目中创建 APP ​

创建 Django app 是 Django 项目架构的核心设计理念之一，目的是：

  • 职责分离，便于管理
    每个 app 是项目中的一个独立模块，可以专注完成一类功能，比如：

    • 用户管理（users）
    • 宠物管理（pets）
    • 领养流程（adoption）

  • 可复用性强
    Django 的 app 就像插件一样，具有高度的独立性和可移植性，能够在多个项目间复用。

  • 配合 Django 自动机制（模型迁移、后台管理等）
    Django 的命令行工具（如 makemigrations）是基于 app 的结构来自动识别模型、生成数据库迁移文件的。

  • 遵循 Django 官方推荐结构
    标准 Django 项目由多个 app 组成，每个 app 负责一块业务逻辑，使得项目结构清晰、易于扩展。

在我们的示例系统中，创建一个 app 即可满足业务需求。我们将其命名为 adoption。

在项目根目录下执行以下命令：

bash
python manage.py startapp adoption

该命令将在项目中创建一个名为 adoption/ 的目录，结构如下：

txt
adoption/
├── __init__.py
├── admin.py
├── apps.py
├── migrations/
├── models.py
├── tests.py
└── views.py

各文件说明如下：

  • __init__.py：空文件，标识该目录是一个 Python 包；
  • admin.py：用于注册模型到 Django 管理后台；
  • apps.py：定义当前 app 的配置，Django 项目启动时会自动读取；
  • migrations/：用于存放数据库迁移文件（由 makemigrations 命令自动生成）；
  • models.py：用于定义数据库表模型，是构建应用数据结构的核心；
  • tests.py：用于编写自动化测试代码；
  • views.py：用于定义视图函数，处理前端请求并返回页面或数据。

最后，我们需要在 FinalProject/settings.py 中注册该 app：

python
INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "adoption",     # 宠物领养 app
]

在 Django 中创建表结构 ​

在 adoption/models.py 中定义模型类，即可声明数据库的表结构：

python
from django.db import models
from django.contrib.auth.models import User

# 用户信息表模型
class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    phone_number = models.CharField(max_length=20)
    
# 宠物信息表模型
class Pet(models.Model):
    STATUS_CHOICES = [
        ('available', '可领养'),
        ('adopted', '已领养'),
    ]
    
    name = models.CharField(max_length=100)
    age = models.IntegerField()
    species = models.CharField(max_length=100)
    description = models.TextField(blank=True, null=True)
    status = models.CharField(max_length=20, choices=STATUS_CHOICES)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.name

# 领养申请表模型
class AdoptionRequest(models.Model):
    STATUS_CHOICES = [
        ('pending', '待审核'),
        ('approved', '已批准'),
        ('cancelled', '已取消'),
    ]
    
    user = models.ForeignKey(User, on_delete=models.CASCADE)
    pet = models.ForeignKey(Pet, on_delete=models.CASCADE)
    status = models.CharField(max_length=20, choices=STATUS_CHOICES)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

# 宠物图片表模型
class PetImage(models.Model):
    pet = models.ForeignKey(Pet, on_delete=models.CASCADE)
    image_url = models.CharField(max_length=255)
    created_at = models.DateTimeField(auto_now_add=True)

完成模型定义后，运行以下命令即可将表结构迁移到数据库：

bash
python manage.py makemigrations
python manage.py migrate

Django 会自动根据模型生成 SQL 语句，在数据库中建立对应表结构、外键关系和约束。

The avatar of contributor named as mango7789 mango7789