PR Comment Inbox: کامنتهای پولریکوئست به شکل صندوق نامه
خلاصهٔ کاملتر
PR Comment Inbox یه ابزار وب از humanwhocodes هست که پولریکوئستهای گیتهاب رو از دید کامنتها نشون میده، نه از دید فایلها. پنل چپ یه اینباکس از رشتههای بحثه، چه کامنتهایی که رو خطهای کد گذاشته شدن و چه کامنتهای کلی گفتگو. پنل راست بحث انتخابشده رو با diff اون قسمت از کد، یه جعبهی جواب Markdown شبیه خود گیتهاب و دکمههای resolve و «خوانده شد» نشون میده.
دو نوع رشته داریم. کامنتهای inline همون رشتهی review گیتهاب هستن و resolve کردنشون واقعاً از طریق GraphQL روی گیتهاب اعمال میشه. کامنتهای کلی (top-level) بر اساس نویسنده گروه میشن: همهی کامنتهای یه نفر بهعلاوهی هر کامنتی که اونو @mention کرده یه رشته حساب میشه. چون گیتهاب برای اینها resolve نداره، مخفی کردنشون فقط محلی و تو localStorage ذخیره میشه.
دکمهی «Mark read» یه رشته رو از نماهای Unresolved و @mentions قایم میکنه تا وقتی که فعالیت جدیدی روش بیاد. جوابها از طریق API گیتهاب فرستاده میشن و پیشنمایش Markdown هم با endpoint /markdown خود گیتهاب ساخته میشه، پس چیزی که میبینی همونیه که گیتهاب نشون میده. اگه کامنتی بلوک suggestion داشته باشه، یه دکمهی Apply suggestion هم میاد که تغییر رو مستقیم روی برنچ PR اعمال میکنه.
پروژه با Astro ساخته شده و روی Cloudflare Workers اجرا میشه، با islandهای Preact (یعنی تیکههای تعاملی جدا تو یه صفحهی سروری) و Tailwind CSS v4. برای ورود میشه یه personal access token گیتهاب داد که تو یه کوکی HTTP-only نگه داشته میشه، یا بهصورت اختیاری یه OAuth app ساخت. یه PR نمایشی هم داره که بدون توکن میشه امتحانش کرد.
نکات کلیدی:
- resolve کامنتهای inline واقعاً روی گیتهاب و با GraphQL انجام میشه
- وضعیت خواندهشده و مخفیشدن کامنتهای کلی فقط تو localStorage و برای هر PR جدا ذخیره میشه
- دکمهی Apply suggestion تغییر پیشنهادی رو مستقیم روی برنچ PR مینویسه
- ساختهشده با Astro، Preact و Tailwind CSS v4 روی Cloudflare Workers
- توکن تو کوکی HTTP-only نگه داشته میشه و فقط به api.github.com فرستاده میشه




