CAPABILITIES WITH CONTRACTS

能力可组合,
边界有约定。

从持久化到业务编排,从代码格式到交付验证,给应用一个可持续扩展的基础。

01

明确的分层架构

Controller 负责 API,Service 编排用例与事务,Manager 实现实体规则,Repository / Mapper 处理持久化。跨实体协作通过 Manager 组合。

02

按契约组合业务能力

使用能力接口与默认方法组织增删改查、检索、树和排序。定制生命周期钩子时,明确执行顺序与副作用。

03

租户和权限,分别守好边界

用 TENANT_ONLY、GLOBAL_ONLY、GLOBAL_WITH_TENANT、TENANT_SELF 明确数据归属。数据可见不代表可写,也不替代 API 授权;自定义 SQL 与联表查询需要单独核对。

04

让事务与副作用有正确时序

区分生命周期完成与事务提交。缓存失效应与提交协作,响应式上下文保持在订阅链中,业务链避免自行 block / subscribe。

05

状态、元数据与应用协作

复用启停、发布等数据状态能力,结合客户端与元数据契约接入应用。数据状态不等于完整审批流或版本管理;JVM 内事件不保证跨进程送达。

06

把工程规范带进日常开发

模块布局、Java 与测试代码格式、错误码、API 契约和验证要求都有文档入口。开发人员与 AI 按同一套规则交付。

RUNTIME MATRIX

选择适合业务的实现路径。

同步 · SQL 表达式

WebMVC + JDBC

用 JDBC 仓储与 QueryDSL SQL 组织持久化;首个模块教程沿这条路径解释真实业务分层。

阅读对应数据栈指南 →
  1. WEBineed-core-webmvc
  2. ENGINEineed-core-engine
  3. DATAineed-core-data-jdbc

同步 · 实体映射

WebMVC + JPA

使用 JPA 实体、仓储与 QueryDSL 条件表达式,保持业务契约和生命周期约定。

阅读对应数据栈指南 →
  1. WEBineed-core-webmvc
  2. ENGINEineed-core-engine
  3. DATAineed-core-data-jpa

同步 · Mapper

WebMVC + MyBatis-Flex

通过 MyBatis-Flex Mapper 实现持久化,按同一业务规则组织 Manager 与查询能力。

阅读对应数据栈指南 →
  1. WEBineed-core-webmvc
  2. ENGINEineed-core-engine
  3. DATAineed-core-data-mybatis-flex

响应式 · 订阅链

WebFlux + R2DBC

组合响应式业务引擎与 R2DBC,把上下文、事务和错误处理保留在同一订阅链中。

阅读对应数据栈指南 →
  1. WEBineed-core-webflux
  2. ENGINEineed-core-engine-reactive
  3. DATAineed-core-data-r2dbc

每个应用选择一致的运行时;四栈对齐通过独立装配验证。上方列出主要框架模块,不是完整应用依赖清单。查看实现与验证边界 ↗

四条路径指 JPA、JDBC、MyBatis-Flex 与 R2DBC 的关系数据栈。MongoDB、Elasticsearch、动态数据源等模块不自动具有相同的集成与验证范围。

查看当前实现状态与限制 →