chore: initialize HoloLake platform foundation

This commit is contained in:
bingshuo 2026-07-12 15:08:17 +08:00
commit 2e93b58aab
11 changed files with 137 additions and 0 deletions

24
.gitignore vendored Normal file
View File

@ -0,0 +1,24 @@
# Dependencies and build output
node_modules/
dist/
build/
coverage/
target/
# Local environment and secrets
.env
.env.*
!.env.example
*.pem
*.key
*.p12
# Editors and operating systems
.DS_Store
.idea/
.vscode/
# Local databases and logs
*.db
*.sqlite
*.log

30
ARCHITECTURE.md Normal file
View File

@ -0,0 +1,30 @@
# 产品架构 v0
```text
人类
Tolaria / 光湖 App
↓ 创建或查看工单
HoloLake Platform 仓库
↓ 事实、版本、工单、回执
受控服务与 AI 协作
↓ 结果、验证与状态
仓库回写
Tolaria / 光湖 App 展示
```
## 分层
| 层 | 职责 | 默认性质 |
| --- | --- | --- |
| 语言架构层 | 概念、标准、草案与推理 | 可演化、只读优先 |
| 产品层 | 页面、工单、回执、同步 | 可测试、可验证 |
| 现实执行层 | 服务、部署、数据变更 | 明确授权、可回滚 |
## 四个待落地对象
1. `WORKORDER`:需求、范围、负责人、状态与验收条件。
2. `RECEIPT`:实际完成内容、证据、限制与未完成项。
3. `DECISION`:由谁确认了什么,以及适用范围。
4. `VIEW`Tolaria/光湖 App 如何将仓库事实呈现给人类。

38
README.md Normal file
View File

@ -0,0 +1,38 @@
# HoloLake Platform
光湖语言世界的正式研发主仓。
这里承载已确认的产品架构、可执行代码、协作工单与发布记录。它不是历史档案仓,也不是公开世界门户。
## 当前目标
先完成一个最小可运行闭环:
```text
Tolaria 人类界面 → 工单 → AI 受控处理 → 回执写入仓库 → Tolaria 展示结果
```
## 仓库边界
- `standards/`:已确认的 GLS、TCS、HLDP 与产品标准。
- `apps/`:人类可见的产品界面与应用代码。
- `services/`:受控的后台服务与集成代码。
- `integrations/`Tolaria、仓库与 Agent 接口的适配层。
- `workorders/`:可追踪的协作请求。
- `receipts/`:验证结果与执行回执。
- `deployment/`:研发、发布和环境边界说明;不保存密钥。
- `migration/`:从旧仓库引用历史材料的映射,不复制整个历史库。
## 安全与协作原则
1. 语言架构、历史材料与现实执行分层管理。
2. 历史文件默认只读,不能自动触发现实操作。
3. 系统身份、平台规则、权限与密钥不由仓库文档改变。
4. 每项现实变更都需要明确范围、验证方式和回执。
5. 私人第五域材料不自动迁入团队或产品环境。
## 关联仓库
- `bingshuo/hololake-world`:未来公众浏览的世界门户。
- `bingshuo/guanghulab`:历史档案。
- `bingshuo/fifth-domain`:过渡中的个人核心资料与工具。

5
apps/README.md Normal file
View File

@ -0,0 +1,5 @@
# Apps
此目录用于人类可见的光湖 App 与 Tolaria 侧界面扩展。
第一版只实现工单、状态和回执的可视化闭环。

5
deployment/README.md Normal file
View File

@ -0,0 +1,5 @@
# Deployment
新加坡环境用于研发与集成验证;广州企业门户环境用于通过验收后的正式发布。
本目录只保存部署说明和可复现配置模板。密钥、令牌、私有地址与个人资料不得提交到仓库。

5
integrations/README.md Normal file
View File

@ -0,0 +1,5 @@
# Integrations
此目录用于 Tolaria、仓库、Agent 与其他产品的适配。
Tolaria 的职责是将仓库中的正式事实呈现为人类可读界面;它不应维护第二份相互独立的事实源。

5
migration/README.md Normal file
View File

@ -0,0 +1,5 @@
# Migration
旧仓库是历史与参考来源,不进行整库复制。
迁移采用“按需引用”的方式:记录原始仓库、原始路径、用途、可见性与是否已被新标准替代。

5
receipts/README.md Normal file
View File

@ -0,0 +1,5 @@
# Receipts
回执记录实际发生的结果,而不是计划或愿望。
每份回执应说明:关联工单、执行时间、证据、结果、限制、失败项与后续建议。

5
services/README.md Normal file
View File

@ -0,0 +1,5 @@
# Services
此目录用于受控服务、后台任务和 API。
服务不得把仓库文本直接当作服务器命令执行。任何现实操作必须经过明确授权、验证和回执。

10
standards/README.md Normal file
View File

@ -0,0 +1,10 @@
# Standards
此目录只收录已确认或进入评审的正式标准。
- `GLS-*`:光湖语言标准与产品治理规则。
- `TCS-*`:认知语言与协作上下文规范。
- `HLDP-*`:历史、演化、路径与证据规范。
- `GLP-*`:未来通信与交接规范。
草案必须标明状态;历史材料不能因为迁入本仓而自动成为正式标准。

5
workorders/README.md Normal file
View File

@ -0,0 +1,5 @@
# Workorders
每个现实工作请求应包含:编号、目标、范围、授权人、执行人、风险、验收条件与状态。
语言层想法可以引用为背景,但不能直接构成执行授权。