Commit Graph
10 Commits
Author SHA1 Message Date
DjangoAdmin DevandClaude 0cfaf8c894 refactor: P4b position 标杆模块服务层改造 + 单元测试
【服务层新范式】system/position 作为标杆:
- service 函数改「入参数据/出参数据」:get_position_page(params)->dict、
  add_position(data)/update_position(data)/update_position_status(data)->None、
  delete_positions(ids)->int
- 业务失败 raise BizError(不再 return R.failed),由全局处理器转 R.failed
- get_info 委托 PositionRepository(新增 repository.py,继承 BaseRepository)
- router 负责取参(query args / parse_request_body)与 R 包装

【单元测试】tests/unit/test_modules/test_position_service.py:
- 纯函数(_build_page_data)、BizError 契约(空数据/空ID/无效ID)、
  mock 批量删除(ID 解析验证)——无需数据库即可测试
- conftest flask_app fixture 增加 SECRET_KEY + 关闭 CSRF

【验收】12 passed(5 响应 + 7 position);应用启动;flake8 零告警;
position 路由 401 拦截正常。服务层测试化范式验证可行

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 14:42:03 +08:00
DjangoAdmin DevandClaude a6e094378c refactor: P4a 服务层改造地基(BizError + base_repository + base_service)
- src/core/exceptions.py:BizError/NotFoundError/PermissionDeniedError
- 全局异常处理器接入 BizError → R.failed(含事务回滚语义)
- src/common/base_repository.py:泛型 CRUD 仓储基类
- src/common/base_service.py:服务基类(入参数据/出参数据范式)

【验收】BizError 端到端转换为 R.failed(code=403/ok=false);应用启动

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 14:29:07 +08:00
DjangoAdmin DevandClaude d33dc1fc34 refactor: P3d 视图层迁入 src/modules/ → router.py(26 视图)——P3 全部完成
- 17 个单视图 + 4 组合并(login+index→auth、config+config_item→configuration、
  dict+dict_item→dictionary、login_log+operation_log→log)
- 重写:服务引用→src.modules(module 别名保留)、models/forms→src.modules
- 中间件引用保持 application.middleware(P5 迁移)
- application/views/__init__.py 蓝图注册加去重(合并模块 shim 重复导出)
- application/views/ 全部替换为 shim

【修复】index.py 组合导入 menu,user 被单名替换先命中残留 user,已修复

【验收】25 蓝图无重复注册;应用启动;pytest 5 passed;接口冒烟(登录校验、
鉴权 401)正常。P3 四层(models/forms/services/views)全部迁入 src/modules/

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 14:23:53 +08:00
DjangoAdmin DevandClaude 87aec4e26e refactor: P3c 服务层迁入 src/modules/ → service.py(29 服务)
- 22 个单服务 + 3 组合并(config+config_item、dict+dict_item、login_log+operation_log)
- 特殊命名:job_executor→executor、scheduler→scheduler_service、
  mail_svc→mail_service、sms_svc→sms_service(含使用处标识符改写)
- 重写引用:跨服务(module 别名/子模块)、models/forms→src.modules、
  db/extensions→src.core、utils→src.common|core、R→src.core.response
- application/services/ 全部替换为 shim

【验收】全部服务文件编译通过;应用启动;pytest 5 passed;核心服务导入正常

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 14:18:40 +08:00
DjangoAdmin DevandClaude 2586c0aace refactor: P3b 表单层迁入 src/modules/ → schema.py(23 表单)
- 20 个模块 schema.py(auth/system/association/cms 等)
- 合并 2 组:dict+dict_item、config+config_item
- 重写 import:base_form/fields→src.common.forms、模型引用→src.modules
- application/forms/ 全部替换为 shim

【教训】codemod 首次运行崩溃后重跑,读到了已替换的 shim 导致 9 个
schema.py 自引用损坏;已从 git(P3a 提交)恢复原版重跑修复

