# 基于 Ineed-Core 的项目开发文档

面向所有基于 `ineed-core` 开发业务项目的开发者、代码生成器和自动化工具。

## 选择你的路径

- 第一次接入：读[环境准备](../getting-started/prerequisites.md)、[架构](../concepts/architecture.md)和[首个模块教程](../getting-started/first-module.md)，再按任务查本目录专题。
- AI 编码：读[短契约](../ai/README.md)及[任务路由](../ai/task-routing.md)，按影响范围加载规则。
- 查强制约束：从[规则索引](../standards/README.md)定位唯一正文。
- 查租户、事务、缓存、事件、JDBC：从[总索引](../README.md)进入新增指南。

## 按任务进入

| 任务 | 推荐文档 |
|------|------|
| 创建新业务模块骨架 | [business-module-layout-guide.md](business-module-layout-guide.md) |
| 设计分层（Controller/Service/Manager/Repository） | [custom-business-layering-guide.md](custom-business-layering-guide.md) |
| 接入 CRUD / Query 主路径 | [crud-query-guide.md](crud-query-guide.md) |
| 编写 JPA QueryDSL manager 查询 | [jpa-querydsl-code-guide.md](jpa-querydsl-code-guide.md) |
| 编写 MyBatis-Flex mapper / manager 查询 | [mybatis-flex-code-guide.md](mybatis-flex-code-guide.md) |
| 编写 R2DBC repository / manager 查询 | [r2dbc-code-guide.md](r2dbc-code-guide.md) |
| 处理删除钩子、级联清理、日志与异常追踪 | [delete-hook-and-logging-guide.md](delete-hook-and-logging-guide.md) |
| 编写模块级业务集成测试 | [business-integration-test-guide.md](business-integration-test-guide.md) |
| 统一代码格式、Javadoc、字段声明、formatter 保护 | [code-style-guide.md](code-style-guide.md) |
| 识别禁止写法 | [convention-anti-patterns.md](convention-anti-patterns.md) |
| 编写需求输入 | [module-requirements-template.md](module-requirements-template.md) |
| 使用代码生成器辅助生成 | [development-contract.md](development-contract.md) |
| 前端联调和接口消费 | [frontend-integration-guide.md](frontend-integration-guide.md) |
| 在开发模式登录并诊断身份、权限 | [development-login-guide.md](development-login-guide.md) |
| 生成 Constant / ErrorCode / i18n 样板 | [module-constant-i18n-template.md](module-constant-i18n-template.md) |

## 核心原则

- 业务模块默认走 `Controller -> Service -> Manager -> Repository/EntityManager`
- 标准 CRUD、查询、数据状态、删除优先复用 `ineed-core` 接口和默认实现
- `Service` 是事务和业务编排边界，不与其他 `Service` 横向互调
- `Manager` 承载单类实体规则，不成为跨表总控层
- 同步和响应式模块必须保持业务语义对齐

## 关联框架文档

- [../core/module-inventory.md](../core/module-inventory.md) — 真实模块清单
- [../core/module-capability-map.md](../core/module-capability-map.md) — 框架能力地图
- [../core/current-implementation-status.md](../core/current-implementation-status.md) — 当前能力验证范围和缺口
- [../core/constant-errorcode-i18n-guide.md](../core/constant-errorcode-i18n-guide.md) — 常量、错误码、i18n 规则

> 最后更新：2026-07-30