عن المشروع

Full Stack FastAPI Template هو مشروع تمهيدي لبناء تطبيقات الويب الكاملة، حيث يجمع بين واجهة خلفية بـ Python FastAPI وواجهة أمامية بـ React، مع البنية التحتية اللازمة للتشغيل والنشر. الواجهة الخلفية: FastAPI تخدم الـ API، بينما يتولى SQLModel التعامل مع قاعدة بيانات SQL كـ ORM، ويوفر Pydantic التحقق من البيانات وإدارة الإعدادات. تعتمد المصادقة على رموز JWT، ويتم تشفير كلمات المرور بشكل آمن تلقائياً، مع دعم استعادة كلمة المرور عبر البريد الإلكتروني. الواجهة الأمامية: React مع TypeScript و Hooks و Vite. يتم بناء الواجهة الأمامية وتضمينها في تطبيق الواجهة الخلفية، وتُقدَّم عبر FastAPI على نفس النطاق الخاص بالـ API. يوفر Tailwind CSS و shadcn/ui تنسيق المكونات، ويتولّى عميل أمامي مُنشأ تلقائياً التواصل مع الـ API، بينما يغطي Playwright اختبار الطرف إلى الطرف، مع دعم الوضع الداكن. البريد الإلكتروني: يُستخدم React Email لإنشاء قوالب البريد، ويوفّر Mailpit اختبار البريد محلياً خلال التطوير. النشر والتشغيل: تُوثَّق منصة FastAPI Cloud كخيار للنشر، ويدعم Docker Compose الخدمات المحلية والنشر الذاتي الاستضافة، مع قيام Traefik بدور الوكيل العكسي الموفّر HTTPS تلقائياً. تعتمد الاختبارات على Pytest، ويُبنى CI/CD باستخدام GitHub Actions. ترتبط صفحة README بوثائق منفصلة تغطي الواجهة الخلفية والواجهة الأمامية والتطوير العام ونشر FastAPI Cloud والنشر الذاتي عبر Docker Compose وملاحظات الإصدارات. يُستعمل المشروع عبر زر نسخ المستودع (template button)، وهو مرخّص بموجب ترخيص MIT.