gh next

استنساخ بسيط من github في Next.js

مصدر GITHub البديل البديل المفتوح على GitHub (Ironic Right؟) ، وهو يهدف إلى أن يكون يعمل بكامل طاقته مع بعض الميزات الأساسية للعمل GitHub.

انظر #84 لمزيد من المعلومات حول الميزات المدعومة.

️ هذا المشروع في التطوير النشط ️

نتوقع أن تنكسر الأشياء.

خريطة الطريق

انقر لرؤية المزيد

• تسجيل الدخول/تسجيل الدخول
• الصفحة الرئيسية (محتوى ReadMe)
• تخطيط مستجيب
• صفحة الإعدادات لتبديل موضوع
• صفحة النجوم
• انظر معلومات الملف الشخصي
  • تحديث اسم المستخدم
  • تغيير الموضوع
  • صفحة تفاصيل المستخدم
• صفحة قائمة المشكلات
  • مشكلات البحث والفلتر من قبل المؤلف ، الملصق ، المحدد ، مغلق/مفتوح ، العنوان ، الإشارات ، إلخ (الإلهام: https://github.com/openstatushq/openstatus ، https://docs.github.com/en/issues/tracking-your-work-with-issues/filtering--searching-isss-pull-requests)
• صفحة إصدار جديدة
  • إصدار Crud (من قبل المؤلف فقط)
  • تعليقات كرود
  • يذكر
  • قضية popovers (لمعاينة القضايا)
  • الارتباط بين القضايا
  • تعيين وتعيين المشكلات الذاتية
• OpenGraph
  • Landing (إلهام: https://github.com/trpc/trpc/blob/main/www/og-image/pages/api/landing.tsx)
  • لكل مستودع
  • لكل مستخدم
  • لكل قضية (إلهام: https://opengraph.githubassets.com/101e5bdeef8e959c800fab2aef88eef0b01b15d883e3e17c90bde8dfd67d6b3/trpc/trpc/issues/4306)
• تسميات crud (لا يمكن فقط إضافة أو تحديث الملصقات ، لا حذف)
• صفحة الإخطارات
  • شارة الإخطارات (الإلهام: https://gist.github.com/fredkiss3/ab918aee3977d681f0508537a44838c0 ، https://github.com/fredkiss3/bunrest)
  • إشعارات الاشتراكات في القضايا
  • إشعارات الإشارات
  • الإخطارات لأوضع القضية
  • إخطارات التصفية حسب الحالة ، العنوان ، مغلق ، إلخ.
  • علامة كما فعلت ، إلغاء الاشتراك
• ملفات استضافة لإعادة التسجيل (مع حد تخزين)
  • ملف تصفح واجهة المستخدم
  • البحث عن الملف
• قائمة المستودعات
  • قائمة من repos
  • ابحث عن repos
• جيت ويب واجهة المستخدم
  • ارتكاب التاريخ
  • السفر عبر الزمن
  • دعم git push و git remote
• إصدار Kanban Board (مثل مشاريع Github) ، لإغلاق مشكلة إما بالتزام أو من واجهة المستخدم
• CI/CD
  • تشغيل CI مع Docker ، يمكننا أن نستلهم من Gitlab

كومة

• توجيه التطبيق التالي
• رذاذ + قاعدة بيانات postgres المحلية
• استضافته VPS مخصصة ، انظر سير عمل CI/CD لكيفية نشره كله
• Tailwindcss للتصميم

متطلبات

• العقدة> = v18.x
• pnpm> = v8.x
• تم تثبيت Docker للتطوير المحلي
• تطبيق github مسجل لمصادقة المستخدمين

كيف تعمل في المشروع؟

1. أولاً عليك استنساخ المستودع

   git clone https://github.com/Fredkiss3/gh-next.git

2. بدء تشغيل Docker Compose لبدء مثيل DB + Redis:

   docker-compose up -d --remove-orphans

3. تثبيت التبعيات:

   pnpm install

4. إعادة تسمية .env.example إلى .env.local وتغيير الملف إلى احتياجاتك ،

5. وإطلاق المشروع:

   pnpm run dev

   سيظهر التطبيق على http: // localhost: 3000.

6. افتح رمز المصدر وابدأ في هزاز! ؟

؟ هيكل المشروع

نظرة سريعة على الملفات والأدلة ذات المستوى الأعلى الذي ستراه في هذا المشروع.

  .
  ├── src/
  │    ├── app
  │    ├── actions
  │    ├── components
  │    ├── models
  │    └── lib/
  │         ├── client
  │         ├── server
  │         └── shared
  ├── biome.json
  ├── pnpm-lock.yaml
  └── tsconfig.json

1. src/app/ : يحتوي هذا المجلد على جميع طرق وصفحات تطبيقنا.

2. src/actions : يحتوي هذا المجلد على كل منطق تطبيقنا.

3. src/components : يحتوي هذا المجلد على جميع مكونات تطبيقنا.

4. src/models : يحتوي هذا المجلد على جميع نماذج DB لتطبيقنا.

5. src/lib/ : يحتوي هذا المجلد على استخدامات ومساعدين مستخدمين في تطبيقنا:

   1. client : يحتوي هذا المجلد على جميع الأدوات المساعدة التي يتم استخدامها فقط العميل ، وعادة ما تستخدمها مكونات العميل. أنه يحتوي بشكل أساسي على السنانير

   2. server : يحتوي هذا المجلد على جميع الأدوات المساعدة الخادم فقط ، للاستخدام داخل مكونات الخادم وإجراءات الخادم. كما أنه يحتوي على مخططات DB داخل db/schema

   3. shared : يحتوي هذا المجلد على جميع الأدوات المساعدة التي يتم مشاركتها بين الخادم والعميل ، ويمكن استخدامها في أي مكان في التطبيق.

6. biome.json : يحتوي هذا الملف على التكوين لـ Biome لتمكين التنسيق التلقائي.

7. pnpm-lock.yaml : يحتوي هذا الملف على قفل التبعيات لإعادة الريبو.

8. tsconfig.json : يحتوي هذا الملف على التكوين لـ TypeScript ، والذي يستخدمه جميع الحزم الأساسية

؟ متغيرات البيئة المستخدمة

نوم	دور
SESSION_SECRET	سلسلة عشوائية 32 chars تستخدم لترميز معرف الجلسة
REDIS_HTTP_URL	عنوان URL إلى الاتصال بـ Redis HTTP لمخزن المفاتيح/القيمة
DATABASE_URL	عنوان URL إلى الاتصال بقاعدة بيانات Postres
REDIS_HTTP_USERNAME	عنوان URL لخادم الملفات المحلي لتخزين قيم المفاتيح
REDIS_HTTP_PASSWORD	عنوان URL لخادم الملفات المحلي لتخزين قيم المفاتيح
GITHUB_CLIENT_ID	معرف عميل github مخزّن لتطبيقنا المستخدم لمصادقة المستخدمين مع github
GITHUB_PERSONAL_ACCESS_TOKEN	رمز GitHub Client Token مخزنة لتطبيقنا المستخدم لمصادقة المستخدمين مع Github
GITHUB_REDIRECT_URI	عنوان URL لإعادة التوجيه عند مصادقة المستخدم
GITHUB_SECRET	Secret Github مخزنة لتطبيقنا