Initial commit

docs/QA-troubleshooting.md

@@ -0,0 +1,94 @@
+<div dir="rtl">
+
+# Alvand-P — QA و عیب‌یابی (Fibitex)
+
+چک‌لیست عملیاتی برای staging (`beta.fibitex.com`) و لوکال. جزئیات deploy: [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md).
+
+## قبل از deploy
+
+- [ ] `git pull` روی `Update2026`
+- [ ] `bundle install` (در صورت تغییر Gemfile)
+- [ ] `rake render:config` — **بدون EPERM** روی `config/frontend/shahoo.env.js`
+- [ ] Vault unsealed — [`scripts/unseal-vault.ps1`](../../scripts/unseal-vault.ps1) یا `rake vault:setup`
+- [ ] `COMPOSE_FILE` درست (همه composeهای لازم)
+
+## render:config / EPERM
+
+| علامت | رفع |
+|--------|-----|
+| `shahoo.env.js` directory به‌جای فایل | پوشهٔ اشتباه را حذف؛ `rake render:config` دوباره |
+| EPERM روی Windows | ترمینال admin یا exclude antivirus روی `config/` |
+| تغییر template اعمال نشد | `rake render:config` نه فقط `restart` |
+
+## Vault sealed
+
+<div dir="ltr">
+
+```bash
+docker compose exec vault vault status
+# Sealed → unseal با keys از ops
+```
+
+</div>
+
+لوکال: `.\scripts\unseal-vault.ps1`
+
+## Compose logging — recreate نه restart
+
+`logging:` در compose فقط هنگام **create** کانتینر اعمال می‌شود.
+
+<div dir="ltr">
+
+```bash
+export COMPOSE_FILE=compose/app.yaml:compose/backend.yaml:compose/gateway.yaml:compose/proxy.yaml:compose/daemons.yaml:compose/frontend.yaml
+docker compose -p fibitex up -d --force-recreate
+docker inspect fibitex_peatio_1 --format '{{.HostConfig.LogConfig.Type}} {{.HostConfig.LogConfig.Config}}'
+```
+
+</div>
+
+## دو stack Carbon موازی
+
+**هرگز** هم‌زمان `carbon` (legacy path) و `carbon_platform` با `-p carbon` up نکنید — لاگ و دیتا duplicate می‌شود.
+
+فقط: `docker compose -p carbon -f docker-compose.prod.yml -f docker-compose.traefik.yml`
+
+## Smoke tests
+
+<div dir="ltr">
+
+```bash
+curl -sS -o /dev/null -w '%{http_code}\n' https://beta.fibitex.com/
+curl -sS -o /dev/null -w '%{http_code}\n' https://shahoo.fibitex.com/health
+docker compose -p fibitex ps
+bash ~/main-code/scripts/check-docker-log-disk.sh
+```
+
+</div>
+
+## دیسک / لاگ Docker
+
+| علامت | اقدام |
+|--------|--------|
+| root >85% | `check-docker-log-disk.sh` exit 1 — `sudo truncate-docker-logs.sh` |
+| لاگ یک کانتینر >100MB | truncate (نیاز sudo) یا `--force-recreate` بعد از log rotation |
+| cron | `crontab -l` — هر ۶ ساعت → `~/log-disk-check.log` |
+
+ارجاع: [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md) §۸.۳، [`Docs/07-setup-server.md`](../../Docs/07-setup-server.md) §۶.۲
+
+## Shahoo / BFF
+
+- BFF: [`Shahoo-BFF/README.md`](../../Shahoo-BFF/README.md)
+- E2E: `.\scripts\test-shahoo-e2e.ps1`
+
+## مستندات مرتبط
+
+| سند | موضوع |
+|-----|--------|
+| [`Docs/Fibitex-staging-deploy.md`](../../Docs/Fibitex-staging-deploy.md) | Deploy staging |
+| [`Docs/07-setup-server.md`](../../Docs/07-setup-server.md) | Production |
+| [`Docs/06-setup-local.md`](../../Docs/06-setup-local.md) | لوکال |
+| [`Docs/troubleshoot-barong-authz.md`](troubleshoot-barong-authz.md) | Barong authz |
+| [`carbon_platform/Docs/QA-troubleshooting.md`](../../carbon_platform/Docs/QA-troubleshooting.md) | Carbon |
+
+</div>