hashbro
72 lines
2.0 KiB
Markdown
72 lines
2.0 KiB
Markdown
# Coruna Lab Web
|
||
|
||
独立的渠道静态资源构建与分发服务，与 [`coruna-lab`](../coruna-lab/)（Laravel C2 / Admin）同级部署。
|
||
|
||
```text
|
||
coruna-lab-web/
|
||
├── frontend/
|
||
│ ├── source/ # 只读模板 / 明文输入（勿直接 --apply）
|
||
│ ├── tools/ # new_project / patch_*
|
||
│ ├── doc/ # Stage JS / sync / C2 链路文档
|
||
│ └── tests/ # native path patch 等工具测试
|
||
├── build_api/ # 同步 Build / Delete HTTP API（FastAPI）
|
||
├── docs/BUILD_API.md
|
||
├── tests/ # build_api 单元测试
|
||
└── artifacts/ # 本地默认产物根（gitignore）
|
||
└── channel/<id>/{web,sync,out,manifest.json}
|
||
```
|
||
|
||
兄弟项目：
|
||
|
||
```text
|
||
ios-fetch/
|
||
├── coruna-lab/ # Laravel：渠道元数据、C2、Admin
|
||
└── coruna-lab-web/ # 本仓库：构建 + 静态产物站
|
||
```
|
||
|
||
Laravel 通过 `CORUNA_BUILD_SERVICE_*` 调用本服务的：
|
||
|
||
- `POST /v1/channels/{id}/build`
|
||
- `DELETE /v1/channels/{id}`
|
||
|
||
公开静态路径：
|
||
|
||
```text
|
||
/channel/<id>/web/support.html
|
||
/channel/<id>/sync/daily.html
|
||
```
|
||
|
||
## Setup
|
||
|
||
```bash
|
||
cd coruna-lab-web
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
|
||
export BUILD_API_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(48))')"
|
||
export BUILD_API_ARTIFACT_ROOT="$PWD/artifacts"
|
||
python3 -m build_api
|
||
```
|
||
|
||
手动构建（不经 API）：
|
||
|
||
```bash
|
||
python3 frontend/tools/new_project.py \
|
||
--channel-id 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
|
||
--deployment-domains 'www.dep.example' \
|
||
--reporting-domains 'www.rep.example'
|
||
```
|
||
|
||
## Tests
|
||
|
||
```bash
|
||
python3 -m unittest discover -s tests -p 'test_*.py'
|
||
python3 -m unittest discover -s frontend/tests -p 'test_*.py'
|
||
python3 -m unittest discover -s frontend/tools/tests -p 'test_*.py'
|
||
```
|
||
|
||
## Deploy
|
||
|
||
见 [`docs/BUILD_API.md`](docs/BUILD_API.md)。可用宝塔等面板托管进程与反向代理，仓库内不维护 Nginx / systemd 样例。
|