public/FastapiAdmin
1
0
Fork 0
mirror of https://github.com/fastapiadmin/FastapiAdmin.git synced 2026-10-14 13:06:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
1,203 Commits 5 Branches 3 Tags
a4e8727a868c2349499e0964fe94a06245ec505f
Commit Graph
486 Commits
Author SHA1 Message Date
zhangtao a4e8727a86 chore(backend): 新增 basedpyright 校准配置，并修复它暴露的三处真缺陷 
背景：仓库此前没有 pyright/basedpyright 配置，basedpyright 使用自身默认（≈recommended），
在 app/ 下产生 247 errors / 3799 warnings，其中 143 条是 reportMissingTypeArgument
（未参数化泛型）这类注解完整度噪音，会把真缺陷淹没（例如 OSS 的 Client.uploader 方法误用）。

配置（backend/pyrightconfig.json）
- typeCheckingMode: basic；显式把能抓真缺陷的规则保持为 error
  （reportAttributeAccessIssue / reportArgumentType / reportOptionalMemberAccess /
  reportIncompatibleMethodOverride / reportConstantRedefinition / reportMissingImports 等）
- 关闭注解完整度与风格类规则；tests/ 用 executionEnvironments 单独放宽（extraPaths 保证 app 可解析）
- 结果：app + main.py + tests 全量 0 errors
- 红绿验证：合成「str | None 传参」「MethodType 上取属性」「Optional 成员访问」三类
  仍全部报 error，证明校准没有把真缺陷一起关掉

修复配置暴露的三处真缺陷
1) template_safety.py：_SQLALCHEMY_TYPE_WHITELIST 对全大写常量二次赋值 → 合并为一次成型
2) template_safety.py：normalize_column_type 假定 _TYPE_BASE_RE 必命中（用 # type: ignore 盖住，
   None 时 .group() 会崩）→ 改为 None 安全，去掉 type-ignore
3) node/service.py ×2：CustomException(msg=reason) 中 reason 为 str | None，客户端可能收到空文案
   → 新增 SchedulerUtil.require_schedulable() 收敛「判定 + 抛异常 + 兜底文案」，调用点改为一行

验证：basedpyright 0 errors（原 247）；ruff All checks passed；pytest 97 passed；
      已部署并线上复验（四端 200、Host 收窄、伪造令牌被拒、验证码过期 400 保留业务文案、
      容器内 require_schedulable 与 OSS 调用修正均已生效）
 2026-10-04 06:00:16 +08:00
zhangtao b3882559de fix(storage): 修复类型检查暴露的三处缺陷（含 OSS 上传运行时 bug） 
basedpyright 报出的三处，逐条定位后发现都不是「标注问题」：

1) oss_adapter.py:70 —— 真运行时 bug
   SDK 里 `Client.uploader` 是**方法**（`def uploader(self, **kwargs) -> Uploader`），
   原写法 `self.client.uploader.upload_file(...)` 是在绑定方法上取属性，运行时必抛
   AttributeError —— 即 OSS 上传链路从未成功过（生产未配 OSS 源，故未暴露）。
   已改为 `self.client.uploader().upload_file(...)`，并按 SDK 签名核对
   `upload_file(request, filepath, part_size=..., parallel_num=...)` 参数正确。

2) sftp_adapter.py:45 —— 缺主机校验
   `config.host` 为 `str | None`（对象存储可不填），却直接传给 paramiko
   `connect(hostname: str)`。已把 host 并入既有的用户名/密码守卫，
   缺主机时返回业务异常 400「SFTP 存储源必须配置主机、用户名与密码」。

3) ftp_ftps_adapter.py:58 —— 同上
   `_new_client()` 增加主机守卫（400「FTP 存储源必须配置主机地址」，并补 CustomException 导入）；
   顺带修复同文件 `_ImplicitFTP_TLS.connect` 覆写签名与 ftplib.FTP 不兼容
   （timeout: float、source_address: tuple[str, int] | None），消除该文件最后一条 error。

验证：basedpyright 这三个文件 0 errors（修复前 4 条）；ruff 全绿；pytest 97 passed；
      运行时探针：缺主机 → 拦截为 400 业务异常；配主机 → 守卫放行并进入真实连接（ConnectionRefused 如期）。
 2026-10-04 05:49:27 +08:00
