准备环境并验证 Ineed Core

Core 不是一个可直接启动的应用

Ineed Core 是 Maven 库聚合工程。它提供契约、公共能力和基础实现，由业务模块与 bootstrap 启动工程组装成可运行的应用。不要对 Core 根目录寻找通用的 java -jar 启动方式。

目前公开仓库与制品发布尚未确认，以下步骤适用于已经取得同版本本地工程的开发者。发行状态见下载页。

准备工具与工程

Core 当前开发文档使用 JDK 25、Maven 3.9.15 作为验证环境；编译目标为 Java 17。编译目标不等于已经完成所有 JDK 17 运行环境的兼容验证。仓库未提供 Maven Wrapper。

java -version
mvn -version

确保 Maven 显示的 Java 版本与你预期一致。最小目录关系如下：

java/
├── ineed-parent/
└── ineed-core/

真实业务模块还需要同版本的配置、设计与启动工程。先完成框架链路验证，再准备完整业务应用环境。

安装父 POM

在 ineed-core 根目录打开终端：

INEED_CORE_ROOT="$PWD"
INEED_JAVA_ROOT="$(cd .. && pwd)"
export INEED_CORE_ROOT INEED_JAVA_ROOT

mvn -f "$INEED_JAVA_ROOT/ineed-parent/pom.xml" -N install

Core 的父 POM 使用空 relativePath，需要先在 Maven 仓库可解析。Maven 的 -am 只能补充当前 reactor 内的依赖，不会自动编译所有兄弟仓库。

跑通最小业务链路

仍在 Core 根目录执行：

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

这组测试用于观察 Controller → Service → Manager → Repository 的业务调用。它采用内存 TestRepository，不需要为了这一步创建 MySQL 数据库；也不等于已经完成真实 HTTP 或 SQL 集成验证。

验收时检查测试报告确实执行了指定测试且无失败，不能只看命令退出码。

扩大到两条框架测试路线

mvn -f "$INEED_CORE_ROOT/pom.xml" \
  -pl ineed-core-tests/ineed-core-test-webmvc,ineed-core-tests/ineed-core-test-webflux \
  -am test

如果依赖解析失败，先核对父工程是否安装、各工程版本是否一致、当前目录是否正确。不要通过临时删除依赖来让编译表面通过。

接下来做什么

先阅读运行时组合，确定 WebMVC 或 WebFlux 路线，再按业务模块开发约定实施。

真实启动工程需要单独准备隔离的 MySQL、Quartz 数据库和 Redis 等依赖，以及该工程的环境配置和身份上下文。最小链路通过后，仍要对真实持久化和接口行为进行验证。