init

frontend/README.md

@@ -0,0 +1,35 @@
+# frontend — 投递模板与构建工具
+
+只读模板、`tools/` patch 脚本、链路文档。项目根是上一级 [`../`](../README.md)（`coruna-lab-web`）。
+生产构建由 [`../build_api/`](../build_api/) 调用；产物发布到 artifact root 的 `channel/<id>/`。
+
+```text
+frontend/
+├── source/          # 模板（勿直接 --apply）
+├── tools/           # new_project / patch_*
+├── doc/             # STAGE_JS / NATIVE_PACKS / SYNC …
+├── tests/           # path patch 等
+└── out/             # 可选缓存
+```
+
+## 快速构建
+
+在 **coruna-lab-web 根**执行：
+
+```bash
+cd ..   # → coruna-lab-web/
+pip3 install -r requirements.txt
+python3 frontend/tools/new_project.py \
+  --channel-id 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
+  --deployment-domains 'www.dep.example' \
+  --reporting-domains 'www.rep.example'
+```
+
+默认产物：`artifacts/channel/<id>/{web,sync,out}/`。  
+细节见 [`tools/README.md`](tools/README.md)、[`../docs/BUILD_API.md`](../docs/BUILD_API.md)。
+
+## 注意
+
+- 不要对 `source/` 使用 `--apply`
+- 首个 daily 路径与 daily 内模块 URL 均为 `/channel/<id>/sync/...`
+- Laravel Admin 在兄弟项目 `coruna-lab`，通过 HTTP 调用本仓库 build API