zhangtao 644d262cad refactor(backend): 错误码收敛为单一事实来源，统一异常写法 
错误码（t16）
- HTTP 语义只由 core/exceptions.py 的 RET.code → fastapi.status 映射决定；
  映射表显式登记 -1→400 与全部「数值即 HTTP 状态」的 RET 成员，_DEFAULT_BUSINESS_STATUS
  降为「新增码忘登记」的安全网
- 移除冗余 status_code：131 处调用点改为纯 code 表达；security.py/dependencies.py
  的 status_code=401/403 去除（映射表已给）；get_or_404 → code=RET.NOT_FOUND.code
- 新增静态护栏（AST）：app/ 下除 exceptions.py 外不得出现 status_code 传参，
  路由装饰器 201 白名单显式放行并断言白名单非空

异常写法统一（t19）
- 删除 CustomException.internal 及 132 处包装：意外异常直接冒泡，由全局
  @app.exception_handler(Exception) 统一映射 5xx + 通用文案 + 日志；
  需要运维上下文处改为 logger.exception("<业务动作>失败") + raise
- 构造器不再接受 status_code 参数（属性保留，由 code 派生）→ 结构上杜绝第二来源
- 修复 6 处「宽泛 except 把 400 包成 500」的语义反转（补 except CustomException: raise），
  并加 AST 护栏防止回潮
- 全局 SQLAlchemyError：非完整性错误由 400 改为 503（连接类）/500（其它），
  不再把驱动原文/异常类型拼进客户端 msg；顺带修掉不存在的
  status.HTTP_403_SERVICE_UNAVAILABLE 常量（命中即 AttributeError→500）

验证：pytest 97 passed / ruff 全绿；AST 审计残留 0；护栏红绿测试通过；
线上实测验证码过期仍 400 并保留业务文案、无令牌 401。
 2026-10-04 05:44:21 +08:00
zhangtao 07fa789d2e fix(backend): 安全默认值、异常语义、代码生成注入面与定时任务内置处理器 
本批为 t10 → t13 → t15 三轮实现 + 一轮复核驳回整改的最终形态（pytest 83 passed / ruff clean，
已部署并线上验证）。

异常语义
- CustomException 默认状态码 500 → 400（约 433 处裸调用不再被计为服务端故障），
  且「包装底层异常」的 130 处显式恢复 500；get_or_404 → 404；响应体结构不变

代码生成注入面（复核 blocker F1，二次修复）
- column_type 不再做字符串拼接：改为常量白名单派生（类型名 ∈ DB_TO_SQLALCHEMY ∪ {Boolean}，
  长度仅取数字/正则捕获），彻底移除 split("(")[1]
- 列类型加形状白名单；字符串/注释/文档字符串用 \uXXXX，标识符过 safe_ident（含 Python/JS 关键字），
  .vue 文本与静态属性改 HTML 实体
- 落盘闸门由 ast.parse 升级为 assert_python_structure（语法 + 顶层语句白名单 + 与哨兵骨架逐节点比对）
  与 assert_text_structure（.vue/.ts/.toml 行结构）；U+2028/2029 与 C1 控制符纳入转义

安全默认值
- 生产 CORS 不再回落 ["*"]（未配置即拒绝跨域，可选 CORS_STRICT_STARTUP 直接启动失败）
- OAUTH_ALLOWED_HOSTS 不再默认 "*"；新增 ALLOW_LOCALHOST_HOSTS 控制 Host 校验范围
- ALLOWED_HOSTS 收窄为按配置派生；健康检查暴露 code_exec_enabled / cors_origins_configured

定时任务
- SCHEDULER_ALLOW_CODE_EXEC 默认 False；新增 builtin:<模块名>[.<函数名>] 内置处理器路线（不经 exec）
- 判定收敛到 describe_schedulability；列表返回 schedulable / unschedulable_reason；
  启动 reconcile 与状态查询对「已启用但不可调度」打 WARN（去重、恢复后清除）
- 加固：内置处理器必须在本模块内定义或经 HANDLERS 声明，拒绝模块内导入的外部对象（复核 R1）
- 顺带修复：_WARNED_UNSCHEDULABLE 的 set.pop TypeError、job.next_run_time 缺失导致的列表 500

测试：新增 tests/test_generator_template_safety.py、test_security_defaults.py、
test_scheduler_schedulability.py（含恶意载荷、闸门红绿、静态护栏）
 2026-10-04 05:12:32 +08:00
