# +====================================================================== # | 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()