签入版本

This commit is contained in:
2026-09-12 11:46:38 +08:00
commit c5a9d20cb8
932 changed files with 116861 additions and 0 deletions
+337
View File
@@ -0,0 +1,337 @@
# +======================================================================
# | DjangoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ]
# +----------------------------------------------------------------------
# | Copyright (c) 2021-2026 小蚂蚁云团队 版权所有
# +----------------------------------------------------------------------
# | 开源协议: Apache-2.0
# | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。
# +----------------------------------------------------------------------
# | 官方网站: https://www.djangoadmin.cn
# +----------------------------------------------------------------------
# | 研发团队: 小蚂蚁云团队 荣誉出品
# +======================================================================
# | 版权和免责声明:
# | 一、知识产权声明
# | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、
# | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权,
# | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。
# | 二、使用限制与禁止条款
# | 您理解并同意,禁止将本产品用于以下任何行为:
# | 1. 任何违反中华人民共和国法律法规的用途;
# | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为;
# | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。
# | 三、责任豁免
# | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失
# | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三
# | 方提起索赔或行政机关进行调查,您应独立承担全部责任。
# | 四、违约与法律责任
# | 如发现任何违反本声明的行为,本团队有权:
# | 1. 无条件配合公安机关及其他有权机关的调查取证工作;
# | 2. 依法追究相关方的民事责任,并要求赔偿全部损失;
# | 3. 保留进一步采取刑事控告等法律措施的权利。
# | 五、许可范围说明
# | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包
# | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通
# | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、
# | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造
# | 成的一切经济损失及商誉损害。
# | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件
# | 许可协议》附件为准。
# +======================================================================
"""
网站配置管理服务模块
=============================================================
该模块实现了网站前端配置管理相关的所有业务逻辑。
包括获取网站配置信息和保存网站配置信息等功能。
网站配置包括站点名称、Logo、SEO关键词、版权信息等前端展示内容。
命名规范:
- 函数参数使用驼峰命名(如 configId, pageNo)
- 数据库字段使用下划线命名(如 config_id, create_user)
- 返回数据使用驼峰命名(如 configId, configName)- 与前端规范保持一致
- 私有函数以下划线开头(如 _process_config_item)
"""
import json
import logging
from typing import Dict, Any
from application.config.models import Config
from application.config_item.models import ConfigItem
from utils import R
from utils.common import get_file_url, save_file
# =============================================================
# 辅助函数
# =============================================================
def get_content_url(content: str) -> str:
"""
处理富文本内容中的图片URL
将富文本内容中的图片相对路径替换为完整访问URL。
Args:
content: 富文本内容
Returns:
str: 处理后的富文本内容
"""
# 这里应该是富文本内容中图片URL的处理逻辑
# 示例:将相对路径替换为完整OSS URL
return content
def parse_options(options_str: str) -> Dict[int, str]:
"""
解析选项字符串
将选项字符串解析为字典格式,用于 select、radio、checkbox 等类型。
Args:
options_str: 选项字符串,格式如 "1=男,2=女,3=保密"
Returns:
Dict[int, str]: 解析后的字典,如 {1: '男', 2: '女', 3: '保密'}
"""
result = {}
if not options_str:
return result
# 替换中文逗号为英文逗号,兼容用户输入习惯
options_str = options_str.replace(",", ",")
options_list = options_str.split(",")
for option in options_list:
if "=" in option:
parts = option.split("=")
if len(parts) == 2:
try:
key = int(parts[0].strip())
value = parts[1].strip()
result[key] = value
except (ValueError, IndexError):
continue
return result
# =============================================================
# 获取配置数据服务
# =============================================================
def get_config_data() -> Dict[str, Any]:
"""
获取系统配置
查询所有配置类型及其下的配置项,返回格式化的配置数据。
Returns:
Dict[str, Any]: 配置数据列表,格式为:
[
{
"configId": 1,
"configName": "系统设置",
"dataList": [
{
"id": 1,
"name": "系统名称",
"code": "system_name",
"value": "我的网站",
...
}
]
}
]
"""
# 查询所有未删除的配置类型,按排序升序排列
config_queryset = Config.objects.filter(
is_delete=False
).order_by("sort").values("id", "name")
config_list = []
for config in config_queryset:
config_data = {
"configId": config["id"],
"configName": config["name"],
"dataList": []
}
# 查询该配置类型下所有启用且未删除的配置项,按排序升序排列
config_items = ConfigItem.objects.filter(
is_delete=False,
status=1, # 只查询启用状态的配置项
config_id=config["id"]
).order_by("sort").values()
if config_items:
for item in config_items:
item_data = _process_config_item(item)
if item_data:
config_data["dataList"].append(item_data)
config_list.append(config_data)
return config_list
def _process_config_item(item: Dict[str, Any]) -> Dict[str, Any]:
"""
处理单个配置项(私有辅助函数)
根据配置项类型对 value 进行格式化处理,如图片转URL、多选转列表等。
Args:
item: 配置项原始数据(字典)
Returns:
Dict[str, Any]: 处理后的配置项数据
"""
item_type = item["type"]
# 构建基础数据结构
data = {
"id": item["id"],
"configId": item["config_id"],
"name": item["name"],
"code": item["code"],
"value": item["value"],
"valueList": None, # 多值类型使用列表存储
"options": item["options"] or "",
"type": item_type,
"status": item["status"],
"sort": item["sort"],
"note": item["note"] or "",
"param": None # 存储解析后的选项参数
}
# 处理需要选项参数的类型(array, radio, checkbox, select, selects)
option_types = ["array", "radio", "checkbox", "select", "selects"]
if item_type in option_types and item["options"]:
param = parse_options(item["options"])
if param:
data["param"] = param
# 根据不同类型处理 value 值
if item["value"]:
# 多选类型(checkbox、selects):将值拆分为列表
if item_type in ["checkbox", "selects"]:
data["valueList"] = item["value"].split(",")
# 单图:转换为完整访问URL
elif item_type == "image":
data["value"] = get_file_url(item["value"])
# 多图:转换为完整URL列表
elif item_type == "images":
image_list = item["value"].split(",")
data["valueList"] = [get_file_url(img) for img in image_list if img]
data["value"] = data["valueList"][0] if data["valueList"] else ""
# 文件处理:格式为 "文件名|路径"
elif item_type in ["file", "files"]:
file_list = item["value"].split(",")
processed_list = []
for file_item in file_list:
if not file_item:
continue
# 使用 limit=2 分割,只分割第一个 "|"
parts = file_item.split("|", 1)
if len(parts) == 2:
file_name = parts[0]
file_path = parts[1]
full_url = f"{file_name}|{get_file_url(file_path)}"
processed_list.append(full_url)
else:
processed_list.append(file_item)
data["valueList"] = processed_list
data["value"] = processed_list[0] if processed_list else ""
# 富文本编辑器:处理内容中的图片URL
elif item_type == "ueditor":
data["value"] = get_content_url(item["value"])
return data
# =============================================================
# 保存配置数据服务
# =============================================================
def save_config_data(request):
"""
保存配置数据
接收前端提交的配置数据,根据编码查找对应的配置项并更新其值。
支持文本、图片上传、多图上传、文件上传等多种数据类型。
Args:
request: HttpRequest对象,包含配置数据的JSON体
Returns:
R: 操作结果(成功/失败)
数据格式示例:
{
"site_name": "我的网站",
"banner_images": ["img1.jpg", "img2.jpg"],
"logo": "logo.png"
}
"""
try:
# 步骤1:接收并解析请求参数
json_data = request.body.decode()
if not json_data:
return R.failed("参数不能为空")
data = json.loads(json_data)
except Exception as e:
logging.error(f"解析配置数据异常: {str(e)}")
return R.failed("参数错误")
# 步骤2:遍历处理每个配置字段
if data:
for key in data:
val = data[key]
# 步骤3:处理列表类型的数据(多图上传、复选框等)
if isinstance(val, list):
processed_items = []
for v in val:
# 判断是否为图片URL(以 http 或 https 开头)
if v[:4] == "http" or v[:5] == "https":
# 下载并保存图片到本地
url = save_file(v, "config")
processed_items.append(url)
else:
# 非图片URL的列表项直接添加
processed_items.append(v)
# 将列表转换为逗号分隔的字符串存储
val = ','.join(processed_items)
else:
# 步骤4:处理单个值的数据
# 判断是否为图片URL
if isinstance(val, str) and (val[:4] == "http" or val[:5] == "https"):
# 下载并保存图片到本地
val = save_file(val, "config")
# 普通文本直接使用原值
# 步骤5:根据编码查询对应的配置项
config_item = ConfigItem.objects.filter(is_delete=False, code=key).first()
if not config_item:
# 配置项不存在,跳过当前字段
continue
# 步骤6:更新配置项的值并保存
config_item.value = val
config_item.save()
# 步骤7:返回成功响应
return R.ok()