zhangtao 28bf232761 docs(audit): 全栈审计报告（7 份分报告 + 总报告） 
由 7 名成员并行审计 + 队长线上实测复核产出，合计约 3,600 行：
- backend/audit-backend.md      后端架构与代码质量（22 条）
- backend/audit-security.md     认证/授权/敏感信息（23 条）
- backend/audit-testing.md      测试与可验证性（含真实命令输出）
- backend/audit-requirements.md 需求覆盖对照（多租户规格错位）
- frontend/audit-frontend.md    前端与移动端工程（32 条）
- frontend/audit-uxui.md        交互与视觉一致性
- docker/audit-deploy.md        容器化与部署链路
- AUDIT-REPORT.md               总报告：止血项、修复路线、待决策事项、对既有结论的修正

各报告均标注级别、文件:行号、影响、建议修法，并单列未验证项与抽样边界。
 2026-10-04 04:26:11 +08:00
zhangtao ce9401196a chore(deploy): 成品部署链路、依赖分组与运维基建 
部署方式：服务器不再接收源码、不执行构建，改为本地构建成品后交付
- deploy-artifacts.sh：构建→备份→校验→原子替换，支持回滚、镜像/备份轮转、
  mysql 与 postgres 双变体镜像；后端以 docker save|ssh|docker load 交付
- 依赖分组：requirements/{base,storage}.txt + db/{mysql,postgres,sqlite}.txt，
  镜像按所选数据库只装对应驱动（MySQL 变体 565MB → 521MB）

编排与运行时加固
- compose：MySQL/Redis/backend 端口仅绑 127.0.0.1；密钥（SECRET_KEY、
  DATA_ENCRYPTION_KEY、DATA_ENCRYPTION_OLD_KEYS）、PROD_CORS_ORIGINS、
  FORWARDED_ALLOW_IPS、DEMO_ENABLE 一律由 docker/.env 注入
- Dockerfile：对齐依赖分组、以非 root(uid=1000) 运行；.dockerignore 排除全部真实 .env.*
- nginx：静态资源长缓存、隐藏文件拒绝、接口文档仅内网可访问、放行 ACME http-01 校验路径

工程基建
- 新增 CI：backend（uv sync + ruff + pytest）与 frontend（web type-check+vitest、app type-check）
- 新增 DEPLOYMENT.md 运维手册（部署/回滚/密钥轮换/每日巡检/证书/排查）
 2026-10-04 04:26:03 +08:00
zhangtao 0cf2e24b92 fix(frontend,backend): 修复两处配置与逻辑问题 
1. 修复前端节点选择框选项显示异常问题，将字符串数组转为标准label-value格式
2. 简化后端alembic配置文件，移除冗余注释与废弃配置项
 2026-09-17 20:56:18 +08:00
zhangtao f12a40090a fix: 修复主键类型非Integer时的模型生成与导入问题 
1. 前端将MySQL主键默认类型从bigint改为int，同步后端代码适配
2. 增加SQLAlchemy主键类型自动导入逻辑，当主键类型不是Integer时自动添加对应导入
3. 重构模型模板，当主键类型与基类不一致时显式覆盖id字段定义
 2026-09-13 22:17:49 +08:00
zhangtao f15fdb86c0 feat(ticket,monitor): add ticket stats api and optimize server ip fetch 
1. add TicketStatsSchema for work status aggregate
2. add stats method to TicketService to count pending/processing/done tickets
3. add ticket stats api endpoint
4. optimize server local ip detection with fallback logic
 2026-09-12 12:33:00 +08:00
zhangtao 8d7efb6c58 refactor: 移除数据大屏页面及相关组件，更新滚动容器逻辑与配置 
1. 移除dashboard数据大屏页面及全部依赖的图表、统计组件
2. 重构主滚动容器选择逻辑，统一使用getMainScrollEl获取滚动元素
3. 更新配置项，添加TRUSTED_PROXY_HOPS与IP2REGION相关配置
4. 替换IP归属地查询为离线本地解析，移除相关HTTP请求配置
5. 简化OAuth与微信小程序登录的background_tasks参数传递
6. 修复系统参数描述与前端提示文案，更新alembic版本清理逻辑
7. 简化页面滚动重置逻辑，过滤隐藏标签页
 2026-09-12 01:16:03 +08:00
zhangtao 8b63042ecf feat(generator): add python plugin template and fix frontend static path 
1. 新增python包初始化模板和插件元数据模板
2. 修复前端静态文件挂载路径硬编码问题，使用配置中的FRONTEND_DIST_DIR
3. 优化代码生成模板中日期验证器的计算逻辑，改用jinja2过滤器一次性计算
4. 新增toml文件的文件图标适配
5. 更新文档说明代码生成后需要重启后端以及静态托管的注意事项
 2026-09-10 21:22:09 +08:00
