签入版本

This commit is contained in:
2026-09-12 12:07:15 +08:00
commit 0277034d24
939 changed files with 129356 additions and 0 deletions
+3
View File
@@ -0,0 +1,3 @@
from django.contrib import admin
# Register your models here.
+104
View File
@@ -0,0 +1,104 @@
# +======================================================================
# | 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 OperationLogConfig(AppConfig):
"""
操作日志管理应用配置类
=============================================================
定义操作日志应用的配置信息,包括:
- 默认主键字段类型
- 应用在项目中的Python导入路径
- 应用在后台管理中的显示名称
使用场景:
在 Django 的 settings.py 的 INSTALLED_APPS 中配置:
INSTALLED_APPS = [
...
'application.operation_log.apps.OperationLogConfig',
# 或简写为 'application.operation_log'
]
属性说明:
default_auto_field : 指定默认的主键字段类型
name : 应用的Python导入路径
verbose_name : 应用在后台管理中的显示名称
注意:
- default_auto_field 设置为 BigAutoField 可支持更大的数据量
- verbose_name 用于 Django Admin 后台显示
"""
# 指定默认的主键字段类型
# 使用 BigAutoField 可以支持更大的数据量,适合高并发场景
# 字段类型说明:
# - AutoField: 自增整数,最大支持 2,147,483,647 条记录
# - BigAutoField: 大整数自增,最大支持 9,223,372,036,854,775,807 条记录
# 选择 BigAutoField 可以确保在数据量巨大时主键不会溢出
default_auto_field = 'django.db.models.BigAutoField'
# 指定该应用在项目中的Python导入路径
# 格式为 '应用所在模块.应用名称'
# Django 通过此路径来定位应用的位置,用于:
# - 查找模型定义
# - 加载模板文件
# - 发现管理命令
# - 收集静态文件等
name = 'application.operation_log'
# 应用在后台显示的友好名称
# 此名称将显示在 Django Admin 后台的应用列表中
# 例如:在管理后台会显示为 "操作日志管理"
# 注意:需要使用 verbose_name_plural 来设置复数形式
verbose_name = "操作日志管理"
# 可选配置:设置复数形式的显示名称(如果不设置,Django会自动添加's')
# verbose_name_plural = verbose_name
+82
View File
@@ -0,0 +1,82 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
class LogType:
"""
操作类型常量类
用于定义系统日志中记录的各种操作类型,每个操作类型对应一个唯一的整数值。
这些常量值通常存储在数据库的日志表中,便于查询和统计分析。
"""
# ========== 基础操作 ==========
OTHER = 0 # 其他操作:无法归类或未明确指定的操作类型
QUERY = 1 # 查询操作:数据查询、检索等只读操作
ADD = 2 # 新增操作:添加单条或多条数据记录
UPDATE = 3 # 修改操作:更新已有数据记录
SAVE = 4 # 保存操作:添加或更新已有数据记录
DELETE = 5 # 删除操作:删除单条数据记录
# ========== 批量/特殊操作 ==========
BATCH_DELETE = 6 # 批量删除:一次性删除多条数据记录
STATUS = 7 # 设置状态:修改数据的状态字段(如启用/禁用)
RESET_PWD = 8 # 重置密码:重置用户密码为初始值或随机值
# ========== 文件操作 ==========
IMPORT = 9 # 导入操作:从Excel、CSV等文件导入数据
EXPORT = 10 # 导出操作:将数据导出为Excel、CSV等文件格式
UPLOAD = 11 # 上传操作:上传附件文件
# ========== 流程操作 ==========
CANCEL = 12 # 取消操作:取消未完成的业务流程或订单
SUBMIT = 13 # 提交操作:提交表单、申请单等到下一流程
REVOKE = 14 # 撤销操作:撤销已提交但未审核的内容
CHECK = 15 # 审核操作:对提交的内容进行审批通过
# ========== 系统/安全操作 ==========
FORCE = 16 # 强制操作:强制退出用户或强制结束流程
CLEAN = 17 # 清空操作:清空缓存、日志或数据表
GRANT = 18 # 授权操作:授予用户角色、权限或资源访问权
CACHE = 19 # 缓存操作:清理或刷新系统缓存
# ========== 账号/代码操作 ==========
ACCOUNT = 20 # 开账号:创建新用户账号
GENERATE = 21 # 生成代码:代码生成器相关操作(如生成CRUD代码)
+230
View File
@@ -0,0 +1,230 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
操作日志装饰器模块
=============================================================
提供 @operation_log 装饰器,用于标记需要记录操作日志的视图方法。
"""
import json
import logging
import time
from functools import wraps
from application.operation_log.constants import LogType
from application.operation_log.services import record_operation_log
logger = logging.getLogger(__name__)
# =============================================================
# 响应检查辅助函数
# =============================================================
def _check_response_success(response):
"""
检查响应是否成功
Args:
response: 响应对象(JsonResponse 或其他)
Returns:
tuple: (is_success, error_msg)
- is_success: 是否成功
- error_msg: 错误信息(失败时返回)
"""
is_success = True
error_msg = None
try:
# 检查 HTTP 状态码
if hasattr(response, 'status_code') and response.status_code >= 400:
is_success = False
return is_success, f"HTTP {response.status_code}"
# 尝试解析 JSON 响应内容
if hasattr(response, 'content') and response.content:
content = response.content.decode('utf-8')
if content:
data = json.loads(content)
# 检查自定义的 code 字段(R.ok 返回 code=0,R.failed 返回 code=1)
if isinstance(data, dict):
code = data.get('code')
if code is not None and code != 0:
is_success = False
error_msg = data.get('msg', '操作失败')
except:
pass
return is_success, error_msg
# =============================================================
# 参数提取辅助函数
# =============================================================
def _extract_params(request):
"""
提取请求参数
Args:
request: HttpRequest对象
Returns:
dict: 请求参数字典
"""
params = {}
try:
# GET请求参数
if request.method == 'GET':
params = request.GET.dict()
# POST/PUT/DELETE请求参数
elif request.method in ['POST', 'PUT', 'DELETE', 'PATCH']:
# 尝试获取JSON参数
if request.body:
try:
params = json.loads(request.body.decode('utf-8'))
except:
pass
# 如果JSON解析失败或为空,尝试获取表单参数
if not params and hasattr(request, 'POST'):
params = request.POST.dict()
# 过滤敏感信息(密码、token等)
sensitive_keys = ['password', 'pwd', 'token', 'secret', 'access_token']
for key in sensitive_keys:
if key in params:
params[key] = '******'
except Exception as e:
logger.error(f"提取请求参数异常: {e}")
return params
# =============================================================
# 操作日志装饰器
# =============================================================
def operation_log(title: str, log_type: int = LogType.OTHER, source: int = 0):
"""
操作日志装饰器
用于标记需要记录操作日志的视图方法。
Args:
title: 操作标题,如"职级管理-添加职级"
log_type: 操作类型,参考 LogType 常量
source: 操作来源,0-后台系统 1-手机站 2-客户端 3-其他
Returns:
function: 装饰后的函数
Example:
@operation_log(
title="职级管理-添加记录",
log_type=LogType.ADD
)
def post(self, request):
...
"""
def decorator(func):
@wraps(func)
def wrapper(self, request, *args, **kwargs):
# 记录开始时间
start_time = time.time()
# 保存请求参数用于日志记录
request.log_params = _extract_params(request)
# 执行原方法
try:
response = func(self, request, *args, **kwargs)
# 计算耗时
consume_time = int((time.time() - start_time) * 1000)
# 检查响应是否成功
is_success, error_msg = _check_response_success(response)
# 设置状态(0-正常,1-异常)
status = 0 if is_success else 1
# 记录操作日志
record_operation_log(
request=request,
title=title,
log_type=log_type,
source=source,
status=status,
error_msg=error_msg,
consume_time=consume_time,
result=response
)
return response
except Exception as e:
# 计算耗时
consume_time = int((time.time() - start_time) * 1000)
# 记录异常日志
record_operation_log(
request=request,
title=title,
log_type=log_type,
source=source,
status=1,
error_msg=str(e),
consume_time=consume_time,
result=None
)
raise
return wrapper
return decorator
View File
@@ -0,0 +1,48 @@
# Generated by Django 6.0.3 on 2026-09-04 11:44
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='OperationLog',
fields=[
('title', models.CharField(blank=True, db_comment='请求标题', db_default='', default='', help_text='请求标题', max_length=150, verbose_name='请求标题')),
('type', models.IntegerField(choices=[(0, '其他'), (1, '查询'), (2, '新增'), (3, '修改'), (4, '保存'), (5, '删除'), (6, '批量删除'), (7, '设置状态'), (8, '重置密码'), (9, '导入'), (10, '导出'), (11, '上传'), (12, '取消'), (13, '提交'), (14, '撤销'), (15, '审核'), (16, '强制'), (17, '清空'), (18, '授权'), (19, '缓存'), (20, '开账号'), (21, '生成代码')], db_comment='请求类型', db_default=0, default=0, help_text='请求类型', verbose_name='请求类型')),
('source', models.PositiveIntegerField(choices=[(0, '后台系统'), (1, '手机站'), (2, '客户端'), (3, '其他')], db_comment='请求来源', db_default=0, default=0, help_text='请求来源:0-后台系统 1-手机站 2-客户端 3-其他', verbose_name='请求来源')),
('method', models.CharField(blank=True, db_comment='请求方法', db_default='', default='', help_text='请求方法', max_length=100, verbose_name='请求方法')),
('request_method', models.CharField(blank=True, db_comment='请求方式', db_default='', default='', help_text='请求方式', max_length=100, verbose_name='请求方式')),
('url', models.CharField(blank=True, db_comment='请求URL', db_default='', default='', help_text='请求URL', max_length=1000, verbose_name='请求URL')),
('param', models.TextField(blank=True, db_comment='请求参数', db_default='', default='', help_text='请求参数', verbose_name='请求参数')),
('result', models.TextField(blank=True, db_comment='请求结果', db_default='', default='', help_text='请求结果', verbose_name='请求结果')),
('ip', models.CharField(blank=True, db_comment='请求IP', db_default='', db_index=True, default='', help_text='请求IP', max_length=100, verbose_name='请求IP')),
('location', models.CharField(blank=True, db_comment='请求所在区域', db_default='', default='', help_text='请求所在区域', max_length=255, verbose_name='请求所在区域')),
('os', models.CharField(blank=True, db_comment='操作系统', db_default='', default='', help_text='操作系统', max_length=100, verbose_name='操作系统')),
('browser', models.CharField(blank=True, db_comment='浏览器', db_default='', default='', help_text='浏览器', max_length=100, verbose_name='浏览器')),
('consume_time', models.PositiveIntegerField(db_comment='请求耗时', db_default=0, default=0, help_text='请求耗时', verbose_name='请求耗时')),
('status', models.PositiveIntegerField(choices=[(0, '正常'), (1, '异常')], db_comment='请求状态', db_default=0, default=0, help_text='请求状态:0-正常 1-异常', verbose_name='请求状态')),
('error', models.TextField(blank=True, db_comment='错误描述', db_default='', default='', help_text='错误描述', verbose_name='错误描述')),
('id', models.AutoField(auto_created=True, db_comment='主键ID', primary_key=True, serialize=False, verbose_name='主键ID')),
('create_user', models.CharField(db_comment='创建人', db_default=None, default=None, max_length=50, null=True, verbose_name='创建人')),
('create_time', models.DateTimeField(auto_now_add=True, db_comment='创建时间', max_length=11, null=True, verbose_name='创建时间')),
('update_user', models.CharField(db_comment='更新人', db_default=None, default=None, max_length=50, null=True, verbose_name='更新人')),
('update_time', models.DateTimeField(auto_now=True, db_comment='更新时间', max_length=11, null=True, verbose_name='更新时间')),
('is_delete', models.BooleanField(db_comment='逻辑删除:0-正常 1-已删除', db_default=0, default=0, verbose_name='逻辑删除')),
],
options={
'verbose_name': '操作日志表',
'verbose_name_plural': '操作日志表',
'db_table': 'django_operation_log',
'db_table_comment': '请求标题',
'ordering': ('-create_time',),
'indexes': [models.Index(fields=['create_time'], name='idx_operation_log_create_time')],
},
),
]
+432
View File
@@ -0,0 +1,432 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
操作日志模型模块
=============================================================
该模块定义了操作日志相关的数据库模型。
用于记录系统的操作行为,便于安全审计和问题排查。
"""
from django.db import models
from application.models import BaseModel
from utils.common import get_table_name
# =============================================================
# 操作日志模型类
# =============================================================
class OperationLog(BaseModel):
"""
操作日志模型类
用于记录用户的操作行为,包括增删改查等操作。
记录详细的客户端信息、地理位置、耗时等,便于安全审计和问题排查。
继承自 BaseModel,自动包含:
- id: 主键
- is_delete: 逻辑删除标识
- create_user: 创建人
- create_time: 创建时间
- update_user: 更新人
- update_time: 更新时间
主要业务字段:
- title: 操作标题,简要描述操作内容
- type: 操作类型(增删改查等)
- source: 操作来源(后台、手机站、客户端等)
- method: 请求方法,如 user.add
- request_method: 请求方式,GET/POST/PUT/DELETE等
- url: 请求URL
- param: 请求参数
- result: 返回结果
- ip: 客户端IP地址
- location: IP归属地
- os: 操作系统
- browser: 浏览器
- consume_time: 请求耗时(毫秒)
- status: 操作状态(0-正常,1-异常)
- error: 错误信息
"""
# ----------------------------------------------------------
# 操作标题
# ----------------------------------------------------------
# 字段说明: 操作的简要描述
# 字段类型: 字符串(CharField)
# 约束: 最大长度150字符,允许为空(blank=True),默认值为空字符串
# 示例: "用户登录"、"添加商品"、"修改密码"
# 作用: 用于列表展示,快速了解操作内容
title = models.CharField(
max_length=150,
blank=True,
default='',
verbose_name="请求标题",
help_text="请求标题",
db_comment='请求标题', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 操作类型
# ----------------------------------------------------------
# 类型常量定义
TYPE_CHOICES = (
(0, "其他"),
(1, "查询"),
(2, "新增"),
(3, "修改"),
(4, "保存"),
(5, "删除"),
(6, "批量删除"),
(7, "设置状态"),
(8, "重置密码"),
(9, "导入"),
(10, "导出"),
(11, "上传"),
(12, "取消"),
(13, "提交"),
(14, "撤销"),
(15, "审核"),
(16, "强制"),
(17, "清空"),
(18, "授权"),
(19, "缓存"),
(20, "开账号"),
(21, "生成代码"),
)
# 字段说明: 操作类别的分类
# 字段类型: 整数(IntegerField)
# 约束: 使用 TYPE_CHOICES 限制可选值,默认值为0(其他)
# 作用: 区分操作类别,便于按类型统计分析
type = models.IntegerField(
choices=TYPE_CHOICES,
default=0,
verbose_name="请求类型",
help_text="请求类型",
db_comment='请求类型', # 数据库字段注释
db_default=0
)
# ----------------------------------------------------------
# 操作来源
# ----------------------------------------------------------
# 来源常量定义
SOURCE_CHOICES = (
(0, "后台系统"), # Django Admin 后台管理系统
(1, "手机站"), # 移动端 H5 站点
(2, "客户端"), # App、小程序等客户端
(3, "其他"), # 其他未分类的来源
)
# 字段说明: 请求来源系统
# 字段类型: 无符号正整数(PositiveIntegerField)
# 约束: 使用 SOURCE_CHOICES 限制可选值,默认值为0(后台系统)
# 作用: 标识请求来自哪个系统,便于按来源统计分析
source = models.PositiveIntegerField(
choices=SOURCE_CHOICES,
default=0,
verbose_name="请求来源",
help_text="请求来源:0-后台系统 1-手机站 2-客户端 3-其他",
db_comment='请求来源', # 数据库字段注释
db_default=0
)
# ----------------------------------------------------------
# 请求方法
# ----------------------------------------------------------
# 字段说明: 具体的操作标识
# 字段类型: 字符串(CharField)
# 约束: 最大长度100字符,允许为空(blank=True),默认值为空字符串
# 示例: "user.add"、"user.delete"
# 作用: 标识具体执行的操作方法
method = models.CharField(
max_length=100,
blank=True,
default='',
verbose_name="请求方法",
help_text="请求方法",
db_comment='请求方法', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 请求方式
# ----------------------------------------------------------
# 字段说明: HTTP协议方法
# 字段类型: 字符串(CharField)
# 约束: 最大长度100字符,允许为空(blank=True),默认值为空字符串
# 示例: "GET"、"POST"、"PUT"、"DELETE"
request_method = models.CharField(
max_length=100,
blank=True,
default='',
verbose_name="请求方式",
help_text="请求方式",
db_comment='请求方式', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 请求URL
# ----------------------------------------------------------
# 字段说明: 完整的请求路径
# 字段类型: 字符串(CharField)
# 约束: 最大长度1000字符,允许为空(blank=True),默认值为空字符串
# 作用: 记录请求的完整路径(不含域名),便于问题定位
url = models.CharField(
max_length=1000,
blank=True,
default='',
verbose_name="请求URL",
help_text="请求URL",
db_comment='请求URL', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 请求参数
# ----------------------------------------------------------
# 字段说明: 请求携带的参数
# 字段类型: 文本(TextField)
# 约束: 允许为空(blank=True),默认值为空字符串
# 作用: 存储GET参数或POST表单数据,以文本形式存储便于查阅
param = models.TextField(
blank=True,
default='',
verbose_name="请求参数",
help_text="请求参数",
db_comment='请求参数', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 返回结果
# ----------------------------------------------------------
# 字段说明: 请求处理后的响应数据
# 字段类型: 文本(TextField)
# 约束: 允许为空(blank=True),默认值为空字符串
# 作用: 存储请求处理后的响应数据,便于排查问题
result = models.TextField(
blank=True,
default='',
verbose_name="请求结果",
help_text="请求结果",
db_comment='请求结果', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 客户端IP地址
# ----------------------------------------------------------
# 字段说明: 发起请求的客户端IP
# 字段类型: 字符串(CharField)
# 约束: 最大长度100字符,允许为空(blank=True),默认值为空字符串
# 索引: 添加了数据库索引(db_index=True)以支持IP查询
# 作用: 记录客户端IP,用于安全审计
ip = models.CharField(
max_length=100,
blank=True,
default='',
db_index=True,
verbose_name="请求IP",
help_text="请求IP",
db_comment='请求IP', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# IP归属地
# ----------------------------------------------------------
# 字段说明: IP地址的地理位置信息
# 字段类型: 字符串(CharField)
# 约束: 最大长度255字符,允许为空(blank=True),默认值为空字符串
# 示例: "广东省深圳市南山区"
# 作用: 根据IP解析的地理位置,便于安全审计
location = models.CharField(
max_length=255,
blank=True,
default='',
verbose_name="请求所在区域",
help_text="请求所在区域",
db_comment='请求所在区域', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 操作系统
# ----------------------------------------------------------
# 字段说明: 客户端操作系统
# 字段类型: 字符串(CharField)
# 约束: 最大长度100字符,允许为空(blank=True),默认值为空字符串
# 示例: "Windows 10"、"macOS 14.0"、"iOS 17.0"
os = models.CharField(
max_length=100,
blank=True,
default='',
verbose_name="操作系统",
help_text="操作系统",
db_comment='操作系统', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 浏览器
# ----------------------------------------------------------
# 字段说明: 客户端浏览器
# 字段类型: 字符串(CharField)
# 约束: 最大长度100字符,允许为空(blank=True),默认值为空字符串
# 示例: "Chrome 120.0"、"Safari 17.0"
browser = models.CharField(
max_length=100,
blank=True,
default='',
verbose_name="浏览器",
help_text="浏览器",
db_comment='浏览器', # 数据库字段注释
db_default=''
)
# ----------------------------------------------------------
# 请求耗时
# ----------------------------------------------------------
# 字段说明: 请求处理耗时
# 字段类型: 无符号正整数(PositiveIntegerField)
# 约束: 默认值为0
# 单位: 毫秒(ms)
# 作用: 记录接口响应时间,用于性能监控
consume_time = models.PositiveIntegerField(
default=0,
verbose_name="请求耗时",
help_text="请求耗时",
db_comment='请求耗时', # 数据库字段注释
db_default=0
)
# ----------------------------------------------------------
# 操作状态
# ----------------------------------------------------------
# 状态常量定义
STATUS_CHOICES = (
(0, "正常"), # 操作成功
(1, "异常"), # 操作失败
)
# 字段说明: 操作执行状态
# 字段类型: 无符号正整数(PositiveIntegerField)
# 约束: 使用 STATUS_CHOICES 限制可选值,默认值为0(正常)
# 作用: 标识操作是否成功,便于统计成功率
status = models.PositiveIntegerField(
choices=STATUS_CHOICES,
default=0,
verbose_name="请求状态",
help_text="请求状态:0-正常 1-异常",
db_comment='请求状态', # 数据库字段注释
db_default=0
)
# ----------------------------------------------------------
# 错误信息
# ----------------------------------------------------------
# 字段说明: 操作失败时的错误描述
# 字段类型: 文本(TextField)
# 约束: 允许为空(blank=True),默认值为空字符串
# 作用: 当 status=1 时,记录具体的错误信息,便于问题排查
error = models.TextField(
blank=True,
default='',
verbose_name="错误描述",
help_text="错误描述",
db_comment='错误描述', # 数据库字段注释
db_default=''
)
# =============================================================
# 模型元数据配置
# =============================================================
class Meta:
"""
模型元数据配置类
定义模型在数据库中的表名、显示名称、默认排序规则等。
"""
# 数据表名
# 使用配置文件中的表前缀 + "operation_log",避免与其他应用表名冲突
db_table = get_table_name('operation_log')
# 数据表注释
db_table_comment = "请求标题"
# 模型在admin后台显示的友好名称(单数)
verbose_name = "操作日志表"
# 模型在admin后台显示的友好名称(复数)
verbose_name_plural = verbose_name
# 默认排序规则
# 按照创建时间倒序排列,最新的记录显示在最前面
ordering = ("-create_time",)
# 数据库索引配置
# 为 create_time 字段创建索引,优化按时间查询的效率
indexes = [
models.Index(fields=['create_time'], name='idx_operation_log_create_time'),
]
# =============================================================
# 实例方法
# =============================================================
def __str__(self):
"""
模型的字符串表示方法
当需要将模型实例转换为字符串时调用,如admin后台显示、日志输出等。
Returns:
str: 包含操作标题和创建时间的字符串
"""
return f'操作日志-{self.title}-{self.create_time}'
+387
View File
@@ -0,0 +1,387 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
操作日志服务模块
=============================================================
该模块实现了操作日志相关的所有业务逻辑。
包括操作日志的记录、分页查询、删除等功能。
"""
import json
import logging
from django.core.paginator import Paginator, PageNotAnInteger, InvalidPage, EmptyPage
from application.operation_log.models import OperationLog
from constant.constants import PAGE_SIZE
from utils import R
from utils.ip2region import get_ip_location
from utils.common import get_client_ip, format_params, format_result, parse_user_agent, get_method_name, \
truncate_json, format_datetime
from utils.security import get_username
logger = logging.getLogger(__name__)
# =============================================================
# 分页查询服务
# =============================================================
def get_operation_log_page(request):
"""
查询操作日志分页数据
Args:
request: HttpRequest对象,包含查询参数
- pageNo: 当前页码
- pageSize: 每页记录数
- title: 操作标题(模糊查询)
- type: 操作类型
- status: 操作状态
- startTime: 开始时间
- endTime: 结束时间
Returns:
R: 包含分页数据的JSON响应
"""
try:
# 获取分页参数
page_no = int(request.GET.get('pageNo', 1))
page_size = int(request.GET.get('pageSize', PAGE_SIZE))
# 构建基础查询(只查询未删除的记录)
query = OperationLog.objects.filter(is_delete=0)
# 应用筛选条件
query = _apply_filters(query, request)
# 按创建时间倒序排列
query = query.order_by("-create_time")
# 执行分页查询
paginator = Paginator(query, page_size)
try:
page_list = paginator.page(page_no)
except (PageNotAnInteger, InvalidPage, EmptyPage):
# 页码无效时默认返回第一页
page_list = paginator.page(1)
page_no = 1
# 构建并返回分页数据
page_data = _build_page_data(page_list, paginator, page_no, page_size)
return R.ok(data=page_data)
except Exception as e:
logger.error(f"查询操作日志分页数据异常: {str(e)}")
return R.failed(msg="查询失败,请稍后重试")
def _apply_filters(queryset, request):
"""
应用查询筛选条件
Args:
queryset: 初始查询集
request: HttpRequest对象,包含筛选参数
Returns:
QuerySet: 应用筛选后的查询集
"""
# 操作标题模糊筛选
title = request.GET.get('title')
if title:
queryset = queryset.filter(title__contains=title)
# 操作类型筛选
log_type = request.GET.get('type')
if log_type and log_type.isdigit():
queryset = queryset.filter(type=int(log_type))
# 操作状态筛选
status = request.GET.get('status')
if status and status.isdigit():
queryset = queryset.filter(status=int(status))
# 操作来源筛选
source = request.GET.get('source')
if source and source.isdigit():
queryset = queryset.filter(source=int(source))
# 用户名筛选
username = request.GET.get('username')
if username:
queryset = queryset.filter(create_user__contains=username)
# IP筛选
ip = request.GET.get('ip')
if ip:
queryset = queryset.filter(ip__contains=ip)
return queryset
def _build_page_data(page_list, paginator, page_no, page_size):
"""
构建分页返回数据
Args:
page_list: 当前页数据列表
paginator: 分页器对象
page_no: 当前页码
page_size: 每页大小
Returns:
dict: 分页数据
"""
records = []
for item in page_list:
records.append({
'id': item.id,
'title': item.title,
'type': item.type,
'typeText': item.get_type_display(),
'source': item.source,
'sourceText': item.get_source_display(),
'method': item.method,
'requestMethod': item.request_method,
'url': item.url,
'param': truncate_json(item.param, 100),
'result': truncate_json(item.result, 100),
'ip': item.ip,
'location': item.location,
'os': item.os,
'browser': item.browser,
'consumeTime': item.consume_time,
'status': item.status,
'statusText': item.get_status_display(),
'error': item.error,
'createUser': item.create_user,
'createTime': format_datetime(item.create_time),
'updateUser': item.update_user,
'updateTime': format_datetime(item.update_time),
})
return {
'records': records,
'total': paginator.count,
'size': page_size,
'current': page_no,
'pages': paginator.num_pages
}
# =============================================================
# 详情查询服务
# =============================================================
def get_operation_log_detail(log_id):
"""
根据ID查询操作日志详情
Args:
log_id: 日志ID
Returns:
dict/None: 日志详情或None
"""
try:
# 查询未删除的日志记录
log = OperationLog.objects.filter(is_delete=0, id=log_id).first()
if not log:
return None
# 构建详情数据
detail = {
'id': log.id,
'title': log.title,
'type': log.type,
'typeText': log.get_type_display(),
'source': log.source,
'sourceText': log.get_source_display(),
'method': log.method,
'requestMethod': log.request_method,
'url': log.url,
'param': log.param,
'result': log.result,
'ip': log.ip,
'location': log.location,
'os': log.os,
'browser': log.browser,
'consumeTime': log.consume_time,
'status': log.status,
'statusText': log.get_status_display(),
'error': log.error,
'createUser': log.create_user,
'createTime': format_datetime(log.create_time),
'updateUser': log.update_user,
'updateTime': format_datetime(log.update_time),
}
# 格式化参数和结果
if detail.get('param'):
try:
detail['paramFormatted'] = json.loads(detail['param'])
except:
detail['paramFormatted'] = detail['param']
if detail.get('result'):
try:
detail['resultFormatted'] = json.loads(detail['result'])
except:
detail['resultFormatted'] = detail['result']
return detail
except Exception as e:
logger.error(f"查询操作日志详情异常,ID: {log_id}, 错误: {str(e)}")
return None
# =============================================================
# 删除服务(支持批量)
# =============================================================
def delete_operation_logs(log_ids):
"""
删除操作日志(批量逻辑删除)
Args:
log_ids: 日志ID字符串,多个ID用逗号分隔
例如: "1" 或 "1,2,3"
Returns:
R: 操作结果
"""
if not log_ids:
return R.failed("记录ID不存在")
try:
# 解析ID列表
id_list = [int(id_str.strip()) for id_str in log_ids.split(',') if id_str.strip()]
if not id_list:
return R.failed("无效的记录ID")
# 批量更新删除标识(逻辑删除)
updated_count = OperationLog.objects.filter(
id__in=id_list,
is_delete=0
).update(is_delete=1)
if updated_count == 0:
return R.failed("未找到可删除的日志记录")
return R.ok(msg=f"本次共删除{updated_count}条数据")
except ValueError:
return R.failed("记录ID格式错误")
except Exception as e:
logger.error(f"删除操作日志异常,IDs: {log_ids}, 错误: {str(e)}")
return R.failed(msg="删除失败,请稍后重试")
# =============================================================
# 记录日志服务
# =============================================================
def record_operation_log(request, title, log_type, status, source=0,
error_msg=None, consume_time=0, result=None):
"""
记录操作日志
Args:
request: HttpRequest对象
title: 操作标题
log_type: 操作类型
status: 操作状态(0-正常,1-异常)
source: 操作来源(0-后台,1-前台)
error_msg: 错误描述
consume_time: 请求耗时(毫秒)
result: 返回结果
Returns:
None
"""
try:
# 获取客户端IP
client_ip = get_client_ip(request)
# 获取地理位置信息(ip2region 直接返回字符串)
location_str = get_ip_location(client_ip)
# 解析User-Agent
user_agent = request.META.get('HTTP_USER_AGENT', '')
ua_info = parse_user_agent(user_agent)
# 获取请求参数
params = getattr(request, 'log_params', {})
param_str = format_params(params) if params else ''
# 格式化返回结果
result_str = format_result(result)
# 构建日志数据
log_data = {
'title': title[:150] if title else '',
'type': log_type,
'source': source,
'method': get_method_name(request),
'request_method': request.method,
'url': request.path[:1000] if request.path else '',
'param': param_str[:5000] if param_str else '',
'result': result_str[:5000] if result_str else '',
'ip': client_ip,
'location': location_str[:255] if location_str else '',
'os': ua_info['os'],
'browser': ua_info['browser'],
'consume_time': consume_time,
'status': status,
'error': error_msg[:500] if error_msg else '',
'create_user': get_username(request),
'update_user': get_username(request),
}
# 保存日志
OperationLog.objects.create(**log_data)
except Exception as e:
logger.error(f"记录操作日志异常: {e}")
+3
View File
@@ -0,0 +1,3 @@
from django.test import TestCase
# Create your tests here.
+93
View File
@@ -0,0 +1,93 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
操作日志模块路由配置
=============================================================
URL端点概览:
------------------------------------------------------------------------
| 功能说明 | 请求方法 | URL路径 | 视图类 |
|-----------------|----------|----------------------------------|----------------------------|
| 分页查询 | GET | /operation/log/page | OperationLogPageView |
| 详情查询 | GET | /operation/log/detail/<int:id> | OperationLogDetailView |
| 删除日志 | DELETE | /operation/log/delete/<ids> | OperationLogDeleteView |
------------------------------------------------------------------------
URL参数说明:
- log_id: int类型,日志ID(用于查询详情)
- log_id: str类型,逗号分隔的日志ID字符串(用于批量删除)
使用示例:
1. 分页查询:GET /api/operation/log/page?pageNo=1&pageSize=10&type=1
2. 详情查询:GET /api/operation/log/detail/5
3. 删除日志:DELETE /api/operation/log/delete/1,2,3
"""
from django.urls import path
from application.operation_log import views
# 操作日志模块路由配置
urlpatterns = [
# 查询操作日志分页列表
# URL: /operation/log/page
# 请求方法: GET
# 功能: 获取操作日志分页数据,支持按操作类型、操作来源、操作状态、时间范围等条件筛选
# 请求参数: pageNo(页码), pageSize(每页条数), type(操作类型), source(操作来源),
# status(操作状态), title(操作标题), method(请求方法), start_time(开始时间),
# end_time(结束时间)
path('page', views.OperationLogPageView.as_view()),
# 查询操作日志详情
# URL: /operation/log/detail/<int:log_id>
# 请求方法: GET
# URL参数: log_id - 日志ID(整数类型)
# 功能: 根据ID获取指定操作日志的详细信息,包括请求参数、返回结果、错误信息等
path('detail/<int:log_id>', views.OperationLogDetailView.as_view()),
# 删除操作日志
# URL: /operation/log/delete/<str:log_id>
# 请求方法: DELETE
# URL参数: log_id - 日志ID字符串,支持单个ID或逗号分隔的多个ID(如 "1,2,3")
# 功能: 删除指定操作日志(物理删除或逻辑删除,取决于业务需求)
# 注意: 操作日志通常用于审计,建议使用物理删除或定期归档清理
path('delete/<str:log_id>', views.OperationLogDeleteView.as_view()),
]
+166
View File
@@ -0,0 +1,166 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
操作日志视图模块
=============================================================
该模块定义了操作日志管理功能中使用的所有视图类。
用于处理操作日志的HTTP请求,包括分页查询、删除、清空等操作。
"""
from django.utils.decorators import method_decorator
from django.views import View
from application.operation_log import services
from config.env import DJANGO_DEMO
from middleware.login_middleware import check_login
from middleware.permission_middleware import PermissionRequired
from utils import R
# =============================================================
# 分页查询视图
# =============================================================
@method_decorator(check_login, name="get")
class OperationLogPageView(PermissionRequired, View):
"""
操作日志分页数据查询视图
处理GET请求,返回操作日志列表的分页数据。
支持按标题、类型、状态、时间范围等条件筛选。
URL: /operation/log/page
请求方法: GET
权限要求:sys:operationlog:page
"""
permission_required = ("sys:operationlog:page",)
def get(self, request):
"""
处理GET请求,返回操作日志分页数据
Args:
request: HttpRequest对象,包含分页参数和筛选条件
Returns:
JsonResponse: 包含分页数据的JSON响应
"""
result = services.get_operation_log_page(request)
return result
# =============================================================
# 详情查询视图
# =============================================================
@method_decorator(check_login, name="get")
class OperationLogDetailView(PermissionRequired, View):
"""
操作日志详情查询视图
处理GET请求,根据日志ID返回操作日志详细信息。
URL: /operation/log/detail/<int:log_id>
请求方法: GET
权限要求:sys:operationlog:detail
"""
permission_required = ("sys:operationlog:detail",)
def get(self, request, log_id):
"""
处理GET请求,返回操作日志详情
Args:
request: HttpRequest对象
log_id: int, 日志ID(从URL中获取)
Returns:
JsonResponse: 包含日志详细信息的JSON响应
"""
if not log_id or log_id <= 0:
return R.failed("日志ID无效")
detail = services.get_operation_log_detail(log_id)
if not detail:
return R.failed("日志记录不存在")
return R.ok(data=detail)
# =============================================================
# 删除视图(支持批量)
# =============================================================
@method_decorator(check_login, name="delete")
class OperationLogDeleteView(PermissionRequired, View):
"""
删除操作日志视图
处理DELETE请求,删除指定操作日志(支持批量删除)。
URL: /operation/log/delete/<str:log_id>
请求方法: DELETE
权限要求:sys:operationlog:delete
"""
permission_required = ('sys:operationlog:delete',)
def delete(self, request, log_id):
"""
处理DELETE请求,删除操作日志
Args:
request: HttpRequest对象
log_id: str, 日志ID字符串,多个ID用逗号分隔
例如: "1" 或 "1,2,3"
Returns:
JsonResponse: 包含操作结果的JSON响应
"""
if DJANGO_DEMO:
return R.failed("演示环境,暂无操作权限")
result = services.delete_operation_logs(log_id)
return result