> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# Kurulum

> PC yazıcı sürücüsünü yükleyin ve çalıştırın.

# Kurulum

Üretim yapısı `drivers/pc-printer/plato-printer.zip`'dir. Yürütülebilir dosyayı, varsayılan yapılandırmayı, Caddy varlıklarını/sertifikalarını ve Redis ikili dosyalarını içerir.

## Üretim Kurulumu

1. `plato-printer.zip`'yi yazıcılara ulaşabilen Windows makinesine kopyalayın.
2. Zip'i sabit bir klasöre çıkarın, örneğin `C:\PlatoPrinter`.
3. `config.json`'yi düzenleyin.
4. `plato-printer.exe`'yi çalıştırın.
5. Yapılandırılmış HTTP bağlantı noktası için Windows Güvenlik Duvarı erişimine izin verin.
6. Hizmetin ulaşılabilir olduğunu doğrulayın:

```sh theme={null}
curl http://localhost:8080/health
```

Beklenen yanıt:

```json theme={null}
{
  "ok": true,
  "version": 66,
  "uptime": 12.345
}
```

## Ağ Kurulumu Kontrol Listesi

* Sürücü makinesi her yazıcı IP'sine ve yazıcı bağlantı noktasına erişebilir.
* POS tarayıcıları sürücü makinesine erişebilir.
* `config.json`'de değiştirilmediği sürece `8080` bağlantı noktası HTTP için açıktır.
* HTTPS etkinleştirilirse `443` bağlantı noktası açıktır.
* Yazıcı IP adresleri statiktir veya DHCP'de ayrılmıştır.
* Termal yazıcılar TCP üzerinden ham ESC/POS'yi kabul eder.

## HTTPS Kurulum Kontrol Listesi

HTTPS etkinleştirildiğinde:

1. `features.httpsEnabled` ve `caddy.enabled`'yi `true` olarak ayarlı tutun.
2. `assets/certs/ca.crt`, `server.crt` ve `server.key`'nin mevcut olduğundan emin olun.
3. `caddy.domain`'yi genellikle DNS veya ana bilgisayar girişi aracılığıyla sürücü makinesine yönlendirin.
4. CA sertifikasını şuradan yükleyin:

```txt theme={null}
http://<driver-ip>:8080/ca.crt
```

5. Konsoldan HTTPS sürücüsünü URL kullanın, genellikle:

```txt theme={null}
https://plato-printer.local
```

## Otomatik Başlatma

Başlangıçta yürütülebilir dosya, `Plato PC Printer` uygulama adını kullanarak otomatik başlatmayı kaydeder. Yürütülebilir yol `process.execPath`'dir ve hizmet gizli başlayacak şekilde yapılandırılmıştır.

Otomatik başlatma başarısız olursa sürücü arızayı günlüğe kaydeder ve çalışmaya devam eder.

## Geliştirme Kurulumu

Depo kökünden:

```sh theme={null}
pnpm install
pnpm --filter @plato/pc-printer build
pnpm --filter @plato/pc-printer start
```

Geliştirme sunucusu, bu klasörde başlatıldığında `drivers/pc-printer`'den `config.json`'yi okur.

## Yerel Sağlık Kontrolü

```sh theme={null}
curl http://localhost:8080/health
curl http://localhost:8080/queue-status
```

HTTPS etkinleştirilmiş ve yapılandırılmışsa:

```sh theme={null}
curl https://plato-printer.local/health
```