# 扩展点速查 先使用标准能力，再选择真实扩展点。下表是源码导航，泛型与完整签名以链接源码为准。 | 要做什么 | 入口与参考 | 注意事项 | | --- | --- | --- | | 接入创建/编辑 | [CRUD 指南](../project-development/crud-query-guide.md)中的 Controller/Service/Manager 矩阵 | 不复制整套生命周期；converter 复用父接口 | | 扩展查询 | [JDBC](../guides/jdbc.md)、[JPA](../project-development/jpa-querydsl-code-guide.md)、[MyBatis-Flex](../project-development/mybatis-flex-code-guide.md)、[R2DBC](../project-development/r2dbc-code-guide.md) | 各栈表达式不同，租户/删除过滤需验证 | | 按业务键创建或刷新 | [分层指南](../project-development/custom-business-layering-guide.md)中的 CreateOrRefreshManager | 不是数据库原子 upsert，需考虑并发 | | 删除前保护/删除后清理/恢复 | [删除钩子表](../project-development/delete-hook-and-logging-guide.md) | `beforeLogicDelete`、`afterLogicDelete`、`beforePhysicsDelete`、`afterPhysicsDelete`、`afterRecovery` 职责不同 | | 共享跨模块契约 | [分层指南](../project-development/custom-business-layering-guide.md)共享扩展章节 | core 中定义、阻塞/响应式分包、明确实现方 | | 增加状态能力 | [状态指南](../guides/data-status.md) | 最终实体声明，所有接口与权限一致 | | 当前操作身份与目标租户 | [上下文指南](../guides/tenant-and-context.md) | 异步/响应式必须正确传播与清理 | | Service 缓存 | [缓存指南](../guides/cache.md) | 明确 key 维度、代理和失效时序 | | 生命周期事件 | [集成事件](../core/integration-event-guide.md) | 先确认已有发送点，避免重复发布 | | 统一日志/异常 | [日志与异常规范](../project-development/delete-hook-and-logging-guide.md) | 异常继续传播、敏感字段不记录 | 动态注册、请求参数和统一返回详见[CRUD 主路径](../project-development/crud-query-guide.md)。若 Core 没有合适扩展点，先明确需要解决的业务行为和边界，不通过虚构一个同名 API 继续生成代码。