Skip to content

2026-10-31 应用户要求整理了两份开发指南(工作区根目录,与能力评估/成本清单并列):

  • d:/VOL源码/开发指南-后端.md:分层边界、ServiceBase 钩子体系(Add/Audit 委托三件套)、查询合计、事务与库存纪律、自定义接口 DTO 规范(415/JsonPropertyName)、依赖注册顺序、导入导出上传、双工作流选型、上线检查清单。
  • d:/VOL源码/开发指南-前端.md:生成物/手写区边界与定制三分法、ViewGrid 钩子顺序、页面 patch 骨架、colSize 重排、editFormFields 声明坑、选单 selectTable 范式、自定义弹窗组件规范(parentCall/勾选池)、按钮权限排查链、10 条高频踩坑表。

How to apply: 用户问"某个功能怎么写/为什么按钮不出/接口报错"时,先查对应指南章节再翻源码;指南内容与 reference_voldocs.md(文档路径索引)和 project_erp_goal.md(设计决策、踩坑细节)互补。

2026-11-02 新增 d:/VOL源码/后端源码分析.md:源码级架构解析(启动流程、请求生命周期、BaseProvider/钩子体系、双 ORM 真相=查询实际跑 SqlSugar、JWT 无感置换、进程缓存三件套版本号机制、WorkFlow vs FormWorkFlow 区别、生成器契约、安全注意 6 条)。Why: 与开发指南互补——指南管"怎么写",分析管"怎么实现的"。How to apply: 问"框架内部机制/为什么这样/安全部署"类问题先查它;行号引用基于 3.5.8,升级后需复核。

2026-11-02 再增 d:/VOL源码/VOL框架表结构说明.md:框架级 35+ 张系统表的字段含义(用户/角色/菜单权限/字典/生成器 Sys_TableInfo+Sys_TableColumn 46 字段/两套工作流全家/Quartz/日志/通知/基础配置),含建库最小集 checklist 与种子数据提示。Why: 用户做 VOL 独立建库(对比 MyBack 的方案 A)需要核对表结构;VOL 源码无建库 .sql,此文档即核对底册。How to apply: 问"某系统表字段什么意思/建库要哪些表/权限存哪"先查它;字段含义取自实体 Display 特性源码实证。