签入版本

This commit is contained in:
2026-09-11 11:39:07 +08:00
commit c381201858
928 changed files with 116443 additions and 0 deletions
View File
+3
View File
@@ -0,0 +1,3 @@
from django.contrib import admin
# Register your models here.
+61
View File
@@ -0,0 +1,61 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
首页应用配置模块
=============================================================
该模块定义了首页/个人中心应用的配置类,用于Django应用注册和初始化。
"""
from django.apps import AppConfig
class IndexConfig(AppConfig):
"""首页应用配置类"""
# 指定默认的主键字段类型
# 使用 BigAutoField 可以支持更大的数据量,适合高并发场景
default_auto_field = 'django.db.models.BigAutoField'
# 指定该应用在项目中的Python导入路径
# 格式为 '应用所在模块.应用名称'
name = 'application.index'
+334
View File
@@ -0,0 +1,334 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
用户表单验证模块
=============================================================
该模块定义了用户管理功能中使用的表单验证类。
用于对前端提交的用户信息进行验证,确保数据符合业务规则和数据库约束。
包括用户基本信息和密码修改等功能的表单验证。
"""
from django import forms
from application.user import models
# =============================================================
# 用户基本信息表单验证类
# =============================================================
class UserForm(forms.ModelForm):
"""
用户基本信息表单验证类
用于创建和更新用户基本信息时的表单验证。
包含用户的基本资料信息,如姓名、昵称、联系方式等。
验证字段包括:
- avatar: 用户头像
- realname: 用户真实姓名
- gender: 性别
- mobile: 手机号
- email: 邮箱
- city: 行政区划
- address: 详细地址
- intro: 个人简介
"""
# ----------------------------------------------------------
# 用户头像
# ----------------------------------------------------------
# 字段说明: 用户的头像图片
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),最大长度255字符
avatar = forms.CharField(
required=True,
max_length=255,
error_messages={
'required': '用户头像不能为空',
'max_length': '用户头像长度不得超过255个字符',
}
)
# ----------------------------------------------------------
# 用户姓名
# ----------------------------------------------------------
# 字段说明: 用户的真实姓名
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),最大长度100字符
realname = forms.CharField(
required=True,
max_length=100,
error_messages={
'required': '用户姓名不能为空',
'max_length': '用户姓名长度不得超过100个字符',
}
)
# ----------------------------------------------------------
# 性别
# ----------------------------------------------------------
# 字段说明: 用户的性别信息
# 字段类型: 整型(IntegerField)
# 验证规则: 必填(required=True),取值范围1-3
# 可选值: 1-男, 2-女, 3-保密
gender = forms.IntegerField(
required=True,
min_value=1,
max_value=3,
error_messages={
'required': '性别不能为空',
'min_value': '性别值在1~3之间',
'max_value': '性别值在1~3之间',
}
)
# ----------------------------------------------------------
# 手机号
# ----------------------------------------------------------
# 字段说明: 用户的手机号码
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),最大长度30字符
mobile = forms.CharField(
required=True,
max_length=30,
error_messages={
'required': '手机号不能为空',
'max_length': '手机号长度不得超过30个字符',
}
)
# ----------------------------------------------------------
# 邮箱
# ----------------------------------------------------------
# 字段说明: 用户的电子邮箱
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),最大长度30字符
email = forms.CharField(
required=True,
max_length=30,
error_messages={
'required': '邮箱不能为空',
'max_length': '邮箱长度不得超过30个字符',
}
)
# ----------------------------------------------------------
# 行政区划
# ----------------------------------------------------------
# 字段说明: 用户所在地区的行政区划信息
# 字段类型: 任意类型(Field基类)
# 验证规则: 必填(required=True)
# 业务说明: 可以是省/市/区/街道的编码、名称或组合对象
city = forms.Field(
required=True,
error_messages={
'required': '所在城市不能为空',
}
)
# ----------------------------------------------------------
# 详细地址
# ----------------------------------------------------------
# 字段说明: 用户的详细街道地址
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),最大长度255字符
address = forms.CharField(
required=True,
max_length=255,
error_messages={
'required': '详细地址不能为空',
'max_length': '详细地址长度不得超过255个字符',
}
)
# ----------------------------------------------------------
# 个人简介
# ----------------------------------------------------------
# 字段说明: 用户的个人介绍或签名
# 字段类型: 字符型(CharField)
# 验证规则: 可选填(required=False),最大长度255字符
intro = forms.CharField(
required=False,
max_length=255,
error_messages={
'max_length': '个人简介长度不得超过255个字符',
}
)
# =============================================================
# 表单元数据配置
# =============================================================
class Meta:
"""
表单元数据配置类
定义表单绑定的模型和需要验证的字段。
"""
# 绑定模型
# 指定该表单对应的数据模型为 User(用户)
model = models.User
# 指定需要验证的字段
fields = [
'avatar',
'realname',
'gender',
'mobile',
'email',
'city',
'address',
'intro'
]
# =============================================================
# 密码修改表单验证类
# =============================================================
class UpdatePasswordForm(forms.ModelForm):
"""
密码修改表单验证类
专门用于用户修改密码操作的验证。
需要验证原始密码、新密码和确认密码的一致性。
验证字段包括:
- password: 原始密码
- newPassword: 新密码
- confirmPassword: 确认新密码
"""
# ----------------------------------------------------------
# 原始密码
# ----------------------------------------------------------
# 字段说明: 用户的当前密码
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),长度6-12字符
password = forms.CharField(
required=True,
min_length=6,
max_length=12,
error_messages={
'required': '原始密码不能为空',
'min_length': '原始密码长度为6~12个字符',
'max_length': '原始密码长度为6~12个字符',
}
)
# ----------------------------------------------------------
# 新密码
# ----------------------------------------------------------
# 字段说明: 用户设置的新密码
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),长度6-12字符
newPassword = forms.CharField(
required=True,
min_length=6,
max_length=12,
error_messages={
'required': '新密码不能为空',
'min_length': '新密码长度为6~12个字符',
'max_length': '新密码长度为6~12个字符',
}
)
# ----------------------------------------------------------
# 确认新密码
# ----------------------------------------------------------
# 字段说明: 用于确认新密码输入是否正确
# 字段类型: 字符型(CharField)
# 验证规则: 必填(required=True),长度6-12字符
confirmPassword = forms.CharField(
required=True,
min_length=6,
max_length=12,
error_messages={
'required': '确认新密码不能为空',
'min_length': '确认新密码长度为6~12个字符',
'max_length': '确认新密码长度为6~12个字符',
}
)
# =============================================================
# 表单元数据配置
# =============================================================
class Meta:
"""
表单元数据配置类
定义表单绑定的模型和需要验证的字段。
"""
# 绑定模型
# 指定该表单对应的数据模型为 User(用户)
model = models.User
# 指定需要验证的字段
fields = [
'password',
'newPassword',
'confirmPassword'
]
# =============================================================
# 自定义验证方法
# =============================================================
def clean(self):
"""
自定义表单清理方法
验证新密码与确认密码是否一致。
"""
cleaned_data = super().clean()
new_password = cleaned_data.get('newPassword')
confirm_password = cleaned_data.get('confirmPassword')
if new_password and confirm_password and new_password != confirm_password:
raise forms.ValidationError('新密码与确认密码不一致')
return cleaned_data
+3
View File
@@ -0,0 +1,3 @@
from django.db import models
# Create your models here.
+274
View File
@@ -0,0 +1,274 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
用户信息服务模块
=============================================================
该模块提供用户相关的业务逻辑处理服务,包括用户信息更新和密码修改等功能。
作为视图层和模型层之间的桥梁,封装复杂的业务逻辑,提供统一的调用接口。
主要功能:
1. 更新用户个人信息(姓名、性别、手机、邮箱、地址、简介等)
2. 修改用户登录密码(验证原密码、新密码一致性检查)
"""
import logging
from application.index import forms
from application.user.models import User
from utils import R, regular
from utils.common import save_file, parse_request_body, format_datetime
from utils.password import verify_password, encrypt_password, generate_salt
logger = logging.getLogger(__name__)
# =============================================================
# 内部辅助函数
# =============================================================
def _get_user_by_id(user_id):
"""
根据ID查询用户(私有辅助函数)
Args:
user_id: 用户ID
Returns:
tuple: (成功标志, 用户对象或错误信息)
(True, user) - 查询成功
(False, error_response) - 查询失败,返回R对象
"""
query = User.objects.filter(id=user_id, is_delete=False)
user = query.first()
if not user:
return False, R.failed("用户不存在")
return True, user
# =============================================================
# 个人资料更新服务
# =============================================================
def update_profile(request, user_id):
"""
更新用户个人信息
更新指定用户的个人资料信息,包括真实姓名、性别、手机号、邮箱、
详细地址和个人简介等字段。
Args:
request: Django请求对象,包含JSON数据
user_id: 要更新的用户ID
Returns:
R: 统一响应格式
- 成功: R.ok(msg="更新成功")
- 失败: R.failed(错误信息)
"""
# 解析请求参数
data, error = parse_request_body(request)
if error:
return R.failed(msg=error)
# 表单验证
form = forms.UserForm(data)
if not form.is_valid():
return R.failed(regular.get_err(form))
cleaned_data = form.cleaned_data
# 处理头像
avatar = cleaned_data.get('avatar')
if avatar:
avatar = save_file(avatar, "user")
# 处理行政区划
city = cleaned_data.get('city', [])
if len(city) != 4:
return R.failed("请选择完整的所在城市(省/市/区/街道)")
# 提取验证通过的数据
user_data = {
'avatar': avatar,
'realname': cleaned_data.get('realname'),
'gender': cleaned_data.get('gender'),
'mobile': cleaned_data.get('mobile'),
'email': cleaned_data.get('email'),
'province_code': city[0],
'city_code': city[1],
'district_code': city[2],
'street_code': city[3],
'address': cleaned_data.get('address'),
'intro': cleaned_data.get('intro')
}
# 查询用户
success, result = _get_user_by_id(user_id)
if not success:
return result
user = result
# 更新用户信息
for field, value in user_data.items():
setattr(user, field, value)
# 保存到数据库
try:
user.save()
logger.info(f"用户信息更新成功: user_id={user_id}")
return R.ok(msg="更新成功")
except Exception as e:
logger.error(f"用户信息保存失败: user_id={user_id}, error={str(e)}")
return R.failed("更新失败,请稍后重试")
# =============================================================
# 密码修改服务
# =============================================================
def update_password(request, user_id):
"""
更新用户登录密码
修改指定用户的登录密码,需要验证原密码正确性,
并确保新密码与确认密码一致。
Args:
request: Django请求对象,包含JSON数据
user_id: 要更新密码的用户ID
Returns:
R: 统一响应格式
- 成功: R.ok(msg="更新成功")
- 失败: R.failed(错误信息)
"""
# 解析请求参数
data, error = parse_request_body(request)
if error:
return R.failed(msg=error)
# 表单验证
form = forms.UpdatePasswordForm(data)
if not form.is_valid():
return R.failed(regular.get_err(form))
# 提取密码数据
old_password = form.cleaned_data.get('password')
new_password = form.cleaned_data.get('newPassword')
confirm_password = form.cleaned_data.get('confirmPassword')
# 验证两次新密码是否一致
if new_password != confirm_password:
return R.failed("两次输入的新密码不一致")
# 查询用户
success, result = _get_user_by_id(user_id)
if not success:
return result
user = result
# 验证原始密码(使用 bcrypt)
if not user.salt:
return R.failed("用户密码格式异常,请联系管理员")
password_valid = verify_password(old_password, user.salt, user.password)
if not password_valid:
return R.failed("原始密码不正确")
# 加密并更新新密码(使用 bcrypt)
salt = generate_salt()
user.password = encrypt_password(new_password, salt)
user.salt = salt
try:
user.save()
logger.info(f"密码更新成功: user_id={user_id}")
return R.ok(msg="密码修改成功")
except Exception as e:
logger.error(f"密码更新失败: user_id={user_id}, error={str(e)}")
return R.failed("密码修改失败,请稍后重试")
# =============================================================
# 用户信息获取服务
# =============================================================
def get_user_profile(user_id):
"""
获取用户个人信息
查询指定用户的详细信息,用于个人中心展示。
Args:
user_id: 用户ID
Returns:
R: 统一响应格式
- 成功: R.ok(data=user_info)
- 失败: R.failed(错误信息)
"""
# 查询用户
success, result = _get_user_by_id(user_id)
if not success:
return result
user = result
# 构建用户信息
user_info = {
'id': user.id,
'username': user.username,
'realname': user.realname,
'avatar': user.avatar,
'gender': user.gender,
'mobile': user.mobile,
'email': user.email,
'address': user.address,
'intro': user.intro,
'lastLoginIp': user.last_login_ip,
'lastLoginTime': format_datetime(user.last_login_time),
'createTime': format_datetime(user.create_time)
}
return R.ok(data=user_info)
+3
View File
@@ -0,0 +1,3 @@
from django.test import TestCase
# Create your tests here.
+108
View File
@@ -0,0 +1,108 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
from django.urls import path # 导入路径相关配置
from application.index import views
"""
首页/个人中心模块路由配置
=============================================================
URL端点概览:
------------------------------------------------------------------------
| 功能说明 | 请求方法 | URL路径 | 视图类 |
|-----------------|----------|-----------------------------|---------------------|
| 获取菜单 | GET | /index/getMenus | MenuView |
| 获取用户信息 | GET | /index/getUser | UserView |
| 个人中心 | GET | /index/userInfo | UserInfoView |
| 更新密码 | PUT | /index/updatePassword | UpdatePwdView |
------------------------------------------------------------------------
使用示例:
1. 获取菜单:GET /api/index/getMenus
2. 获取用户信息:GET /api/index/getUser
3. 个人中心:GET /api/index/userInfo
4. 更新密码:PUT /api/index/updatePwd
功能说明:
- getMenus: 获取当前登录用户的菜单权限树,用于渲染前端导航菜单
- getUser: 获取当前登录用户的基本信息,如用户名、头像、角色等
- userInfo: 获取当前登录用户的详细信息,用于个人中心页面展示
- updatePwd: 修改当前登录用户的密码,需要验证旧密码
注意事项:
- 所有接口都需要登录认证(除登录接口外)
- 菜单数据根据用户角色权限动态生成
- 密码修改后通常需要重新登录
"""
# 首页/个人中心模块路由配置
urlpatterns = [
# 获取当前登录用户的菜单权限树
# URL: /index/getMenus
# 请求方法: GET
# 功能: 获取当前登录用户的菜单列表,用于前端动态渲染导航菜单
# 返回数据: 树形结构的菜单数据,包含菜单ID、名称、路径、图标、子菜单等
path('getMenus', views.MenuView.as_view()),
# 获取当前登录用户的基本信息
# URL: /index/getUser
# 请求方法: GET
# 功能: 获取当前登录用户的基本信息,如用户ID、用户名、头像、角色等
# 返回数据: 用户基本信息对象
path('getUser', views.UserView.as_view()),
# 获取个人中心详情
# URL: /index/userInfo
# 请求方法: GET
# 功能: 获取当前登录用户的详细信息,用于个人中心页面展示
# 返回数据: 用户的完整信息,可能包含联系方式、部门、岗位等扩展信息
path('updateProfile', views.UpdateProfileView.as_view()),
# 修改当前登录用户密码
# URL: /index/updatePwd
# 请求方法: PUT
# 功能: 修改当前登录用户的登录密码,需要验证旧密码
# 请求体: 包含旧密码、新密码、确认密码
# 注意事项: 密码修改成功后,建议重新登录
path('updatePassword', views.UpdatePasswordView.as_view()),
]
+234
View File
@@ -0,0 +1,234 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
首页/个人中心视图模块
=============================================================
该模块定义了系统首页和个人中心功能中使用的所有视图类。
用于处理菜单获取、用户信息获取、个人资料更新、密码修改、退出登录等操作。
这些接口主要用于前端框架的初始化加载和用户个人管理。
每个视图类对应一个特定的API端点,处理相应的业务逻辑。
"""
from django.utils.decorators import method_decorator
from django.views import View
import application.menu.services
from application.index import services
from application.operation_log.constants import LogType
from application.operation_log.decorators import operation_log
from application.user.models import User
from config.env import DJANGO_DEMO
from middleware.login_middleware import check_login
from utils import R
from utils.common import get_file_url
from utils.security import get_user_id
# =============================================================
# 菜单获取视图
# =============================================================
@method_decorator(check_login, name='get')
class MenuView(View):
"""
获取当前用户菜单树视图
处理GET请求,返回当前登录用户有权限访问的菜单树结构。
用于前端动态渲染导航菜单。
URL: /index/getMenus
请求方法: GET
权限要求: 需要登录
"""
def get(self, request):
"""
处理GET请求,返回用户菜单树
Args:
request: HttpRequest对象
Returns:
JsonResponse: 包含菜单树结构的JSON响应
"""
# 获取菜单列表
menuList = application.menu.services.get_user_permission_menus(get_user_id(request))
return R.ok(data=menuList)
# =============================================================
# 用户信息获取视图
# =============================================================
@method_decorator(check_login, name='get')
class UserView(View):
"""
获取当前用户基本信息视图
处理GET请求,返回当前登录用户的基本信息和权限列表。
用于前端用户状态管理和权限控制。
URL: /index/getUser
请求方法: GET
权限要求: 需要登录
"""
def get(self, request):
"""
处理GET请求,返回用户基本信息和权限
Args:
request: HttpRequest对象
Returns:
JsonResponse: 包含用户信息和权限的JSON响应
"""
# 获取当前用户ID
user_id = get_user_id(request)
# 查询用户信息
user = User.objects.filter(is_delete=False, id=user_id).first()
if not user:
return R.failed("用户不存在")
# 判断是否为超级管理员(ID=1)
if user_id == 1:
# 超级管理员拥有所有权限
permissions = ['*:*:*']
else:
# 普通用户获取权限节点列表
permissions = application.menu.services.get_user_permissions(user_id)
# 返回用户信息
info = {
'realname': user.realname,
'avatar': get_file_url(user.avatar),
'gender': user.gender,
'mobile': user.mobile,
'email': user.email,
'intro': user.intro,
'address': user.address,
'roles': [],
'permissions': permissions,
}
return R.ok(data=info)
# =============================================================
# 个人资料更新视图
# =============================================================
@method_decorator(check_login, name='dispatch')
class UpdateProfileView(View):
"""
更新个人资料视图
处理PUT请求,更新当前登录用户的个人资料信息。
URL: /index/updateProfile
请求方法: PUT
权限要求: 需要登录
"""
@operation_log(
title="个人信息-更新记录",
log_type=LogType.UPDATE
)
def put(self, request):
"""
处理PUT请求,更新个人资料
Args:
request: HttpRequest对象,包含更新信息的JSON数据
Returns:
JsonResponse: 包含操作结果的JSON响应
"""
# 演示环境禁止操作
if DJANGO_DEMO:
return R.failed("演示环境,暂无操作权限")
user_id = get_user_id(request)
result = services.update_profile(request, user_id)
return result
# =============================================================
# 密码修改视图
# =============================================================
@method_decorator(check_login, name='put')
class UpdatePasswordView(View):
"""
修改密码视图
处理PUT请求,修改当前登录用户的登录密码。
需要验证旧密码的正确性。
URL: /index/updatePwd
请求方法: PUT
权限要求: 需要登录
"""
@operation_log(
title="个人信息-修改密码",
log_type=LogType.UPDATE
)
def put(self, request):
"""
处理PUT请求,修改用户密码
Args:
request: HttpRequest对象,包含密码信息的JSON数据
Returns:
JsonResponse: 包含操作结果的JSON响应
"""
# 演示环境禁止操作
if DJANGO_DEMO:
return R.failed("演示环境,暂无操作权限")
user_id = get_user_id(request)
result = services.update_password(request, user_id)
return result