Files
opsxapi/docs/architecture.md
T
logan 0c0423d3a1 docs: 锁定 apps/desktop 目录权威与 SDD 短模板
- AGENTS/architecture:目录权威改为 apps/desktop + packages/* + apps/server;根 src 标误迁
- sdd-template:补何时必填与 FR→AC,保留 Shell/DB 短模板体;细流程仍 docs/specs/
- 安全三行钉死;HANDTEST/README 已无浏览器 :5173 工作台口径
2026-10-19 21:27:13 +08:00

39 lines
1.1 KiB
Markdown

# 架构说明
一页。规则以 [AGENTS.md](../AGENTS.md) 为准。
## 两套壳
| 壳 | 入口 | 做什么 | 不做什么 |
| --- | --- | --- | --- |
| 浏览器 | `./run.sh web` → `http://127.0.0.1:8787/` | 官网、文档、定价(`homepage/`) | 请求、集合、Mock 管理、自动化测试 |
| 桌面 | `./run.sh gui` | 全部操作 | 不把这套 UI 当成浏览器产品 |
## 目录权威
```text
apps/desktop 桌面 Tauri(唯一操作入口的代码)
packages/* 共享 UI / 传输 / 领域
apps/server Gin:官网静态托管、代理、本机 API
homepage/ 官网与文档源
```
根目录 `src/`、`src-tauri/`、根 `server/` 是误迁,不算权威,不要在上面继续长功能。
## 数据流
```text
apps/desktop
→ packages/*(传输与领域)
→ apps/server 127.0.0.1 管理 / 代理 / Mock 发布
→ Mock 响应 默认 127.0.0.1(不对公网)
homepage
→ 浏览器只读官网与文档,不碰集合与密钥
```
## 安全三行
1. 浏览器只看站 / 文档。操作只走 `./run.sh gui`。
2. Mock 默认 `127.0.0.1`,不上公网。
3. `/admin` 不落明文。