zhangtao e39a369bac refactor: 优化前端缓存与WebSocket连接处理，新增开发指南文档 
1. 调整FastAPI前端挂载配置，简化目录路径并添加目录检查关闭注释
2. 修复工作标签页清空时的KeepAlive缓存泄漏问题，正确驱逐非固定标签缓存
3. 优化AI聊天页WebSocket连接逻辑，避免连接泄漏与竞态问题，添加生命周期缓存清理
4. 新增全栈开发指南SKILL.md，覆盖工程结构、命令、约定与常见坑点
 2026-09-10 00:35:17 +08:00
zhangtao 8cb5f17811 chore: 移除全局 API 与 WS 限流并修复代理配置 
移除 fastapi-limiter 依赖及相关限流逻辑，更新健康检查请求头并信任反向代理转发头，避免生产环境 HTTPS 误判导致 301 循环。
 2026-09-07 01:54:13 +08:00
zhangtao a8d29d4ab4 fix: 修复多项后端缺陷并加固安全与限流 
- 修正 AI 会话表初始化及异步数据库 URI 处理
- 新增全局 API 与 WS 聊天限流，健康检查豁免
- 修复忘记密码接口防用户枚举与参数校验
- 修复 SSE 推送数据重复编码问题
- 修复 Cron 表达式 Quartz 问号兼容
- 修复存储模块权限标识前缀
- 新增过期日志清理与任务错误中文提示
 2026-09-07 00:08:00 +08:00
zhangtao e340053efa docs(readme): 更新项目说明与界面截图 
补充移动端截图、Docker 部署说明与 Star History，同时更新后端技术栈版本和项目结构描述。
 2026-09-06 20:52:11 +08:00
zhangtao 9e80f970d0 refactor(task): 重构定时任务与存储路由 
- 移除各路由文件顶部冗余注释
- 将 JobRouter/NodeRouter 重命名为 CornJobRouter/CornJobNodeRouter
- 新增存储浏览、节点、传输、工作流路由注册
- 调整路由导入来源与任务表名
- 优化 main.py 启动方式及环境配置加载
 2026-09-06 04:14:17 +08:00
zhangtao d470c7eb1f refactor(backend): 调整模块结构、调度器逻辑与健康检查路由 2026-09-06 00:54:24 +08:00
zhangtao 92081815f4 refactor(backend): 将模块从 api/v1 移至 backend 根目录 2026-09-06 00:54:11 +08:00
zhangtao 3f472d1e89 refactor: 重构存储与工作流模块，调整目录结构与初始化逻辑 
1.  迁移存储模块功能到工作流模块，合并冗余代码
2.  调整环境配置加载路径与初始化脚本目录
3.  更新文档与前端组件代码适配重构
4.  新增工作流相关CRUD、模型与迁移文件
5.  移除过期模块与冗余代码，优化日志配置
 2026-09-03 21:55:31 +08:00
zhangtao 001d1bdf4c feat: add storage module, internal chat and workflow enhancements 
- 新增多协议存储模块（支持FTP/SFTP/S3/OBS/OSS/COS/本地存储），包含存储源管理、文件操作、传输任务功能
- 新增系统内部聊天模块，支持WebSocket实时通信与未读统计
- 优化工作流节点系统，支持内置业务节点并完善配置面板
- 修复健康检查接口路径与菜单角标显示逻辑
- 新增SQLite WAL模式与busy_timeout配置优化并发性能
- 更新依赖与文档，支持模块裁剪配置
 2026-08-19 23:20:39 +08:00
zhangtao 11160b05e4 refactor(auth): 优化IP归属地处理逻辑，调整缓存与展示 
1. 调整IP归属地缓存TTL从7天改为30天
2. 优化登录IP列展示，增加whitespace-nowrap类并加宽最小宽度
3. 新增异步补全OAuth/微信登录会话归属地逻辑
4. 重构IP归属地工具类，统一降级文案与查询决策逻辑
5. 修复部分类型检查与异常处理问题
 2026-08-16 02:57:19 +08:00
zhangtao 9e41358945 feat(console): add database type display in startup status 
1. 新增database_type参数传递到控制台启动函数
2. 在启动状态面板中显示实际数据库类型替代硬编码的MySQL
3. 更新函数文档注释说明新增的参数
 2026-08-10 20:49:08 +08:00
