منصوبے کے بارے میں

## کیا ہے quick-cita-cr کوسٹا ریکا کے ایڈوکیشن وائل پورٹل پر ملاقات کے اوقات کے لیے ایک ذاتی مانیٹرنگ ٹول ہے۔ یہ آپ کے اپنے اکاؤنٹ کریڈنشلز کے ساتھ لاگ ان کرتا ہے، آپ کی جانب سے کانفیگر کردہ عملی ٹیسٹ برانچز چیک کرتا ہے، اپنے دیکھے ہوئے ڈیٹا کا مقامی ریکارڈ رکھتا ہے، اور جب نئی یا زودتر تاریخیں ظاہر ہوتی ہیں تو آپ کو اطلاع دیتا ہے۔ README میں بیان کیا گیا ہے کہ منصوبہ مقامی طور پر زندہ پورٹل کے خلاف تصدیق شدہ ہے۔ یہ یہ بھی نوٹ کرتا ہے کہ ایک جانی جانی حد: تصدیق کے دوران، صرف ہیڈلس موڈ میں کلاؤڈ فلیئر چیلنجز قابل اعتماد طریقے سے حل نہیں ہوتے، لہذا غیر نگرانی شدہ ا deployments کے لیے ہیڈڈ موڈ، ورچوئل ڈسپلے، یا گرم کردہ مستقل پروفائل کی سفارش کی جاتی ہے۔ ## رپورٹ کردہ صلاحیتیں README نے درج ذیل خصوصیات کی فہرست دی ہے: - برانچ بلحاظ ملاقات کی نگرانی۔ - نئی تاریخوں، زودتر بہترین تاریخ، اور قابل کانفیگریشن "تیز ونڈو" دنوں کے لیے الرٹس۔ - SQLite حالت تاکہ دوبارہ چلانے سے صرف معنی خیز تبدیلیوں پر الرٹ ہو۔ - ایپ پاس ورڈز کے ساتھ Gmail SMTP نوٹیفیکیشنز۔ - کوکیز اور سیشن حالت برقرار رکھنے کے لیے مستقل Chrome پروفائل۔ - انسانی طرز کی ٹائپنگ، کلکس، تاخیریں، اور سکرولنگ۔ - `undetected_chromedriver` کے ذریعے Chrome اینٹی ڈیٹیکشن فلیگز۔ - ٹیسٹس، لنٹنگ، اور ٹائپ چیکس کے ساتھ `uv`-بنیادی پائیتھن منصوبہ۔ - Linux / Oracle Cloud کے لیے systemd صارف ٹائمر ٹیمپلیٹس۔ README کا حالت حصہ کہتا ہے کہ کلاؤڈ فلیئر چیلنج ہیڈڈ موڈ میں حل ہوا، مستقل پروفائل کے ساتھ لاگ ان کام کیا، عملی ٹیسٹ فلو نے برانچ دستیابی تک پہنچا، ملاقات کی تاریخیں استخراج کی گئیں اور SQLite حالت کے خلاف موازنہ کی گئی، اور ای میل نوٹیفیکیشن فارمیٹنگ کام کیا۔ ## ضروریات - پائیتھن 3.12 یا 3.13 - `uv` - Chrome یا Chrome for Testing - ایڈوکیشن وائل اکاؤنٹ - عملی ٹیسٹ فلو کے لیے رسید نمبر - اختیاری طور پر، ای میل نوٹیفیکیشنز کے لیے Gmail ایپ پاس ورڈ ## شروع کرنا ریپوزیٹری کلون کریں، `uv sync` چلائیں، پھر `uv run quick-cita init` چلائیں۔ رازداری `~/.config/quick-cita-cr/secrets.env` میں ہوتی ہے (README `chmod 600` کی سفارش کرتا ہے)، اور برانچز اور براؤزر سیٹنگز `~/.config/quick-cita-cr/config.yamlر، ای میل نوٹیفیکیشنز کے لیے Gmail ایپ پاس ورڈ ## شروع کرنا ریپوزیٹری کلون کریں، `uv sync` چلائیں، پھر `uv run quick-cita init` چلائیں۔ رازداری `~/.config/quick-cita-cr/secrets.env` میں ہوتی ہے (README `chmod 600` کی سفارش کرتا ہے)، اور برانچز اور براؤزر سیٹنگز `~/.config/quick-cita-cr/config.yaml` میں ہوتی ہیں۔ تشخیص `uv run quick-cita doctor` کے ذریعے دستیاب ہے۔ ایک مرتبہ دیکھنے والی چیک `uv run quick-cita check --headed` سے چلائی جا سکتی ہے، اور مسلسل نگرانی `uv run quick-cita watch --headed` سے۔ ایک `demo` کمانڈ بھی ہے جو ایک دیکھنے والی براؤزر کھولتی ہے، مستقل پروفائل کا استعمال کرتی ہے، کانفیگر کردہ برانچز چیک کرتی ہے، اور نئے الرٹ واقعات نہ ہونے کی صورت میں بھی ملاقات کا خلاصہ پرنٹ کرتی ہے۔ ## کانفیگریشن علاقے YAML کانفیگ تین گروپس کو کور کرتی ہے: - **appointment** — لائسنس کلاس، برانچز کی فہرست، `quick_window_days`، اور پہلی بار چلانے، نئی تاریخ، زودتر بہترین اور ونڈو کے اندر نوٹیفیکیشنز کے لیے سوئچز۔ - **schedule** — منٹوں میں وقفہ، جیٹر فیصد، ناکامیوں کی زیادہ سے زیادہ تعداد جس کے بعد رک جانا ہے، اور ناکامیوں کے بعد کتنی دیر تک رکنا ہے۔ - **browser** — ہیڈلس فلیگ، Chrome ایگزیکیوٹیبل پاتھ، پروفائل ڈائریکٹری، اور ٹائم آؤٹ۔ نوٹیفیکیشنز فی الحال Gmail SMTP (ہوسٹ، پورٹ، سے ایڈریس، ریسیپینٹ لسٹ) کے ذریعے ای میل کی حمایت کرتی ہیں۔ ID ٹائپ، شناختی نمبر، پاس ورڈ، رسید نمبر، اور ای میل کریڈنشلز جیسی رازداریاں ماحولیاتی متغیرات یا رازداری فائل سے پڑھی جاتی ہیں۔ ## سوڈو کے بغیر Chrome سیسٹم انسٹال شدہ لینکس Chrome اور سوڈو کے بغیر مشینز کے لیے، README ایک ترتیب فراہم کرتا ہے جو Chrome for Testing کو `~/.local/share/quick-cita-cr/chrome-for-testing` میں ڈاؤن لوڈ کرتا ہے، ایک چھوٹے پائیتھن اسکرپٹ کے ساتھ اسے انزپ کرتا ہے، اور بائنری اور کریش پیڈ ہینڈلر کو ایگزیکیوٹیبل بناتا ہے۔ کانفیگ میں `executable_path` اس نکالے گئے بائنری کی طرف اشارہ کرتا ہے۔ ## ترقی اور لے آؤٹ ترقی کی کمانڈز میں `uv sync --all-groups`، `ruff format`، `ruff check`، `mypy` on `src/quick_cita_cr`، اور `pytest` شامل ہیں۔ سورس ٹری براؤزر آٹومیشن (ڈرائیور، کلاؤڈ فلیئر سالور، انسانی رویے کے ہیلپرز)، نوٹیفیکیشن بیک اینڈز، Typer CLI، کانفیگ اور رازداری ماڈلز، پورٹل کلائنٹ، اپPOINTMENT-ڈیٹ پارسر، SQLite اسٹوریج، اور سنیپ شاٹس کو موازنہ کرنے اور واقعات کا پتہ لگانے والا واچر کو گروپ کرتی ہے۔ ٹیسٹس، GitHub Actions CI، systemd ڈیپلائمنٹ ٹیمپلیٹس، اور ڈیپلائمنٹ/سیکیورٹی دستاویزات اس کے ساتھ ہی موجود ہیں۔ ## سیکیورٹی نوٹ README کریڈنشلز، `.env` فائلیں، SQLite حالت، براؤزر پروفائلز، کوکیز، سکرین شاٹس، لاگز، یا اوثنٹیکیٹڈ HTML کو کمٹ کرنے سے منع کرتا ہے، اور `docs/security.md` کی طرف اشارہ کرتا ہے۔ ## لائسنس MIT۔