# Gaza

Gaza 是一个协议优先、跨平台的多 Teamserver 桌面工作台。当前仓库包含可运行的首个项目骨架，重点验证 Teamserver 工作区和标签页隔离模型。

## 技术栈

- Tauri 2（桌面容器）
- React 19 + TypeScript + Vite（界面）
- Vitest + Testing Library（单元与组件测试）

## 快速开始

本机安装 Node.js 22 与 Rust stable 后：

```bash
npm ci
npm run dev          # 浏览器开发模式
npm run tauri dev    # 桌面开发模式
```

无需本机 Node.js 的前端验证：

```bash
docker compose run --rm test
docker compose run --rm build
```

## Docker 启动 Web 测试服务

构建镜像并在后台启动：

```bash
docker compose up --build -d
```

浏览器访问 <http://127.0.0.1:1420>。查看状态和日志：

```bash
docker compose ps
docker compose logs -f web
```

停止服务：

```bash
docker compose down
```

默认只监听本机回环地址。需要让局域网测试设备访问时，显式设置监听地址和端口：

```bash
WEB_BIND_ADDRESS=0.0.0.0 WEB_PORT=1420 docker compose up --build -d
```

开放到局域网前请确认主机防火墙和测试网络范围；Web 预览不包含认证能力。

## 当前范围

- 展示多 Teamserver 连接状态和独立工作区。
- 切换 Teamserver 时隔离标签、项目导航和激活状态。
- 所有演示业务状态仅保存在进程内存，不写入本地存储。
- 提供 Tauri 最小权限配置；后续连接、协议与加密 SQLite 能力按独立迭代接入。

## 常用命令

```bash
npm run typecheck
npm test
npm run build
npm run tauri build
```