开发了多角色登录与鉴权接口:实现了普通用户、企业和管理员的登录分流,并支持Token验证。

开发了权限控制接口:实现了通过数据库分配菜单权限节点,控制接口访问安全。
开发了实名认证中心:实现了个人身份证信息与企业营业执照的提交与审核接口。
开发了任务与协作大厅核心业务:实现了任务的发布、接单、状态流转以及专家邀约接口。
配置了全局环境变量与数据库引擎:集成了 PostgreSQL 数据库、Redis 缓存与 MinIO 对象存储。
This commit is contained in:
2026-04-28 16:32:02 +08:00
commit 23855ef0e4
94 changed files with 4950 additions and 0 deletions

0
reservations/__init__.py Normal file
View File

3
reservations/admin.py Normal file
View File

@@ -0,0 +1,3 @@
from django.contrib import admin
# Register your models here.

6
reservations/apps.py Normal file
View File

@@ -0,0 +1,6 @@
from django.apps import AppConfig
class ReservationsConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'reservations'

View File

@@ -0,0 +1,66 @@
# Generated by Django 4.2.30 on 2026-04-25 09:46
from django.db import migrations, models
import django.db.models.deletion
import uuid
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='ReservationResource',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('name', models.CharField(max_length=128)),
('type', models.CharField(choices=[('ACCESS_CONTROL', '门禁通行'), ('MEETING_ROOM', '会议室')], max_length=32)),
('description', models.TextField(blank=True, null=True)),
('capacity', models.IntegerField(blank=True, null=True)),
('location', models.CharField(blank=True, max_length=256, null=True)),
('cover_url', models.CharField(blank=True, max_length=512, null=True)),
('price_per_unit', models.DecimalField(decimal_places=2, default=0.0, max_digits=8)),
('price_unit', models.CharField(default='', max_length=32)),
('is_active', models.BooleanField(default=True)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
],
options={
'db_table': 'reservation_resources',
},
),
migrations.CreateModel(
name='ReservationOrder',
fields=[
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
('order_no', models.CharField(max_length=64, unique=True)),
('start_time', models.DateTimeField()),
('end_time', models.DateTimeField()),
('quantity', models.IntegerField(default=1)),
('unit_price', models.DecimalField(decimal_places=2, max_digits=8)),
('total_amount', models.DecimalField(decimal_places=2, max_digits=10)),
('status', models.CharField(choices=[('PENDING_PAY', '待支付'), ('PAID', '已支付'), ('USED', '已使用'), ('REFUNDED', '已退款'), ('CANCELLED', '已取消')], default='PENDING_PAY', max_length=32)),
('wx_prepay_id', models.CharField(blank=True, max_length=128, null=True)),
('wx_transaction_id', models.CharField(blank=True, max_length=128, null=True)),
('paid_at', models.DateTimeField(blank=True, null=True)),
('refund_reason', models.TextField(blank=True, null=True)),
('refund_amount', models.DecimalField(blank=True, decimal_places=2, max_digits=10, null=True)),
('wx_refund_id', models.CharField(blank=True, max_length=128, null=True)),
('refunded_at', models.DateTimeField(blank=True, null=True)),
('qr_code_url', models.CharField(blank=True, max_length=512, null=True)),
('verified_at', models.DateTimeField(blank=True, null=True)),
('remark', models.TextField(blank=True, null=True)),
('is_deleted', models.BooleanField(default=False)),
('created_at', models.DateTimeField(auto_now_add=True)),
('updated_at', models.DateTimeField(auto_now=True)),
('resource', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='orders', to='reservations.reservationresource')),
],
options={
'db_table': 'reservation_orders',
},
),
]

View File

@@ -0,0 +1,28 @@
# Generated by Django 4.2.30 on 2026-04-25 09:46
from django.conf import settings
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = [
('reservations', '0001_initial'),
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
]
operations = [
migrations.AddField(
model_name='reservationorder',
name='user',
field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='reservation_orders', to=settings.AUTH_USER_MODEL),
),
migrations.AddField(
model_name='reservationorder',
name='verified_by',
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='verified_orders', to=settings.AUTH_USER_MODEL),
),
]

View File

59
reservations/models.py Normal file
View File

