<!-- generated-by: gsd-doc-writer -->
# Ineed-Core 文档

两条使用路径共用一套规范。适用 Core `3.0.0-SNAPSHOT`，系统核验日期 2026-09-19；行为与环境范围见[核验记录](maintenance/verification-2026-09-19.md)。

- **AI 编码**：[短契约](ai/README.md) → [任务路由](ai/task-routing.md) → [规则索引](standards/README.md) → 对应示例与验证。
- **开发人员**：[环境准备](getting-started/prerequisites.md) → [架构](concepts/architecture.md) → [第一个模块](getting-started/first-module.md) → [运行与排错](getting-started/run-and-verify.md)。
- **维护框架**：[能力矩阵](concepts/runtime-matrix.md) → [模块清单](core/module-inventory.md) → [文档维护](maintenance/documentation-policy.md)。

应用错误码与数据库设计归工作区 `design/standards`，业务需求归所属域，Core 维护框架规则。不要把历史计划作为常规编码必读，也不要复制第二份规范正文。

## 按问题查找

| 我需要解决的问题 | 入口 |
| --- | --- |
| 新模块如何命名、拆分、放目录 | [业务骨架](project-development/business-module-layout-guide.md) |
| 一次业务各层怎么写 | [分层](project-development/custom-business-layering-guide.md)、[对象模型](concepts/object-model.md) |
| 查询或字段如何扩展 | [CRUD](project-development/crud-query-guide.md)、[JDBC](guides/jdbc.md)及其他 ORM 专题 |
| 为什么能读却不能修改 | [租户与上下文](guides/tenant-and-context.md)、[权限](guides/authorization-integration.md) |
| 多表写入、缓存和事件何时生效 | [事务](guides/transaction-and-concurrency.md)、[缓存](guides/cache.md)、[事件](guides/integration-events.md) |
| 删除、恢复和状态如何接入 | [删除](project-development/delete-hook-and-logging-guide.md)、[状态](guides/data-status.md) |
| 什么才算验证通过 | [测试与证据](standards/testing.md) |

## 全部文档

以下索引覆盖当前 `docs/` 页面，检查器会提示遗漏。

### AI 执行路径

| 文档 | 路径 |
| --- | --- |
| AI 编码入口 | [ai/README.md](ai/README.md) |
| 交付检查 | [ai/delivery-checklist.md](ai/delivery-checklist.md) |
| 编码任务输入模板 | [ai/task-input-template.md](ai/task-input-template.md) |
| 按任务读取与验证 | [ai/task-routing.md](ai/task-routing.md) |

### 开发人员入门

| 文档 | 路径 |
| --- | --- |
| 第一个业务模块：从分类定义走通 Core | [getting-started/first-module.md](getting-started/first-module.md) |
| 环境与依赖准备 | [getting-started/prerequisites.md](getting-started/prerequisites.md) |
| 应用运行、验证与排错 | [getting-started/run-and-verify.md](getting-started/run-and-verify.md) |

### 设计与能力边界

| 文档 | 路径 |
| --- | --- |
| 架构与开发边界 | [concepts/architecture.md](concepts/architecture.md) |
| 业务对象与能力组合 | [concepts/object-model.md](concepts/object-model.md) |
| 请求、事务与生命周期 | [concepts/request-lifecycle.md](concepts/request-lifecycle.md) |
| 运行时与能力验证矩阵 | [concepts/runtime-matrix.md](concepts/runtime-matrix.md) |

### 规范入口

| 文档 | 路径 |
| --- | --- |
| 规范与权威来源 | [standards/README.md](standards/README.md) |
| 契约、错误与国际化 | [standards/contract-and-error.md](standards/contract-and-error.md) |
| 测试与交付证据 | [standards/testing.md](standards/testing.md) |

### 任务专题

| 文档 | 路径 |
| --- | --- |
| 身份与权限接入 | [guides/authorization-integration.md](guides/authorization-integration.md) |
| 服务缓存接入 | [guides/cache.md](guides/cache.md) |
| HTTP Client、Socket 与数据库元数据 | [guides/clients-and-metadata.md](guides/clients-and-metadata.md) |
| 数据状态能力与业务状态 | [guides/data-status.md](guides/data-status.md) |
| 业务事件接入路线 | [guides/integration-events.md](guides/integration-events.md) |
| JDBC 业务代码指南 | [guides/jdbc.md](guides/jdbc.md) |
| 租户、操作身份与上下文 | [guides/tenant-and-context.md](guides/tenant-and-context.md) |
| 事务、并发与副作用 | [guides/transaction-and-concurrency.md](guides/transaction-and-concurrency.md) |

