اسکریپت‌های عملیاتی پروژه
تمام اسکریپت‌های پوشهٔ scripts/ از ریشهٔ مخزن اجرا می‌شوند. هر کارت، مستند کامل همان اسکریپت را باز می‌کند: کاربرد، جایگاه در معماری، رفتار، تصمیمات طراحی و دستورات.
bring_up.sh
راه‌اندازی مرحله‌ای استک: env، infra، app-api، seed اپ‌ها، سپس crawler / consumer — تا اولین crawl با registry پر شروع شود.
seed_apps.sh
ثبت idempotent لیست اولیهٔ ۱۵ اپ از طریق App API؛ معمولاً از داخل bring_up قبل از crawler صدا زده می‌شود.
infra/check_infra.sh
Smoke Test سلامت PostgreSQL، Kafka و Metabase؛ بدون فرض روی کیفیت دادهٔ اپلیکیشن.
مشاهده مستند ← INFRA · KAFKAinfra/create_topics.sh
ساخت یا عریض‌کردن تاپیک‌های app-stats، reviews و network-metrics با تعداد پارتیشن انتخابی.
verify/verify_storage_consumer.sh
بررسی end-to-end اینکه Storage Consumer سالم است و پیام‌های Kafka واقعاً در PostgreSQL نشسته‌اند.
مشاهده مستند ← VERIFY · NETWORKverify/verify_network_metrics.sh
خواندن پیام‌های تاپیک network-metrics برای تأیید انتشار خروجی Network Analyzer.
network/analyze_pcaps.sh
پردازش دسته‌ای فایل‌های PCAPdroid در inbox و مسیریابی به processed / failed بر اساس کد خروج Analyzer.
مشاهده مستند ← REPORTSreports/finalize_cycle_reports.py
نهایی‌سازی گزارش‌های چرخهٔ crawl+persist پس از رسیدن lag کافکا به صفر؛ هستهٔ سرویس cycle-reporter.
run_tests_in_docker.sh
استک تست ایزوله (playpulse_test + .env.test)، اجرای سوئیت‌های پروفایل test، خلاصهٔ PASS/FAIL/SKIPPED، و teardown خودکار.
manual_sentiment_check.py
Smoke دستی مدل احساس Cardiff XLM-R روی نمونه‌های فارسی و انگلیسی؛ خارج از pytest.
مشاهده مستند ←جریان‌های معمول
seed_apps معمولاً داخل خود bring_up اجرا می‌شود (بعد از app-api، قبل از crawler). استقرار سرور: مستند Ansible. برای شبکه: analyze_pcaps سپس verify_network_metrics. برای گزارش چرخه: bring_up --with-cycle-reports.