platform: modularize api/gui, add docs-tests-web foundation, and refresh root config
This commit is contained in:
42
docs/phase-e/E5_SINGBOX_PROTOCOL_MATRIX_TEMPLATE.md
Normal file
42
docs/phase-e/E5_SINGBOX_PROTOCOL_MATRIX_TEMPLATE.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# E5 SingBox Protocol Matrix Template
|
||||
|
||||
Дата: 2026-03-08
|
||||
Статус: active template
|
||||
Владелец: Engineering
|
||||
|
||||
## 1) Назначение
|
||||
- Единый шаблон, по которому фиксируем поля протокола `sing-box` до реализации GUI.
|
||||
- Используется для desktop сейчас и для web/iOS/Android позже.
|
||||
|
||||
## 2) Карточка протокола
|
||||
- `Protocol`: `<vless|trojan|shadowsocks|wireguard|hysteria2|tuic|...>`
|
||||
- `Mode`: `typed` / `raw` / `typed+raw`
|
||||
- `Target sing-box`: `>=1.12`
|
||||
- `Source docs`: ссылки на официальные страницы (`sing-box.sagernet.org`)
|
||||
- `UI phase`: `MVP` / `Phase-2` / `Raw-only`
|
||||
|
||||
## 3) Матрица полей (шаблон)
|
||||
|
||||
| JSON path | Type | Required | Default | Since | Validation | UI level | Notes |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| `outbound.type` | enum/string | yes | `<protocol>` | - | fixed const | MVP | |
|
||||
| `...` | | | | | | | |
|
||||
|
||||
## 4) Зависимости/guardrails (шаблон)
|
||||
|
||||
| Rule ID | Condition | Constraint | Error text |
|
||||
|---|---|---|---|
|
||||
| `R-001` | `...` | `...` | `...` |
|
||||
|
||||
## 5) Runtime/apply flow (шаблон)
|
||||
- `Preview render` -> `Validate` -> `Apply` -> `History` -> `Rollback`.
|
||||
- `Apply` только после `Validate ok=true`.
|
||||
- Mutating операции через `base_revision` (optimistic lock).
|
||||
|
||||
## 6) Минимум для GUI
|
||||
- Секция `Server/Auth` (endpoint + credentials).
|
||||
- Секция `TLS/Reality` (если применимо).
|
||||
- Секция `Transport` (если применимо).
|
||||
- Секция `Advanced` (скрыта по умолчанию).
|
||||
- `Raw JSON` всегда доступен как escape hatch.
|
||||
|
||||
Reference in New Issue
Block a user