24024
af7c11d7f9
- 新增图像生成接口，支持试用、积分和自定义API Key模式 - 实现生成图片结果异步上传至MinIO存储，带重试机制 - 优化积分预扣除和异常退还逻辑，保障用户积分准确 - 添加获取生成历史记录接口，支持时间范围和分页 - 提供本地字典配置接口，支持模型、比例、提示模板和尺寸 - 实现图片批量上传接口，支持S3兼容对象存储 feat(admin): 增加管理员角色管理与权限分配接口 - 实现角色列表查询、角色创建、更新及删除功能 - 增加权限列表查询接口 - 实现用户角色分配接口，便于统一管理用户权限 - 增加系统字典增删查改接口，支持分类过滤和排序 - 权限控制全面覆盖管理接口，保证安全访问 feat(auth): 完善用户登录注册及权限相关接口与页面 - 实现手机号验证码发送及校验功能，保障注册安全 - 支持手机号注册、登录及退出接口，集成日志记录 - 增加修改密码功能，验证原密码后更新 - 提供动态导航菜单接口，基于权限展示不同菜单 - 实现管理界面路由及日志、角色、字典管理页面访问权限控制 - 添加系统日志查询接口，支持关键词和等级筛选 feat(app): 初始化Flask应用并配置蓝图与数据库 - 创建应用程序工厂，加载配置，初始化数据库和Redis客户端 - 注册认证、API及管理员蓝图，整合路由 - 根路由渲染主页模板 - 应用上下文中自动创建数据库表，保证运行环境准备完毕 feat(database): 提供数据库创建与迁移支持脚本 - 新增数据库创建脚本，支持自动检测是否已存在 - 添加数据库表初始化脚本，支持创建和删除所有表 - 实现RBAC权限初始化，包含基础权限和角色创建 - 新增字段手动修复脚本，添加用户API Key和积分字段 - 强制迁移脚本支持清理连接和修复表结构，初始化默认数据及角色分配 feat(config): 新增系统配置参数 - 配置数据库、Redis、Session和MinIO相关参数 - 添加AI接口地址及试用Key配置 - 集成阿里云短信服务配置及开发模式相关参数 feat(extensions): 初始化数据库、Redis和MinIO客户端 - 创建全局SQLAlchemy数据库实例和Redis客户端 - 配置基于boto3的MinIO兼容S3客户端 chore(logs): 添加示例系统日志文件 - 记录用户请求、验证码发送成功与失败的日志信息
106 lines
3.7 KiB
Python
106 lines
3.7 KiB
Python
from __future__ import annotations
|
|
|
|
import typing as t
|
|
|
|
import sqlalchemy.exc as sa_exc
|
|
import sqlalchemy.orm as sa_orm
|
|
from flask import abort
|
|
|
|
from .pagination import Pagination
|
|
from .pagination import QueryPagination
|
|
|
|
|
|
class Query(sa_orm.Query): # type: ignore[type-arg]
|
|
"""SQLAlchemy :class:`~sqlalchemy.orm.query.Query` subclass with some extra methods
|
|
useful for querying in a web application.
|
|
|
|
This is the default query class for :attr:`.Model.query`.
|
|
|
|
.. versionchanged:: 3.0
|
|
Renamed to ``Query`` from ``BaseQuery``.
|
|
"""
|
|
|
|
def get_or_404(self, ident: t.Any, description: str | None = None) -> t.Any:
|
|
"""Like :meth:`~sqlalchemy.orm.Query.get` but aborts with a ``404 Not Found``
|
|
error instead of returning ``None``.
|
|
|
|
:param ident: The primary key to query.
|
|
:param description: A custom message to show on the error page.
|
|
"""
|
|
rv = self.get(ident)
|
|
|
|
if rv is None:
|
|
abort(404, description=description)
|
|
|
|
return rv
|
|
|
|
def first_or_404(self, description: str | None = None) -> t.Any:
|
|
"""Like :meth:`~sqlalchemy.orm.Query.first` but aborts with a ``404 Not Found``
|
|
error instead of returning ``None``.
|
|
|
|
:param description: A custom message to show on the error page.
|
|
"""
|
|
rv = self.first()
|
|
|
|
if rv is None:
|
|
abort(404, description=description)
|
|
|
|
return rv
|
|
|
|
def one_or_404(self, description: str | None = None) -> t.Any:
|
|
"""Like :meth:`~sqlalchemy.orm.Query.one` but aborts with a ``404 Not Found``
|
|
error instead of raising ``NoResultFound`` or ``MultipleResultsFound``.
|
|
|
|
:param description: A custom message to show on the error page.
|
|
|
|
.. versionadded:: 3.0
|
|
"""
|
|
try:
|
|
return self.one()
|
|
except (sa_exc.NoResultFound, sa_exc.MultipleResultsFound):
|
|
abort(404, description=description)
|
|
|
|
def paginate(
|
|
self,
|
|
*,
|
|
page: int | None = None,
|
|
per_page: int | None = None,
|
|
max_per_page: int | None = None,
|
|
error_out: bool = True,
|
|
count: bool = True,
|
|
) -> Pagination:
|
|
"""Apply an offset and limit to the query based on the current page and number
|
|
of items per page, returning a :class:`.Pagination` object.
|
|
|
|
:param page: The current page, used to calculate the offset. Defaults to the
|
|
``page`` query arg during a request, or 1 otherwise.
|
|
:param per_page: The maximum number of items on a page, used to calculate the
|
|
offset and limit. Defaults to the ``per_page`` query arg during a request,
|
|
or 20 otherwise.
|
|
:param max_per_page: The maximum allowed value for ``per_page``, to limit a
|
|
user-provided value. Use ``None`` for no limit. Defaults to 100.
|
|
:param error_out: Abort with a ``404 Not Found`` error if no items are returned
|
|
and ``page`` is not 1, or if ``page`` or ``per_page`` is less than 1, or if
|
|
either are not ints.
|
|
:param count: Calculate the total number of values by issuing an extra count
|
|
query. For very complex queries this may be inaccurate or slow, so it can be
|
|
disabled and set manually if necessary.
|
|
|
|
.. versionchanged:: 3.0
|
|
All parameters are keyword-only.
|
|
|
|
.. versionchanged:: 3.0
|
|
The ``count`` query is more efficient.
|
|
|
|
.. versionchanged:: 3.0
|
|
``max_per_page`` defaults to 100.
|
|
"""
|
|
return QueryPagination(
|
|
query=self,
|
|
page=page,
|
|
per_page=per_page,
|
|
max_per_page=max_per_page,
|
|
error_out=error_out,
|
|
count=count,
|
|
)
|