zhangtao e4cd0bc82a chore: 清理废弃文档与旧版静态资源 
清理了小程序相关的三份交付文档、两张旧的后端静态资源文件，并更新了前端首页、我的页的三张应用截图资源
 2026-08-09 21:03:28 +08:00
zhangtao ffbe2453f2 refactor: 小程序端代码瘦身与功能补齐 
- 清理冗余代码与配置：
  - 删除废弃的 mock 适配器、通用 mock 模块与示例API
  - 移除冗余的 ts 类型文件与 patch 目录
  - 简化 tsconfig 组件路径配置
- 新增功能与优化：
  - 新增全局水印组件与水印配置
  - 接入微信小程序登录/手机号登录
  - 新增系统参数配置 store 与国际化支持
  - 新增 markdown 渲染插件与样式配置
  - 优化 pinia 持久化逻辑修复
  - 新增微信小程序 access_token 缓存配置
  - 修复登录趋势数据结构定义
  - 优化全局请求防抖重定向逻辑
- 页面与路由优化：
  - 补全引导页首次启动逻辑
  - 统一页面底部安全区适配
  - 更新页面路由类型声明
- 代码质量优化：
  - 移除无用 console.log 调试代码
  - 修复全局弹窗重复重登录问题
  - 优化 mp-html 组件配置
 2026-08-05 23:47:49 +08:00
zhangtao 12ad43914f refactor(app): 清理前端冗余代码并优化页面布局 
1. 移除多个废弃的API模块、组件和页面文件
2. 重构个人中心和工作台的菜单结构
3. 替换旧分页组件为官方WdPagination
4. 统一空状态提示为wd-empty组件
5. 优化卡片布局和样式
6. 简化骨架屏实现逻辑
7. 调整首页通知栏样式适配暗色模式
 2026-08-04 20:51:58 +08:00
zhangtao eb6698d6fb chore(env): 合并多环境示例配置为统一的.env.example 
删除了原先分开的开发、测试、生产环境配置示例文件，整合为一个通用的环境配置示例文件，方便用户根据需要自行修改适配不同环境
 2026-07-27 22:32:09 +08:00
zhangtao 95ab722232 refactor(cronjob): 优化定时任务状态展示逻辑 
新增状态常量映射表，将原始状态码转换为中文可读状态，替换直接返回状态码的逻辑
 2026-07-27 00:46:41 +08:00
zhangtao 92f65c403d refactor(middlewares): 重构HTTPS重定向中间件以支持代理头 
替换原生HTTPSRedirectMiddleware，新增支持读取X-Forwarded-Proto头来适配反向代理场景
 2026-07-27 00:34:05 +08:00
zhangtao 698e198280 chore: 整理项目配置与代码优化 
1.  统一前端环境变量命名，新增通用项目标题配置
2.  修复后端接口参数绑定方式，将Depends改为Query适配FastAPI解析
3.  优化表格列排序、搜索过滤功能与页面布局样式
4.  重构路由与状态管理代码，移除循环依赖
5.  更新依赖版本与脚本命令，修复构建警告
6.  调整多语言文案与快捷入口配置
7.  修复通知中心样式与接口返回格式
 2026-07-26 23:33:17 +08:00
zhangtao df00863b6c chore: 批量清理冗余样式、优化权限系统与重构业务逻辑 
1.  重构权限检查逻辑，移除旧版 auth/roles 自定义指令，统一使用 checkPerm 工具函数
2.  简化角色数据权限配置，移除自定义数据范围功能，简化为3种权限模式
3.  批量删除多处冗余的scoped样式，迁移全局布局与组件样式
4.  优化表单、表格、弹窗等基础组件样式与交互
5.  新增全屏国际化文案与工具类样式
6.  修复通知列表空值兼容、接口调用权限校验等细节问题
7.  更新依赖与自动导入配置，移除未使用的 vue3-cron-plus 包
 2026-07-26 09:17:04 +08:00
zhangtao 2059b6c530 移除sql 2026-07-24 02:03:55 +08:00
zhangtao 096fa8e6da refactor: 清理无用导入、重构组件路径与统一依赖导入 
1.  移除 .prettierignore 和 tsconfig.json 中对 src/types/import/ 的配置
2.  全局替换 @/utils/message 导入为直接从 element-plus 导入组件
3.  移动并统一组件路径：将 widget/fa-icon-button 迁移至 others/fa-icon-button
4.  新增多环境配置示例文件与docker部署配置
5.  补充类型导入与类型文件统一导出
6.  修复卡片样式与布局细节问题
7.  移除过时的 initIconify 同步初始化函数
 2026-07-24 02:03:07 +08:00
