fred-admin 1.0.0__py3-none-any.whl

fred_admin/common/WechatLogin.py

@@ -0,0 +1,97 @@
+"""
+ * @Author：cyg
+ * @Package：WechatLoginService
+ * @Project：Default (Template) Project
+ * @name：WechatLoginService
+ * @Date：2025/4/2 15:34
+ * @Filename：WechatLoginService
+"""
+import uuid
+from urllib.parse import urlencode
+
+import requests
+from flask import current_app
+
+
+class WechatLogin:
+	def generate_qr(self):
+		"""
+		获取微信二维码接口
+		"""
+		# 生成唯一标识（用于关联二维码和用户）
+		state = str(uuid.uuid4())  # 防止 CSRF
+		data = {
+			"state": state,
+			"code": None,
+			"openid": None
+		}
+		# TODO 通过auth_url将data存入redis 然后再wechat_callback 设置其他值
+		# 构造微信授权 URL（二维码内容指向该 URL）
+		params = {
+			"appid": current_app.config.get("WECHAT_APP_ID"),
+			"redirect_uri": current_app.config.get("SITE_NAME") + f"/web/wechat/callback",
+			"response_type": "code",
+			"scope": "snsapi_login",
+			"state": state
+		}
+		auth_url = f"https://open.weixin.qq.com/connect/qrconnect?{urlencode(params)}#wechat_redirect"
+		
+		return {
+			"state": state,
+			"auth_url": auth_url  # 前端生成二维码
+		}
+	
+	def wechat_callback(self, args):
+		"""
+		微信回调
+		"""
+		code = args["code"]
+		state = args["state"]
+		# TODO 通过state获取redis中的值并修改data中的code和openid
+		# 通过 code 换取 access_token 和 openid
+		token_url = "https://api.weixin.qq.com/sns/oauth2/access_token"
+		params = {
+			"appid": current_app.config.get("WECHAT_APP_ID"),
+			"secret": current_app.config.get("WECHAT_APP_SECRET"),
+			"code": code,
+			"grant_type": "authorization_code"
+		}
+		response = requests.get(token_url, params=params).json()
+		
+		if "openid" not in response:
+			raise ValueError("Failed to get openid")
+		
+		openid = response["openid"]
+		access_token = response["access_token"]
+		#获取用户信息
+		info_url = f"https://api.weixin.qq.com/sns/userinfo?access_token={access_token}&openid={openid}"
+		user_info = requests.get(info_url).json()
+		""""
+		获取用户信息返回的数据:
+			{
+				"openid":"OPENID",
+				"nickname":"NICKNAME",
+				"sex":1,
+				"province":"PROVINCE",
+				"city":"CITY",
+				"country":"COUNTRY",
+				"headimgurl": "https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
+				"privilege":[
+				"PRIVILEGE1",
+				"PRIVILEGE2"
+				],
+				"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
+
+			}
+
+		"""
+		# 更新扫码状态（标记为已授权）
+		
+		return ""
+	
+	def check_login(self, args):
+		"""
+		异步轮询检查是否登录成功
+		"""
+		# TODO  前端轮询 检查微信是否回调成功
+		pass

fred_admin/common/__init__.py

@@ -0,0 +1,3 @@
+"""
+Common utilities and components for the Fred Framework.
+"""

fred_admin/config/Config.py

