Files
DjangoAdmin_Django_EleVue/application/config_web/services.py
T
2026-09-11 11:39:07 +08:00

338 lines
13 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# +======================================================================
# | 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()