基于 Ineed-Core 的项目开发文档
从业务开发视角查找骨架、CRUD、格式、分层及数据栈指南。
浏览全部手册
本页目录
文档来源与 Markdown 原文
权威正文：ineed-core/docs/project-development/README.md。网站按工作区快照同步，原文中的历史日期和验证范围保留。
开始编码前核对同版本源码；跨仓文件引用可在源码定位目录查找。
下载 Markdown 原文 ↓面向所有基于 ineed-core 开发业务项目的开发者、代码生成器和自动化工具。
选择你的路径
- 第一次接入：读环境准备、架构和首个模块教程，再按任务查本目录专题。
- AI 编码：读短契约及任务路由，按影响范围加载规则。
- 查强制约束：从规则索引定位唯一正文。
- 查租户、事务、缓存、事件、JDBC：从总索引进入新增指南。
按任务进入
| 任务 | 推荐文档 |
|---|---|
| 创建新业务模块骨架 | business-module-layout-guide.md |
| 设计分层（Controller/Service/Manager/Repository） | custom-business-layering-guide.md |
| 接入 CRUD / Query 主路径 | crud-query-guide.md |
| 编写 JPA QueryDSL manager 查询 | jpa-querydsl-code-guide.md |
| 编写 MyBatis-Flex mapper / manager 查询 | mybatis-flex-code-guide.md |
| 编写 R2DBC repository / manager 查询 | r2dbc-code-guide.md |
| 处理删除钩子、级联清理、日志与异常追踪 | delete-hook-and-logging-guide.md |
| 编写模块级业务集成测试 | business-integration-test-guide.md |
| 统一代码格式、Javadoc、字段声明、formatter 保护 | code-style-guide.md |
| 识别禁止写法 | convention-anti-patterns.md |
| 编写需求输入 | module-requirements-template.md |
| 使用代码生成器辅助生成 | development-contract.md |
| 前端联调和接口消费 | frontend-integration-guide.md |
| 在开发模式登录并诊断身份、权限 | development-login-guide.md |
| 生成 Constant / ErrorCode / i18n 样板 | module-constant-i18n-template.md |
核心原则
- 业务模块默认走
Controller -> Service -> Manager -> Repository/EntityManager - 标准 CRUD、查询、数据状态、删除优先复用
ineed-core接口和默认实现 Service是事务和业务编排边界，不与其他Service横向互调Manager承载单类实体规则，不成为跨表总控层- 同步和响应式模块必须保持业务语义对齐
关联框架文档
- ../core/module-inventory.md — 真实模块清单
- ../core/module-capability-map.md — 框架能力地图
- ../core/current-implementation-status.md — 当前能力验证范围和缺口
- ../core/constant-errorcode-i18n-guide.md — 常量、错误码、i18n 规则
最后更新：2026-07-30
仍有疑问？按反馈清单整理复现信息 →