zhangtao 77860b0478 chore: 删除所有冗余的本地环境配置文件 
移除了前后端及docker的多套环境变量配置文件，统一使用中心化配置方案来管理环境变量
 2026-07-24 02:02:48 +08:00
zhangtao 0ce31936aa chore: 清理冗余代码与配置，优化项目结构 
1.  删除无用文件与废弃代码：移除locale枚举、element-plus插件、sse路由、api token模块等
2.  简化类型导入与依赖：移除大量未使用的类型导入，统一echarts导入方式
3.  优化配置与样式：调整gitignore、样式引入顺序，新增列表动画样式
4.  修复接口与模型：修正接口返回类型、查询参数配置，更新部门模型字段
5.  优化性能与体验：添加图片懒加载，优化加载逻辑与表格渲染
6.  调整环境配置：新增并更新开发/生产环境配置文件
 2026-07-23 20:49:52 +08:00
zhangtao 096e2216d6 refactor: 完成多租户架构移除与系统模块重构 
1. 移除所有租户相关逻辑：删除租户ID查询参数、租户字段、租户存储相关代码
2. 重构菜单系统：合并platform/system菜单模块，调整菜单作用域为web/app
3. 修复导出接口：统一post请求使用body传参，替换get导出为post
4. 优化权限标识：更新权限路由前缀为module_system
5. 简化菜单过滤逻辑：移除工作区模式判断，直接展示所有菜单
6. 移除租户切换、代签入等无关功能组件与状态
7. 新增用户注册功能与工单导出接口
 2026-07-18 01:09:23 +08:00
zhangtao 158c14a46d refactor: 项目代码整理与依赖优化 
主要变更：
1.  替换默认部门名称为系统部门
2.  简化SQLAlchemy异步导入语句
3.  移除request_context.py与相关依赖，重构请求上下文逻辑
4.  替换旧的日志链路ID实现，将代码整合到logger.py
5.  简化WebSocket限流逻辑，移除冗余import
6.  删除多个模块的测试文件：common/ai/example/generator/monitor/task
7.  移除cron_util.py，改用croniter库实现Cron表达式校验
8.  优化系统参数Redis缓存键格式，移除多余的:1:前缀
9.  简化初始化脚本逻辑，移除日期自动转换逻辑
10. 简化动态路由发现代码，移除热重载相关逻辑
11. 简化认证逻辑，移除request.state.ctx相关操作
12. 修复定时任务调度器调用方式，移除await
13. 新增修改定时任务接口
14. 新增croniter依赖并更新相关配置
15. 优化数据库异常日志格式化方式
16. 简化base_schema.py空行格式
17. 移除initialize.py中的冗余依赖导入
 2026-07-17 23:19:37 +08:00
zhangtao 53c8f67bd5 refactor: 移除多租户相关逻辑并清理冗余代码 
本次提交完成以下主要变更：
1.  删除所有租户相关的初始化数据、配置和工具代码
2.  移除TicketModel的租户关联字段与校验逻辑
3.  重构菜单表名与关联外键，统一为sys_前缀
4.  为岗位、部门、工作流等模型添加唯一约束
5.  调整导入顺序与冗余代码，优化代码结构
6.  移除支付、PDF生成相关的依赖与工具类
7.  简化OpenAPI文档标签配置
8.  清理无效的枚举与冗余导入
 2026-07-17 01:07:17 +08:00
zhangtao c0b9c22650 feat(ticket): 添加工单管理完整模块 
实现了工单的增删改查、列表查询、详情查看、批量更新以及工单评论功能，包含数据模型、CRUD操作、API路由和业务逻辑
 2026-07-17 01:06:41 +08:00
zhangtao a222cd9e43 refactor: 移除多租户相关代码，重构为单租户架构 
此次提交进行了大规模的架构重构：
1.  移除所有平台租户相关模块和代码，包括租户管理、套餐、订单、发票等功能
2.  将菜单模块从platform迁移到system模块，统一系统功能入口
3.  移除租户隔离相关的模型混入、中间件和配置
4.  简化文件上传、SSE事件总线、定时任务等模块的租户逻辑
5.  重构所有业务schema和模型，移除租户相关字段和关联
6.  清理初始化脚本、模板和常量中的租户相关代码
7.  简化认证和权限控制逻辑，移除数据范围检查相关代码
 2026-07-16 23:22:45 +08:00