@@ -0,0 +1,104 @@
+from datetime import timedelta
+from pathlib import Path
+import os
+
+class Config:
+	"""
+	 appliction config
+	 custom config use CUSTOM_ For prefix
+	"""
+	PROJECT_ROOT = ""  # 项目根目录（配置文件在 项目根目录/common/config/Config.py）
+	# 以下目录结构已固定，无需配置
+	# CONFIG_DIR = "common/config"  # 配置目录
+	# MODEL_DIR = "common/model"    # 模型目录
+	# MODULES_DIR = "modules"       # 模块目录
+
+	SQLALCHEMY_DATABASE_URI = 'sqlite:///app.db'  # 本地开发默认 SQLite，可改为 MySQL
+	# SQLALCHEMY_DATABASE_URI = 'mysql+pymysql://user:pwd@127.0.0.1:3306/db'
+	# SQLALCHEMY_BINDS = {'otherdb':'mysql+pymysql://user:pwd@127.0.0.1:3306/db'}
+	ENABLE_SWAGGER = False
+	# Redis连接配置
+	REDIS_URL = ""
+	#REDIS_URL = "redis://:pwd@127.0.0.1:6379/1"
+	#返回数据是否加密
+	ENCRYPT_DATA = False
+	# 是否启用全局异常处理
+	ENABLE_GLOBAL_EXCEPTION = True
+
+	#默认密码
+	DEFAULT_PASSWORD = 'Fred@2025'
+	
+	# 配置邮件发送
+	MAIL_SERVER = ''  # 你的邮件服务器地址
+	MAIL_PORT = 25  # 你的邮件服务器端口
+	MAIL_USE_TLS = True  # 是否使用 TLS
+	MAIL_USERNAME = ''  # 你的邮箱用户名
+	MAIL_PASSWORD = ''  # 你的邮箱密码
+	MAIL_DEFAULT_SENDER = ''  # 默认发件人
+	
+	# JWT 配置
+	JWT_ACCESS_TOKEN_EXPIRES = timedelta(days=2)  # 有效时长
+	JWT_REFRESH_TOKEN_EXPIRES = timedelta(days=7)
+	
+	# 国际化默认配置
+	BABEL_DEFAULT_LOCALE = 'zh'
+	BABEL_DEFAULT_TIMEZONE = 'UTC'
+	
+	# 使用绝对路径指向项目根目录下的translations目录
+	BABEL_TRANSLATION_DIRECTORIES = os.path.join(PROJECT_ROOT, 'translations')
+	
+	SUPPORTED_LANGUAGES = ['en', 'zh']
+	
+	# Swagger UI 使用flask_smorest
+	API_TITLE = 'FredFrameApi'
+	API_VERSION = 'v1'
+	OPENAPI_VERSION = '3.0.2'
+	OPENAPI_URL_PREFIX = '/'
+	OPENAPI_SWAGGER_UI_PATH = '/docs' #swagger 访问地址
+
+	
+	# Swagger  参数配置
+	SPEC_KWARGS = {
+		'components': {
+			'securitySchemes': {
+				'bearerAuth': {
+					'type': 'http',
+					'scheme': 'bearer',
+					'bearerFormat': 'JWT'
+				}
+			}
+		},
+		'security': [{'bearerAuth': []}]  # 配置了默认方案 header中才会有Authorization
+	}
+	
+	# aliyun Sms
+	ALIBABA_SIGN_NAME = ''
+	ALIBABA_KEY_ID = ''
+	ALIBABA_KEY_SECRET = ''
+	ALIBABA_TEMPLATE_CODE = ''
+	
+	# 日志配置
+	LOG_LEVEL = 'DEBUG'
+	LOG_FILE = 'logs/app.log'
+	LOG_FORMAT = '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+	
+	#  定时任务 scheduler 配置
+	SCHEDULER_API_ENABLED = True
+	SCHEDULER_TIMEZONE = 'Asia/Shanghai'
+	JOBS = []
+
+	#  加载自定义模块 如果没有指定 将自动加载所有模块
+	LOAD_CUSTOM_MODULES = []
+	
+	# 首页加载模块 如果不配置 默认根目录下第一个模块
+	# HOME_MODULES = ""
+	
+	
+
+	# 路由与文件夹映射配置
+	# 格式: '路由前缀': '实际文件夹路径'
+	# 系统会自动注册 /<路由前缀>/<path> 路由，并映射到对应文件夹
+	ROUTE_CONFIG = {
+		'upload': 'upload',       # /upload/<path> -> upload/
+		'download': 'download'   # /download/<path> -> download/
+	}

fred_admin/config/Logger.py

@@ -0,0 +1,34 @@
+#!/usr/bin/env python3  
+# coding: utf-8
+"""  
+@author: Administrator  
+@date: 2024/12/19 21:03  
+@desc: 
+"""
+import logging
+import os
+from logging.handlers import RotatingFileHandler
+
+
+class Logger:
+	@staticmethod
+	def set_logger(app):
+		"""
+		日志记录配置
+		"""
+		# 获取日志文件路径
+		log_file_path = app.config.get('LOG_FILE', '')
+		if log_file_path == '':
+			return None
+		
+		# 确保日志目录存在
+		log_dir = os.path.dirname(log_file_path)
+		if not os.path.exists(log_dir):
+			os.makedirs(log_dir)
+		log_level = getattr(logging, app.config['LOG_LEVEL'].upper(), logging.INFO)
+		handler = RotatingFileHandler(app.config['LOG_FILE'], maxBytes=100000, backupCount=3)
+		handler.setLevel(log_level)
+		formatter = logging.Formatter(app.config['LOG_FORMAT'])
+		handler.setFormatter(formatter)
+		
+		app.logger.addHandler(handler)

fred_admin/config/__init__.py

@@ -0,0 +1,3 @@
+"""
+Configuration module for the Fred Framework.
+"""