# راه‌اندازی وب‌سرور سیتکا

سامانه سیتکا از پوشه `public/` سرو می‌شود. پوشه‌های `src`، `config`،
`routes`، `storage` و `apps` هرگز نباید مستقیم در دسترس مرورگر قرار بگیرند.

## روش ۱ — اجرا زیر زیرپوشه (پیش‌فرض توسعه)

آدرس: `http://localhost/sitka/`

این روش در همین محیط XAMPP تنظیم شده است:

1. فایل `C:/xampp/apache/conf/extra/httpd-sitka.conf` شامل این خط است:

   ```apache
   Alias /sitka "C:/xampp/htdocs/sitka/public"
   ```

2. این فایل در انتهای `httpd.conf` ضمیمه شده است:

   ```apache
   Include "conf/extra/httpd-sitka.conf"
   ```

3. در `public/.htaccess` مقدار `RewriteBase` روی `/sitka/` تنظیم شده است.

پس از هر تغییر در پیکربندی Apache، سرور را ری‌استارت کنید.

## روش ۲ — اجرا روی ریشه دامنه یا پورت اختصاصی

آدرس: `http://sitka.local/` یا `http://SERVER-IP:8080/`

1. در `httpd-sitka.conf` بلوک میزبان مجازی پورت `8080` را ببینید.
2. در `public/.htaccess` مقدار `RewriteBase` را به خط زیر تغییر دهید:

   ```apache
   RewriteBase /
   ```

3. به‌جای پورت، می‌توانید `DocumentRoot` دامنه سازمان را مستقیم روی
   `C:/xampp/htdocs/sitka/public` تنظیم کنید.

## روش ۳ — محیط تولید

- `DocumentRoot` دامنه را روی `public/` بگذارید.
- گواهی SSL (HTTPS) فعال کنید؛ PWA و اعلان‌ها در HTTP کار نمی‌کنند.
- فایل `.env.example` را به `.env` کپی و مقادیر را پر کنید:
  `SITKA_BASE_URL`، `SITKA_EDITION` و اطلاعات پایگاه داده.

## نکات مهم برای PWA

| مورد | توضیح |
| --- | --- |
| HTTPS | درخواست برنامه‌ای برای ثبت سرویس‌ورکر و اعلان‌ها الزامی است |
| `manifest.php` | مانیفست پویا؛ مسیر پایه را خودکار تشخیص می‌دهد |
| `service-worker.php` | سرویس‌ورکر پویا؛ کش و اعلان را مدیریت می‌کند |
| نصب | کاربر از منوی مرورگر گزینه «افزودن به صفحه اصلی» را می‌بیند |