[返回](./Runtime-README.md)

# /Convention/Runtime/Architecture

---

核心架构模块，提供依赖注入、事件系统和时间线管理功能

## 接口定义

系统定义了以下核心接口来规范架构设计：

### ISignal
信号接口，用于事件系统的消息传递

### IModel
模型接口，定义数据模型的序列化和反序列化能力：
- `Save()` 保存数据到字符串
- `Load(string data)` 从字符串加载数据

### IConvertable<T>
转换接口，提供类型转换能力：
- `ConvertTo()` 转换为目标类型

### IConvertModel<T>
组合接口，同时继承 `IModel` 和 `IConvertable<T>`

## 核心类型

### SingletonModel<T>
泛型单例模型，提供类型安全的单例管理：
- 支持依赖注入和实例替换
- 提供隐式转换操作符
- 集成模型序列化功能

### DependenceModel
依赖模型，管理多个条件的组合验证：
- 支持多个 `IConvertModel<bool>` 的依赖关系
- 提供枚举接口遍历所有依赖
- 所有依赖条件均满足时返回true

## 注册系统

### 对象注册
- `Register(Type slot, object target, Action completer, params Type[] dependences)`
- `Register<T>(T target, Action completer, params Type[] dependences)`

提供基于类型的依赖注入容器：
- 支持依赖关系管理
- 支持注册完成回调
- 自动解析依赖顺序

### 注册查询
- `Contains(Type type)` / `Contains<T>()`
- `Get(Type type)` / `Get<T>()`

## 事件系统

### 消息监听
- `AddListener<Signal>(Type slot, Action<Signal> listener)`
- `SendMessage(Type slot, ISignal signal)`
- `SendMessage<Signal>(Signal signal)`

提供类型安全的事件分发机制：
- 支持按类型注册监听器
- 支持泛型消息类型
- 自动管理监听器生命周期

### Listening类
监听器管理类，提供：
- `StopListening()` 停止监听

## 时间线系统

### 时间线管理
- `CreateTimeline()` 创建新的时间线
- `AddStep(int timelineId, Func<bool> predicate, params Action[] actions)` 添加步骤
- `UpdateTimeline()` 更新所有时间线
- `ResetTimelineContext(int timelineId)` 重置时间线上下文

提供基于条件的任务调度：
- 支持多条时间线并行执行
- 基于谓词的条件触发
- 支持动态添加执行步骤

## 类型格式化

### 类型序列化
- `FormatType(Type type)` 格式化类型为字符串
- `LoadFromFormat(string data)` 从字符串加载类型
- `LoadFromFormat(string data, out Exception exception)` 安全加载类型

使用格式：`Assembly::FullTypeName`

## 内部管理

### 系统重置
- `InternalReset()` 重置所有内部状态

清理以下组件：
- 注册历史
- 未完成的目标
- 完成器回调
- 依赖关系
- 子对象容器
- 事件监听器
- 时间线队列