从一个模块，
建立完整的开发方式。

01 · 准备环境与源码

当前文档对应 3.0.0-SNAPSHOT，基于 Spring Boot 3.x。Java 编译目标为 17；现有验证环境使用 JDK 25 与 Maven 3.9.15，这不等于已经完成 JDK 17 运行环境认证。

请使用团队提供的同版本源码与依赖仓库。公开源码仓库、Maven Central 坐标发布状态和正式发行下载入口尚未在本站配置。

ineed-core 的父工程为 com.ineedfull:ineed-parent:3.0.0-SNAPSHOT，父 POM 的 relativePath 为空。先确保父工程与基础依赖已经安装或可从仓库解析；只修改相邻源码目录不会自动影响实际依赖。当前没有 Maven Wrapper。

完整环境与依赖准备 →

02 · 选定运行时与数据栈

同步应用选择 WebMVC + JPA / JDBC / MyBatis-Flex，响应式应用选择 WebFlux + R2DBC。业务契约可以复用，应用装配需要保持引擎、数据访问与缓存运行时一致。

查看运行时矩阵 →

03 · 先运行一条框架业务链

在 java/ineed-core 根目录执行下列命令。前提是父工程与相关依赖已经可解析：

mvn -pl ineed-core-tests/ineed-core-test-webmvc -am \
  -Dtest=WebMvcJdbcBusinessChainTest,WebMvcJdbcSearchBusinessChainTest \
  -Dsurefire.failIfNoSpecifiedTests=false test

这组测试使用内存测试仓储，验证框架业务链路；不覆盖真实 HTTP、MySQL 或完整应用启动。真实环境验证应按下一阶段的运行指南执行。

查看其他可执行例子 →

04 · 沿真实模块完成第一次开发

教程以 ineed-config-category 为参考，依次讲解契约对象、实体、仓储、转换、Manager、Service 和 Controller。分类定义采用 GLOBAL_ONLY，新业务需要独立决定自己的数据归属。

开始第一个业务模块 →

05 · 进入应用级验证

准备隔离测试数据库，核对身份、授权与租户上下文，再验证应用装配、HTTP 接口和数据副作用。提交前同时检查生产代码与测试代码的格式规范。

运行、验证与排错 → · Java 代码格式 →