【验收】32 表单类;应用启动;pytest 5 passed

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 14:01:35 +08:00
DjangoAdmin DevandClaude 6de4f3bef2 refactor: P3a 模型层迁入 src/modules/(22 模型)
- 19 个模块目录(system/association/cms/dictionary/configuration/log 等)
- 一对一 16 个 + 合并 3 组(dict+dict_item、config+config_item、login_log+operation_log)
- 重写模型 import:base_db/base_model→src.common、db→src.core.database、
  case_converter/rich_text/request→src.common.utils
- application/models/ 全部替换为 shim(指向 src.modules)
- src/models_registry.py 改为从 src.modules 全量导入

【修复】codemod 两处 bug:shim 与 registry 的 import 路径含斜杠(已改点分);
strip_license 误剥无许可头文件的 docstring 开头(log/models.py 已补回)

【验收】22 表全量识别;应用启动;pytest 5 passed

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 13:48:30 +08:00
DjangoAdmin DevandClaude 658ee6d596 refactor: P2 core+common 建设(应用工厂/扩展/工具层迁入 src/)
【结构】
- src/core/:database/response/jwt/password/security/redis_client/mail/scheduler
- src/common/:base_model/base_db/forms(base_form+fields)/constants/utils
- src/models_registry.py:模型聚合器(Flask-Migrate 全量表识别)

【绞杀者 shim】extensions/、utils/、application/constants|forms|models 打兼容转发
【兼容修复】应用工厂抽取至 application/factory.py(P2 前置,P1 已完成)

【基线修复】application/models(25) + middleware(7) 原被嵌套 .gitignore(*)
误排除出版本库,已补入(base_model/base_db 现为 shim,原版在 src/common/)

【登记既有缺陷】
1. flask db CLI 因 .env FLASK_VERSION 与 --version 冲突报错 → Makefile 已加 FLASK_SKIP_DOTENV=1
2. 本机 Redis 未设密码但 REDIS_AUTH=True,/captcha 报 AUTH 错误(环境问题)

【验收】22 模型表全量识别;src/ flake8 零告警;pytest 5 passed;应用启动;
/login 表单校验、/user/page 鉴权拦截冒烟正常

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 13:20:46 +08:00
DjangoAdmin DevandClaude 92130ef070 chore: P1 验证通过 + 应用工厂抽取(修复循环导入)
- application/factory.py:应用工厂独立成模块,application 包保持轻量
  (修复 utils→application.constants 触发全量导入的循环依赖,P2 前置改造)
- app.py 改为 from application.factory import create_app
- tests/conftest.py:新增 flask_app 上下文 fixture
- test_response.py:R.ok/failed 在应用上下文中测试
- .flake8:修复 extend-ignore 行内注释导致 flake8 解析失败

验证:
- pytest 5 passed
- 应用完整构建 OK(MySQL/Redis 就绪)
- flake8 存量基线 154 条(F401×111 / E402×36 / 其余 7)已登记

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 12:22:56 +08:00
DjangoAdmin DevandClaude 8691412ec6 chore: P1 工程化工具链
- pyproject.toml:pytest/black/isort/mypy 统一配置
- requirements-dev.txt:测试与代码规范开发依赖
- .flake8 / .editorconfig:PEP8 与编辑器统一
- .pre-commit-config.yaml:提交前钩子
- Makefile:常用命令集
- .env.example:环境变量模板(76 键)
- tests/:pytest 骨架 + R 响应格式冒烟测试

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 12:14:51 +08:00
DjangoAdmin DevandClaude 15f2a5e097 chore: 基线提交(重构前代码快照)
- git 初始化 + .gitignore 补全(根 .env / logs / instance / __pycache__ 等)
- 修复 utils/.gitignore 误将整个 utils/ 源码层忽略的问题,补入全部工具源码(含 ip2region.xdb)
- 含后端全部代码:application / extensions / utils / config / migrations
- 含前端 ui/(后续整体迁走)
- 不含根 .env(含密钥,本地保留)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-07 12:12:06 +08:00