# mvt-rule

**Repository Path**: NullPE/group/mvt/mvt-rule

## Basic Information

- **Project Name**: mvt-rule
- **Description**: 宇宙规则项目，定位为跨星系、跨行星都必须遵守的“宪法层”，定义通用契约（Contract）。
> 契约与约束的唯一合法来源
- **Primary Language**: Kotlin
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> “逻辑可以平庸，但布局必须优美。”
>

# MVT-Rule: The Universal Law Engine

**“在代码的热寂之前，建立绝对的秩序。”**
MVT-Rule 是 MVT 生态系统的核心秩序维度。
它不处理具体的、易变的业务需求，而是定义了软件宇宙运行的物理常数、对称法则与能量交换协议。

## 宇宙八大维度

在 MVT-Rule 中，所有的逻辑根据其在场动力学中的地位，被严格划分在八个维度内。每一个维度都是自洽的，且遵循高维调用低维的单向重力准则。

## 核心设计准则

### 容器主权隔离

MVT-Rule 拒绝接入任何 starter 级别的 IoC 框架（如 Spring Boot, Quarkus）。

- 手动装配：所有的依赖注入必须在 Singularities 层级显式完成。
- 零注解污染：核心逻辑层禁止出现 @Service, @Inject 等侵入式注解。

### 工具集准入制度

允许接入 Apache Commons, Vavr, Jackson 等原子级工具集（Tools），但严禁接入带有自动配置与生命周期接管功能的框架（Hosts）。

### 介质隔离规范

通过后缀强制区分逻辑与物理介质：

- _COL: 地核沉积（Database Columns）。
- _HDR: 波动频率（HTTP Headers）。
- _VAL: 交换格式（Protocol Values）。

> 软件架构不是积木的堆叠，而是定律的推演。在 MVT-Rule 中，我们不写代码，我们维护熵值。如果一个逻辑无法在八大维度中找到它的定位，那它就不配存在于这个宇宙。

## 接入指南

外部星系（如 mvt-galaxy-starter）若想获取 Rule 的智慧，必须遵循以下契约：

- 调用奇点：通过 Singularities:factory 手动索取装配好的实例。
- 挂载容器：将获取的 POJO 实例自行注册到宿主框架（Spring/Quarkus）的上下文中。
- 遵循坐标：所有的日志与异常必须携带 Manifolds:atlas 提供的逻辑坐标。