Alvand-P/docs/QA-troubleshooting.md

Alvand-P — QA و عیب‌یابی (Fibitex)

چک‌لیست عملیاتی برای staging (beta.fibitex.com) و لوکال. جزئیات deploy: 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 یا 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

docker compose exec vault vault status
# Sealed → unseal با keys از ops

لوکال: .\scripts\unseal-vault.ps1

Compose logging — recreate نه restart

logging: در compose فقط هنگام create کانتینر اعمال می‌شود.

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}}'

دو 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

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

دیسک / لاگ 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/07-setup-server.md §۶.۲

Shahoo / BFF

• BFF: Shahoo-BFF/README.md
• E2E: .\scripts\test-shahoo-e2e.ps1

مستندات مرتبط

سند	موضوع
Docs/Fibitex-staging-deploy.md	Deploy staging
Docs/07-setup-server.md	Production
Docs/06-setup-local.md	لوکال
Docs/troubleshoot-barong-authz.md	Barong authz
carbon_platform/Docs/QA-troubleshooting.md	Carbon