# cube-front

**Repository Path**: haoj1eliang/cube-front

## Basic Information

- **Project Name**: cube-front
- **Description**: cube_platform项目的新版前端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-28
- **Last Updated**: 2026-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cube-front —— 按正确设计思想重构的前端（对比项目：cube-frontend-op）

> **定位**：以 cube-frontend-op 为对照，按五层联调 + 本体论 + 时序限制的正确设计思想，
> 从零构筑的前端神经网络层（F 层）。
> **状态**：设计期 —— 交互区先行，代码逐层构筑中。
> **日期**：2026-08-31

---

## 一、设计基线（与对比项目的差异）

| 维度 | cube-frontend-op（对比） | cube-front（本项） |
|---|---|---|
| 结构 | 7371 行单文件 IIFE，六层职责平铺 | 分层架构：transport / protocol / repository / domain / controller / view |
| 状态 | FRAME/objMatState 等 7 套全局，20+ 处直接赋值 | FrameState 领域模型 + 状态机迁移函数（SSOT） |
| 数据 | 产物路径硬编码（T1-plaintext 等 46 处） | ArtifactStore 唯一入口，契约驱动（tasks.json r_docs） |
| 时序 | 标志位 + setTimeout 隐式拼凑 | 显式流程对象：ConnectFlow / SwitchFlow / ToolRunner |
| 模拟 | `__mockMode` 判断散落 15+ 处 | MockTransport 注入（传输层替换） |
| 解耦 | window 全局约定（eventBus/__opWrite） | 构造注入 + 观察者总线 |

## 二、目录结构

```
cube-front/
├── interaction/          # ★交互区：工作计划 / 后端建议 / 协同文档（先于此区定稿）
│   ├── README.md         #   交互区索引
│   ├── workplan-front.md #   前端逐层构筑工作计划（项目切换→R1A…R3B→R0.5→扩展→新项目）
│   ├── backend-proposals.md # 后端（cube-ide→cube-backend）修改建议（协同需求）
│   └── collaboration.md  #   前后端协同开发纪律与流程
├── docs/                 # 设计文档（五层定位/本体论映射/时序模型）
├── src/                  # 源码（分层，按工作计划逐层填充）
├── scripts/              # 开发辅助（构建/联调/检查）
└── README.md
```

## 三、五层定位

- F 层（本项）：交互 / 状态 / 渲染 —— 消费 B 层产物 JSON 与 WS 能力，呈现用例运行结果。
- 需求链：F → B（WS 13999）→ T（cube_tools 工具）→ C（cubeos 基座）。
- 能力链：C → T → B → F（产物信封 / IDE_VERIFY / FILE_TRANS 等回执）。
- 本体论：R0.5-R3B 产物 JSON 是唯一事实源；视图 = 产物的纯投影函数。