@@ -0,0 +1,59 @@
import uuid
from django.db import models
class ResourceType(models.TextChoices):
ACCESS_CONTROL = 'ACCESS_CONTROL', '门禁通行'
MEETING_ROOM = 'MEETING_ROOM', '会议室'
class OrderStatus(models.TextChoices):
PENDING_PAY = 'PENDING_PAY', '待支付'
PAID = 'PAID', '已支付'
USED = 'USED', '已使用'
REFUNDED = 'REFUNDED', '已退款'
CANCELLED = 'CANCELLED', '已取消'
class ReservationResource(models.Model):
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
name = models.CharField(max_length=128)
type = models.CharField(max_length=32, choices=ResourceType.choices)
description = models.TextField(null=True, blank=True)
capacity = models.IntegerField(null=True, blank=True)
location = models.CharField(max_length=256, null=True, blank=True)
cover_url = models.CharField(max_length=512, null=True, blank=True)
price_per_unit = models.DecimalField(max_digits=8, decimal_places=2, default=0.00)
price_unit = models.CharField(max_length=32, default='')
is_active = models.BooleanField(default=True)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
db_table = 'reservation_resources'
class ReservationOrder(models.Model):
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
order_no = models.CharField(max_length=64, unique=True)
user = models.ForeignKey('users.User', on_delete=models.CASCADE, related_name='reservation_orders')
resource = models.ForeignKey(ReservationResource, on_delete=models.CASCADE, related_name='orders')
start_time = models.DateTimeField()
end_time = models.DateTimeField()
quantity = models.IntegerField(default=1)
unit_price = models.DecimalField(max_digits=8, decimal_places=2)
total_amount = models.DecimalField(max_digits=10, decimal_places=2)
status = models.CharField(max_length=32, choices=OrderStatus.choices, default=OrderStatus.PENDING_PAY)
wx_prepay_id = models.CharField(max_length=128, null=True, blank=True)
wx_transaction_id = models.CharField(max_length=128, null=True, blank=True)
paid_at = models.DateTimeField(null=True, blank=True)
refund_reason = models.TextField(null=True, blank=True)
refund_amount = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True)
wx_refund_id = models.CharField(max_length=128, null=True, blank=True)
refunded_at = models.DateTimeField(null=True, blank=True)
qr_code_url = models.CharField(max_length=512, null=True, blank=True)
verified_by = models.ForeignKey('users.User', on_delete=models.SET_NULL, null=True, blank=True, related_name='verified_orders')
verified_at = models.DateTimeField(null=True, blank=True)
remark = models.TextField(null=True, blank=True)
is_deleted = models.BooleanField(default=False)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
db_table = 'reservation_orders'

View File

@@ -0,0 +1,14 @@
from rest_framework import serializers
from .models import ReservationResource, ReservationOrder
class ReservationResourceSerializer(serializers.ModelSerializer):
class Meta:
model = ReservationResource
fields = '__all__'
read_only_fields = ['id', 'created_at', 'updated_at']
class ReservationOrderSerializer(serializers.ModelSerializer):
class Meta:
model = ReservationOrder
fields = '__all__'
read_only_fields = ['id', 'user', 'order_no', 'status', 'paid_at', 'refund_amount', 'wx_refund_id', 'refunded_at', 'qr_code_url', 'verified_by', 'verified_at', 'created_at', 'updated_at']

3
reservations/tests.py Normal file
View File

@@ -0,0 +1,3 @@
from django.test import TestCase
# Create your tests here.

11
reservations/urls.py Normal file
View File

@@ -0,0 +1,11 @@
from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import ReservationResourceViewSet, ReservationOrderViewSet
router = DefaultRouter()
router.register('resources', ReservationResourceViewSet)
router.register('orders', ReservationOrderViewSet)
urlpatterns = [
path('', include(router.urls)),
]

61
reservations/views.py Normal file
View File

@@ -0,0 +1,61 @@
from rest_framework import viewsets, permissions, status
from rest_framework.response import Response
from rest_framework.decorators import action
from .models import ReservationResource, ReservationOrder, OrderStatus
from .serializers import ReservationResourceSerializer, ReservationOrderSerializer
import uuid
import datetime
class ReservationResourceViewSet(viewsets.ModelViewSet):
"""
@author: xujl
Api说明: 预约资源(工位、会议室等物理资源)接口视图。用于资源空间的增删改查及上下架管理,控制开放时段。
"""
queryset = ReservationResource.objects.filter(is_active=True)
serializer_class = ReservationResourceSerializer
def get_permissions(self):
if self.action in ['create', 'update', 'partial_update', 'destroy']:
return [permissions.IsAdminUser()]
return [permissions.AllowAny()]
class ReservationOrderViewSet(viewsets.ModelViewSet):
"""
@author: xujl
Api说明: 预约订单接口视图。用于用户发起资源预约、取消预约,以及后台管理员对订单进行状态流转和支付确认管理。
"""
queryset = ReservationOrder.objects.filter(is_deleted=False)
serializer_class = ReservationOrderSerializer
permission_classes = [permissions.IsAuthenticated]
def get_queryset(self):
return ReservationOrder.objects.filter(user=self.request.user, is_deleted=False)
def perform_create(self, serializer):
resource = serializer.validated_data['resource']
quantity = serializer.validated_data.get('quantity', 1)
total_amount = resource.price_per_unit * quantity
# 简单生成订单号
order_no = f"RES{datetime.datetime.now().strftime('%Y%m%d%H%M%S')}{str(uuid.uuid4())[:4].upper()}"
serializer.save(
user=self.request.user,
order_no=order_no,
unit_price=resource.price_per_unit,
total_amount=total_amount,
status=OrderStatus.PENDING_PAY
)
@action(detail=True, methods=['post'])
def pay(self, request, pk=None):
order = self.get_object()
if order.status != OrderStatus.PENDING_PAY:
return Response({'detail': '订单状态不允许支付'}, status=status.HTTP_400_BAD_REQUEST)
order.status = OrderStatus.PAID
order.paid_at = datetime.datetime.now()
order.qr_code_url = f"https://api.opc-platform.com/qr/{order.order_no}"
order.save()
return Response({'status': '支付成功', 'qr_code_url': order.qr_code_url})