zhangtao f74b5f277e refactor: 重构查询参数处理逻辑，统一搜索参数处理 
- 移除各模块查询schema中的自定义model_validator，统一通过search_to_dict处理搜索参数
- 为需要的字段添加json_schema_extra标记查询操作类型
- 重构base_crud的条件解析逻辑，支持直接处理普通字符串、数字类型参数
- 重构base_schema中的公共查询参数校验逻辑，简化时间范围和创建更新人参数处理
- 修复菜单查询的异步懒加载问题，添加多级预加载
- 调整日志打印配置，关闭uvicorn.access重复日志
- 修复前端路由跳转路径错误
- 调整弹窗宽度适配内容
- 修复测试环境限流器未注册问题
- 清理无用的导入和废弃函数
 2026-07-16 01:19:03 +08:00
zhangtao 3f7d5aa4b9 chore: 完成项目多批次优化与功能迭代 
本次提交包含多项改进：
1. 国际化补充：新增通知空状态文案中英文支持
2. 启动优化：重构banner输出、移除环境参数依赖，简化启动日志
3. 配置清理：移除冗余的REDIS_ENABLE/SQL_DB_ENABLE配置项，同步更新env示例与测试配置
4. 接口分页改造：将全局分页参数从Query改为Depends自动解析，统一排序逻辑
5. 菜单权限优化：调整菜单可见范围默认值、修复平台菜单路由路径错误
6. 异常处理增强：完善数据库异常捕获逻辑，新增连接失败专项处理
7. API令牌重构：重命名API令牌路由与权限标识，拆分前端API文件
8. 定时任务整合：将系统任务注册移入调度器初始化逻辑
9. 数据库连接优化：新增连接检查，简化建表/删表逻辑
10. 控制台美化：重构启动控制台面板，优化信息展示格式
11. 租户/角色服务优化：移除不必要的超级管理员装饰器，统一分页排序逻辑
12. 用户菜单适配：修复超级用户菜单过滤逻辑，移除scope强制校验
 2026-07-15 01:21:53 +08:00
zhangtao 8d0e76c694 refactor: 统一初始化数据文件存放路径并清理冗余脚本数据 
1. 将所有初始化数据文件从app/scripts/data迁移至backend/sql/data目录
2. 更新path_conf.py中的SCRIPT_DIR配置指向新路径
3. 移除app/scripts/data下的冗余初始化数据文件
4. 清理权限缓存相关的进程级缓存逻辑
5. 调整部分代码导入顺序和冗余依赖
6. 简化用户菜单获取逻辑，移除菜单树缓存
7. 调整套餐菜单设置接口，移除redis参数传递
 2026-07-13 01:38:51 +08:00
zhangtao cf88ab8897 refactor: 整合仪表盘功能到监控模块，清理冗余代码 
- 移除原监控仪表盘独立模块，将相关功能合并到在线监控模块
- 重构租户配置字段名，统一使用logo_url和name替代tenant_logo/tenant_name
- 优化搜索工具函数，移除重复导入
- 调整参数配置模型字段长度限制，移除config_value的max_length约束
- 清理冗余的常量定义和导入语句
- 修复批量状态设置接口的redis依赖注入
- 增强OAuth登录安全性，添加租户默认归属和state一次性消费
- 优化资源目录缓存逻辑，减少重复计算
- 新增API Token模块基础框架
- 完善用户token版本管理，支持主动失效JWT
- 调整AI模型配置缓存过期时间
- 修复菜单类型字段索引，提升查询性能
- 简化前端刷新token调用逻辑
- 新增滑块验证完成接口和忘记密码验证码校验
- 调整系统配置默认值，添加操作日志保留天数和接口白名单配置
- 限制Mock支付回调仅在开发环境可用
- 重构websocket认证方式，支持更安全的subprotocol传参
 2026-07-13 01:14:20 +08:00
zhangtao 6a5f8cf0dd refactor: 完成项目大规模重构与功能优化 
这是一次综合性的项目迭代，包含以下核心变更：
1.  **目录与模块重构**
    - 调整工作流节点类型模块目录结构，迁移节点类型相关代码
    - 重命名platform模块为system模块，更新插件配置信息
    - 重构代码生成模块导入路径
2.  **数据库与CRUD优化**
    - 统一所有CRUD类构造函数，新增数据库会话参数
    - 修复权限过滤器数据库会话使用问题
    - 更新模板生成器的CRUD代码模板
