# 伺服器 {#server}

原始碼：[github.com/tuist/tuist/tree/main/server](https://github.com/tuist/tuist/tree/main/server)

## 用途 {#what-it-is-for}

此伺服器驅動 Tuist 的伺服器端功能，包括身分驗證、帳號與專案管理、快取儲存、分析洞察、預覽、套件註冊中心，以及整合服務（GitHub、Slack 與 SSO）。它是一個基於 Phoenix/Elixir 的應用程式，搭配 Postgres 與 ClickHouse。

## 如何貢獻 {#how-to-contribute}

對伺服器的貢獻需要簽署 CLA（`server/CLA.md`）。

### 本機設定 {#set-up-locally}

```bash
cd server
mise install

# Dependencies
brew services start postgresql@16
mise run clickhouse:start

# Install dependencies + set up the database
mise run install

# Run the server
mise run dev
```

在瀏覽器中開啟 `http://localhost:8080`。在開發環境中，登入頁面包含一個 **以測試使用者身分登入** 按鈕，可讓你使用預先建立的帳號登入（`tuistrocks@tuist.dev` / `tuistrocks`）。

> [!NOTE]
> 內部開發人員透過 fnox 從 1Password 載入開發密鑰 — `mise run dev` 會將伺服器包裝在 `fnox exec` 中（請參閱 `server/fnox.toml`）。外部貢獻者不需要存取 1Password；伺服器可以在沒有它的情況下於本機執行。OAuth、Stripe 與其他第三方整合將會停用，但核心功能仍可正常運作。

### 本機 Helm 測試 {#local-helm-testing}

你可以使用 [kind](https://kind.sigs.k8s.io/) 與內建的 mise 工作，在本機啟動完整堆疊。這會在本機建置 Docker 映像、建立 kind 叢集、安裝 Helm chart，並自動轉發所有服務的連接埠：

```bash
# Deploy everything (builds images from source)
mise run helm:up --license "YOUR_LICENSE_KEY"

# Include the observability stack (Grafana, Prometheus, Loki, Tempo)
mise run helm:up --license "YOUR_LICENSE_KEY" --observability

# Check status
mise run helm:status

# Tear down
mise run helm:down
```

**必要條件：** `docker`、`kind`、`helm` 與 `kubectl`。

### 測試與格式化 {#tests-and-formatting}

- 測試：`mix test`
- 格式化：`mise run format`
