From 2e93b58aab49d8570f8e1b6cc8a8771ae5226ba2 Mon Sep 17 00:00:00 2001
From: bingshuo <565183519@qq.com>
Date: Sun, 12 Jul 2026 15:08:17 +0800
Subject: [PATCH] chore: initialize HoloLake platform foundation

---
 .gitignore             | 24 ++++++++++++++++++++++++
 ARCHITECTURE.md        | 30 ++++++++++++++++++++++++++++++
 README.md              | 38 ++++++++++++++++++++++++++++++++++++++
 apps/README.md         |  5 +++++
 deployment/README.md   |  5 +++++
 integrations/README.md |  5 +++++
 migration/README.md    |  5 +++++
 receipts/README.md     |  5 +++++
 services/README.md     |  5 +++++
 standards/README.md    | 10 ++++++++++
 workorders/README.md   |  5 +++++
 11 files changed, 137 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 ARCHITECTURE.md
 create mode 100644 README.md
 create mode 100644 apps/README.md
 create mode 100644 deployment/README.md
 create mode 100644 integrations/README.md
 create mode 100644 migration/README.md
 create mode 100644 receipts/README.md
 create mode 100644 services/README.md
 create mode 100644 standards/README.md
 create mode 100644 workorders/README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..87796ec
--- /dev/null
+++ b/.gitignore
@@ -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
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
new file mode 100644
index 0000000..4514ce4
--- /dev/null
+++ b/ARCHITECTURE.md
@@ -0,0 +1,30 @@
+# 产品架构 v0
+
+```text
+人类
+  ↓
+Tolaria / 光湖 App
+  ↓ 创建或查看工单
+HoloLake Platform 仓库
+  ↓ 事实、版本、工单、回执
+受控服务与 AI 协作
+  ↓ 结果、验证与状态
+仓库回写
+  ↓
+Tolaria / 光湖 App 展示
+```
+
+## 分层
+
+| 层 | 职责 | 默认性质 |
+| --- | --- | --- |
+| 语言架构层 | 概念、标准、草案与推理 | 可演化、只读优先 |
+| 产品层 | 页面、工单、回执、同步 | 可测试、可验证 |
+| 现实执行层 | 服务、部署、数据变更 | 明确授权、可回滚 |
+
+## 四个待落地对象
+
+1. `WORKORDER`：需求、范围、负责人、状态与验收条件。
+2. `RECEIPT`：实际完成内容、证据、限制与未完成项。
+3. `DECISION`：由谁确认了什么，以及适用范围。
+4. `VIEW`：Tolaria/光湖 App 如何将仓库事实呈现给人类。
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4c9b679
--- /dev/null
+++ b/README.md
@@ -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`：过渡中的个人核心资料与工具。
diff --git a/apps/README.md b/apps/README.md
new file mode 100644
index 0000000..27ac724
--- /dev/null
+++ b/apps/README.md
@@ -0,0 +1,5 @@
+# Apps
+
+此目录用于人类可见的光湖 App 与 Tolaria 侧界面扩展。
+
+第一版只实现工单、状态和回执的可视化闭环。
diff --git a/deployment/README.md b/deployment/README.md
new file mode 100644
index 0000000..a417d8e
--- /dev/null
+++ b/deployment/README.md
@@ -0,0 +1,5 @@
+# Deployment
+
+新加坡环境用于研发与集成验证；广州企业门户环境用于通过验收后的正式发布。
+
+本目录只保存部署说明和可复现配置模板。密钥、令牌、私有地址与个人资料不得提交到仓库。
diff --git a/integrations/README.md b/integrations/README.md
new file mode 100644
index 0000000..aabf40a
--- /dev/null
+++ b/integrations/README.md
@@ -0,0 +1,5 @@
+# Integrations
+
+此目录用于 Tolaria、仓库、Agent 与其他产品的适配。
+
+Tolaria 的职责是将仓库中的正式事实呈现为人类可读界面；它不应维护第二份相互独立的事实源。
diff --git a/migration/README.md b/migration/README.md
new file mode 100644
index 0000000..b6c43b6
--- /dev/null
+++ b/migration/README.md
@@ -0,0 +1,5 @@
+# Migration
+
+旧仓库是历史与参考来源，不进行整库复制。
+
+迁移采用“按需引用”的方式：记录原始仓库、原始路径、用途、可见性与是否已被新标准替代。
diff --git a/receipts/README.md b/receipts/README.md
new file mode 100644
index 0000000..b9604a5
--- /dev/null
+++ b/receipts/README.md
@@ -0,0 +1,5 @@
+# Receipts
+
+回执记录实际发生的结果，而不是计划或愿望。
+
+每份回执应说明：关联工单、执行时间、证据、结果、限制、失败项与后续建议。
diff --git a/services/README.md b/services/README.md
new file mode 100644
index 0000000..e760ac4
--- /dev/null
+++ b/services/README.md
@@ -0,0 +1,5 @@
+# Services
+
+此目录用于受控服务、后台任务和 API。
+
+服务不得把仓库文本直接当作服务器命令执行。任何现实操作必须经过明确授权、验证和回执。
diff --git a/standards/README.md b/standards/README.md
new file mode 100644
index 0000000..672355b
--- /dev/null
+++ b/standards/README.md
@@ -0,0 +1,10 @@
+# Standards
+
+此目录只收录已确认或进入评审的正式标准。
+
+- `GLS-*`：光湖语言标准与产品治理规则。
+- `TCS-*`：认知语言与协作上下文规范。
+- `HLDP-*`：历史、演化、路径与证据规范。
+- `GLP-*`：未来通信与交接规范。
+
+草案必须标明状态；历史材料不能因为迁入本仓而自动成为正式标准。
diff --git a/workorders/README.md b/workorders/README.md
new file mode 100644
index 0000000..9ea48b7
--- /dev/null
+++ b/workorders/README.md
@@ -0,0 +1,5 @@
+# Workorders
+
+每个现实工作请求应包含：编号、目标、范围、授权人、执行人、风险、验收条件与状态。
+
+语言层想法可以引用为背景，但不能直接构成执行授权。