### 配置与扩展点

| 文档 | 路径 |
| --- | --- |
| 配置参考 | [reference/configuration.md](reference/configuration.md) |
| 扩展点速查 | [reference/extension-points.md](reference/extension-points.md) |

### 可执行例子

| 文档 | 路径 |
| --- | --- |
| 可执行例子索引 | [examples/README.md](examples/README.md) |

### 既有框架参考（权威正文保留）

| 文档 | 路径 |
| --- | --- |
| Ineed-Core 内部文档 | [core/README.md](core/README.md) |
| API 兼容性治理策略 | [core/api-compatibility-policy.md](core/api-compatibility-policy.md) |
| API 文档使用指南 | [core/api-documentation-guide.md](core/api-documentation-guide.md) |
| Constant、ErrorCode 与 I18n 约定 | [core/constant-errorcode-i18n-guide.md](core/constant-errorcode-i18n-guide.md) |
| Ineed-Core 当前实现状态 | [core/current-implementation-status.md](core/current-implementation-status.md) |
| Ineed-Core 集成事件接入指南 | [core/integration-event-guide.md](core/integration-event-guide.md) |
| Java 模块目录结构指南 | [core/java-module-directory-guide.md](core/java-module-directory-guide.md) |
| Ineed-Core 模块能力地图 | [core/module-capability-map.md](core/module-capability-map.md) |
| Ineed-Core 真实模块清单 | [core/module-inventory.md](core/module-inventory.md) |

### 既有开发专题（权威正文保留）

| 文档 | 路径 |
| --- | --- |
| 基于 Ineed-Core 的项目开发文档 | [project-development/README.md](project-development/README.md) |
| 业务集成测试编写指南 | [project-development/business-integration-test-guide.md](project-development/business-integration-test-guide.md) |
| 业务模块骨架与目录结构约定 | [project-development/business-module-layout-guide.md](project-development/business-module-layout-guide.md) |
| 代码格式与源码风格指南 | [project-development/code-style-guide.md](project-development/code-style-guide.md) |
| 开发约定反模式清单 | [project-development/convention-anti-patterns.md](project-development/convention-anti-patterns.md) |
| CRUD / Query 开发主路径 | [project-development/crud-query-guide.md](project-development/crud-query-guide.md) |
| 自定义业务与分层扩展指南 | [project-development/custom-business-layering-guide.md](project-development/custom-business-layering-guide.md) |
| 删除钩子、分层日志与异常追踪规范 | [project-development/delete-hook-and-logging-guide.md](project-development/delete-hook-and-logging-guide.md) |
| 项目开发契约 | [project-development/development-contract.md](project-development/development-contract.md) |
| 开发模式登录与权限诊断 | [project-development/development-login-guide.md](project-development/development-login-guide.md) |
| 前端接入与联调指南 | [project-development/frontend-integration-guide.md](project-development/frontend-integration-guide.md) |
| JPA QueryDSL 代码编写指南 | [project-development/jpa-querydsl-code-guide.md](project-development/jpa-querydsl-code-guide.md) |
| 模块 Constant 与 I18n 样板 | [project-development/module-constant-i18n-template.md](project-development/module-constant-i18n-template.md) |
| 业务需求文档模板 | [project-development/module-requirements-template.md](project-development/module-requirements-template.md) |
| MyBatis-Flex 代码编写指南 | [project-development/mybatis-flex-code-guide.md](project-development/mybatis-flex-code-guide.md) |
| R2DBC 代码编写指南 | [project-development/r2dbc-code-guide.md](project-development/r2dbc-code-guide.md) |

### 维护与核验

| 文档 | 路径 |
| --- | --- |
| 文档维护与验证约定 | [maintenance/documentation-policy.md](maintenance/documentation-policy.md) |
| 文档入口迁移说明 | [maintenance/migration-notes.md](maintenance/migration-notes.md) |
| 文档核验记录：2026-09-19 | [maintenance/verification-2026-09-19.md](maintenance/verification-2026-09-19.md) |