3.  **认证与安全改进**
    - 重构JWT密钥配置，移除默认密钥强制要求环境变量
    - 重命名密码工具类，统一密码加密校验逻辑
    - 优化OAuth认证流程，修复匿名认证使用问题
4.  **前端与静态资源**
    - 重构前端挂载逻辑，增加目录存在性校验
    - 使用标准StaticFiles替换自定义前端挂载实现
5.  **工具类与依赖更新**
    - 修复导入工具的表名重复检测逻辑
    - 优化限流回调代码，移除冗余依赖
    - 更新用户、租户等模块的响应模型字段
6.  **数据与配置修正**
    - 修复系统版本数据字段命名不统一问题
    - 简化枚举类校验逻辑，移除冗余注释
    - 修复测试用例中的密码工具类导入错误
 2026-07-11 13:03:28 +08:00
zhangtao 5ff72b086f refactor: 重构项目模块结构与代码细节优化 
1.  调整后端模块路由与插件文件结构，迁移部分模块代码至api/v1目录
2.  优化代码注释格式与文档字符串，简化冗余代码
3.  添加监控仪表盘、工单评论等新模块功能
4.  修复前端部分组件交互逻辑与类型定义
5.  清理冗余的初始化数据与废弃配置文件
6.  新增租户注册表单字段与国际化支持
7.  优化HTTP请求拦截器与快捷键功能
 2026-07-10 00:18:11 +08:00
zhangtao 349ab7b525 refactor: 大规模代码重构与项目配置优化 
- 调整前端路由前缀为 /web 并新增配置项
- 重构环境变量配置，替换旧环境文件为 dev/prod/test 版本
- 优化后端接口路由与参数校验，替换 dataclass 查询参数为 Pydantic 模型
- 整理后端导入顺序，延迟加载循环依赖模块
- 统一前端 API 调用命名，重构模块命名
- 新增多种响应类型支持，优化代码模板
- 简化后端路由装饰器写法，合并配置参数
 2026-07-04 01:23:43 +08:00
zhangtao 845f412e61 refactor(backend/main): adjust import format and add frontend registration 
调整了导入语句的格式化方式，新增register_frontend函数的导入并调用，完成前端相关路由注册
 2026-07-02 23:09:48 +08:00
zhangtao 64bd82ee75 refactor: 完成项目代码结构优化与权限清理 
主要变更：
1. 重构健康检查模块，迁移目录结构并合并重复代码
2. 清理路由标签冗余的"系统管理/平台管理"前缀，简化标签名称
3. 重构工作流相关目录与API，统一命名为flow和nodes
4. 重命名缓存删除接口为clear，同步前后端路由与权限
5. 简化接口参数描述，统一批量状态修改的请求体格式
6. 重构动态路由加载逻辑，优化初始化流程
7. 清理废弃的self_service模块，整合租户自助服务到租户API
8. 重构发票管理接口，统一路由前缀与权限控制
9. 优化代码生成模板，补全参数注解与描述
10: 修复日志删除接口的参数解析逻辑
 2026-07-02 00:10:02 +08:00
zhangtao fa5bfc2a4f style: 整理代码导入顺序并修复换行问题 
1. 移除未使用的io导入和多余空行
2. 调整多个文件的fastapi导入模块顺序
3. 统一fastapi_cache导入位置
4. 修复middlewares文件末尾缺失的换行
 2026-07-01 00:39:32 +08:00
zhangtao a86233d6c2 refactor: 完成项目整体架构升级与依赖优化 
此提交包含多项核心优化：
1.  依赖库升级：更新FastAPI、替换fastapi-limiter为slowapi，更换MySQL驱动为aiomysql，重构缓存系统使用fastapi-cache2-fork
2.  代码重构：移除自定义缓存工具，统一使用fastapi-cache2；重构请求限流逻辑，修复操作日志记录开关逻辑
3.  接口规范：统一将Depends分页/查询参数改为Query注解，补全File上传依赖注解
4.  前端优化：调整登录滑块进度条颜色、移除冗余demo页面样式类
5.  日志优化：重构日志配置，使用time.perf_counter替代time.time统计耗时
6.  测试优化：移除冗余的限流mock配置，改用官方限流方案
7.  模板优化：更新vue代码生成模板，移除冗余导入并优化组件使用
8.  导入功能优化：移除pandas依赖，使用Excel工具类重构文件导入逻辑
 2026-07-01 00:35:28 +08:00