RuqyaHub
Healing through Qur'an and Sunnah — services, education, and guided support
RuqyaHub
Next.js 15React 19TypeScriptTailwind CSS 4shadcn/uiFastAPIPostgreSQLSQLAlchemyDockeryt-dlp/MeTubeMonnifyPaystack (optional)WhatsApp





Description
RuqyaHub blends e-commerce with service bookings for Islamic spiritual healing. The focus is practical: clear service pages, simple consultations, and frictionless communication via WhatsApp for guidance and confirmations. The frontend uses the Next.js App Router (React 19, TypeScript, Tailwind/shadcn) with strong SEO metadata so services and educational content are discoverable. The backend is FastAPI + PostgreSQL (SQLAlchemy), exposing REST APIs for services, products, articles, podcasts, audio, orders, payments, and uploads. Checkout supports bank transfers with receipt uploads alongside gateway verification (Monnify, optional Paystack), aligning with local payment preferences while maintaining security and traceability.
Key Features
- Services & consultations — clear service pages plus WhatsApp booking dialog: meets users where they already communicate and reduces friction for scheduling.
- Store & checkout — cart, bank transfer with receipt upload, WhatsApp completion: supports local payment habits and gives immediate post-payment guidance.
- Payments — Monnify initialize/verify/complete (optional Paystack): flexible gateways with signed verification and safe redirect/webhook handling.
- Content hub — articles, podcasts, and Ruqya audio ingestion via MeTube/yt-dlp: education builds trust and offers durable, searchable resources.
- Admin dashboard — operational counts and quick actions across services/products/articles/podcasts/audio: gives operators a real pulse on activity.
- SEO & performance — OpenGraph/Twitter metadata, accessible components, responsive UI: improves discovery and mobile experience for a broad audience.
- Infrastructure — Docker Compose for frontend/backend/Postgres/MeTube, health checks and static uploads: reproducible deployments with straightforward ops.
Challenges and Solutions
- YouTube ingestion — reliable audio extraction via MeTube/yt-dlp with cookie management: mitigates throttling and preserves content quality for the audio library.
- Payment verification — Monnify signatures, redirects, and async webhooks: prevents double-booking or inconsistent order states through idempotent handling.
- WhatsApp integration — robust deep links and message formatting: ensures consistent cross-device behavior and readable, pre-filled messages for bookings.
- Data modeling — orders, receipts, services, consultations with clean migrations: keeps schema evolvable while preserving integrity and auditability.
- Security & CORS — safe defaults and environment-driven configuration: hardens production without slowing development workflows.