扩展点速查
按扩展目标定位 Controller、Service、Manager 与仓储入口。
浏览全部手册
本页目录
文档来源与 Markdown 原文
权威正文：ineed-core/docs/reference/extension-points.md。网站按工作区快照同步，原文中的历史日期和验证范围保留。
开始编码前核对同版本源码；跨仓文件引用可在源码定位目录查找。
下载 Markdown 原文 ↓先使用标准能力，再选择真实扩展点。下表是源码导航，泛型与完整签名以链接源码为准。
| 要做什么 | 入口与参考 | 注意事项 |
|---|---|---|
| 接入创建/编辑 | CRUD 指南中的 Controller/Service/Manager 矩阵 | 不复制整套生命周期；converter 复用父接口 |
| 扩展查询 | JDBC、JPA、MyBatis-Flex、R2DBC | 各栈表达式不同，租户/删除过滤需验证 |
| 按业务键创建或刷新 | 分层指南中的 CreateOrRefreshManager | 不是数据库原子 upsert，需考虑并发 |
| 删除前保护/删除后清理/恢复 | 删除钩子表 | beforeLogicDelete、afterLogicDelete、beforePhysicsDelete、afterPhysicsDelete、afterRecovery 职责不同 |
| 共享跨模块契约 | 分层指南共享扩展章节 | core 中定义、阻塞/响应式分包、明确实现方 |
| 增加状态能力 | 状态指南 | 最终实体声明，所有接口与权限一致 |
| 当前操作身份与目标租户 | 上下文指南 | 异步/响应式必须正确传播与清理 |
| Service 缓存 | 缓存指南 | 明确 key 维度、代理和失效时序 |
| 生命周期事件 | 集成事件 | 先确认已有发送点，避免重复发布 |
| 统一日志/异常 | 日志与异常规范 | 异常继续传播、敏感字段不记录 |
动态注册、请求参数和统一返回详见CRUD 主路径。若 Core 没有合适扩展点，先明确需要解决的业务行为和边界，不通过虚构一个同名 API 继续生成代码。
仍有疑问？按反馈清单整理复现信息 →