Ineed-Core 文档
Core 文档的完整导航与不同读者的阅读路线。
浏览全部手册
本页目录
文档来源与 Markdown 原文
权威正文：ineed-core/docs/README.md。网站按工作区快照同步，原文中的历史日期和验证范围保留。
开始编码前核对同版本源码；跨仓文件引用可在源码定位目录查找。
下载 Markdown 原文 ↓两条使用路径共用一套规范。适用 Core 3.0.0-SNAPSHOT，系统核验日期 2026-09-19；行为与环境范围见核验记录。
应用错误码与数据库设计归工作区 design/standards，业务需求归所属域，Core 维护框架规则。不要把历史计划作为常规编码必读，也不要复制第二份规范正文。
按问题查找
| 我需要解决的问题 | 入口 |
|---|---|
| 新模块如何命名、拆分、放目录 | 业务骨架 |
| 一次业务各层怎么写 | 分层、对象模型 |
| 查询或字段如何扩展 | CRUD、JDBC及其他 ORM 专题 |
| 为什么能读却不能修改 | 租户与上下文、权限 |
| 多表写入、缓存和事件何时生效 | 事务、缓存、事件 |
| 删除、恢复和状态如何接入 | 删除、状态 |
| 什么才算验证通过 | 测试与证据 |
全部文档
以下索引覆盖当前 docs/ 页面，检查器会提示遗漏。
AI 执行路径
| 文档 | 路径 |
|---|---|
| AI 编码入口 | ai/README.md |
| 交付检查 | ai/delivery-checklist.md |
| 编码任务输入模板 | ai/task-input-template.md |
| 按任务读取与验证 | ai/task-routing.md |
开发人员入门
| 文档 | 路径 |
|---|---|
| 第一个业务模块：从分类定义走通 Core | getting-started/first-module.md |
| 环境与依赖准备 | getting-started/prerequisites.md |
| 应用运行、验证与排错 | getting-started/run-and-verify.md |
设计与能力边界
| 文档 | 路径 |
|---|---|
| 架构与开发边界 | concepts/architecture.md |
| 业务对象与能力组合 | concepts/object-model.md |
| 请求、事务与生命周期 | concepts/request-lifecycle.md |
| 运行时与能力验证矩阵 | concepts/runtime-matrix.md |
规范入口
| 文档 | 路径 |
|---|---|
| 规范与权威来源 | standards/README.md |
| 契约、错误与国际化 | standards/contract-and-error.md |
| 测试与交付证据 | standards/testing.md |
任务专题
| 文档 | 路径 |
|---|---|
| 身份与权限接入 | guides/authorization-integration.md |
| 服务缓存接入 | guides/cache.md |
| HTTP Client、Socket 与数据库元数据 | guides/clients-and-metadata.md |
| 数据状态能力与业务状态 | guides/data-status.md |
| 业务事件接入路线 | guides/integration-events.md |
| JDBC 业务代码指南 | guides/jdbc.md |
| 租户、操作身份与上下文 | guides/tenant-and-context.md |
| 事务、并发与副作用 | guides/transaction-and-concurrency.md |
配置与扩展点
| 文档 | 路径 |
|---|---|
| 配置参考 | reference/configuration.md |
| 扩展点速查 | reference/extension-points.md |
可执行例子
| 文档 | 路径 |
|---|---|
| 可执行例子索引 | examples/README.md |
既有框架参考（权威正文保留）
| 文档 | 路径 |
|---|---|
| Ineed-Core 内部文档 | core/README.md |
| API 兼容性治理策略 | core/api-compatibility-policy.md |
| API 文档使用指南 | core/api-documentation-guide.md |
| Constant、ErrorCode 与 I18n 约定 | core/constant-errorcode-i18n-guide.md |
| Ineed-Core 当前实现状态 | core/current-implementation-status.md |
| Ineed-Core 集成事件接入指南 | core/integration-event-guide.md |
| Java 模块目录结构指南 | core/java-module-directory-guide.md |
| Ineed-Core 模块能力地图 | core/module-capability-map.md |
| Ineed-Core 真实模块清单 | core/module-inventory.md |
既有开发专题（权威正文保留）
| 文档 | 路径 |
|---|---|
| 基于 Ineed-Core 的项目开发文档 | project-development/README.md |
| 业务集成测试编写指南 | project-development/business-integration-test-guide.md |
| 业务模块骨架与目录结构约定 | project-development/business-module-layout-guide.md |
| 代码格式与源码风格指南 | project-development/code-style-guide.md |
| 开发约定反模式清单 | project-development/convention-anti-patterns.md |
| CRUD / Query 开发主路径 | project-development/crud-query-guide.md |
| 自定义业务与分层扩展指南 | project-development/custom-business-layering-guide.md |
| 删除钩子、分层日志与异常追踪规范 | project-development/delete-hook-and-logging-guide.md |
| 项目开发契约 | project-development/development-contract.md |
| 开发模式登录与权限诊断 | project-development/development-login-guide.md |
| 前端接入与联调指南 | project-development/frontend-integration-guide.md |
| JPA QueryDSL 代码编写指南 | project-development/jpa-querydsl-code-guide.md |
| 模块 Constant 与 I18n 样板 | project-development/module-constant-i18n-template.md |
| 业务需求文档模板 | project-development/module-requirements-template.md |
| MyBatis-Flex 代码编写指南 | project-development/mybatis-flex-code-guide.md |
| R2DBC 代码编写指南 | project-development/r2dbc-code-guide.md |
维护与核验
| 文档 | 路径 |
|---|---|
| 文档维护与验证约定 | maintenance/documentation-policy.md |
| 文档入口迁移说明 | maintenance/migration-notes.md |
| 文档核验记录：2026-09-19 | maintenance/verification-2026-09-19.md |
仍有疑问？按反馈清单整理复现信息 →