Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Muhammadbugaje/NAMETS_Website/llms.txt

Use this file to discover all available pages before exploring further.

The NAMETS Website is the official digital platform for the Nigerian Association of Muslim Engineering, Technology, and Science Students — a student organization dedicated to supporting Muslim engineering, technology, and science undergraduates in Nigeria. Built on Django 6.0 with Django REST Framework, the platform serves as a central hub where administrators, committee teams, and students interact with a rich set of features: publishing and managing events, sharing academic resources, broadcasting announcements, displaying prayer schedules, maintaining a photo gallery, and facilitating community activities such as membership and tutor applications. The platform is deployed on Render, uses PostgreSQL (powered by Neon) for persistent data storage, and relies on Cloudinary for scalable media file hosting.

What the Platform Does

NAMETS Website provides a multi-team administration portal and a public-facing website. Staff users are organized into focused teams — Communications, Events, Academics, Community, Gallery, and Lost & Found — each with granular Django permissions. The admin panel is powered by django-unfold, delivering a modern, role-aware sidebar. An internal notifications dashboard tracks real-time activity logs and unread alerts across all teams. A REST API layer, integrated with n8n workflow automation via webhook, enables external systems to interact with the platform programmatically.

Application Modules

The project is composed of the following Django apps, each responsible for a distinct domain:
AppResponsibility
coreSite-wide settings (SiteSettings), global configuration flags
communicationsAnnouncements, prayer schedules, subscribers, donation campaigns
eventsEvent creation, management, and webhook-triggered notifications
academicsCourses, evaluations, results, timetables, Islamiyya registration, tutors
lostfoundLost and found item submissions and listings
communityMembership applications, tutor applications, executives, patrons, Q&A
galleryPhoto gallery albums and images stored on Cloudinary
namets_notificationsInternal notification inbox, activity log, and dashboard
apiDRF-based REST API endpoints for external integrations

Technology Stack

  • Backend: Django 6.0, Django REST Framework 3.16.1
  • Database: PostgreSQL via Neon (production), dj-database-url for URL-based config
  • Media Storage: Cloudinary (django-cloudinary-storage)
  • Static Files: WhiteNoise (whitenoise.middleware.WhiteNoiseMiddleware) with CompressedManifestStaticFilesStorage
  • Admin UI: django-unfold with admin charts
  • Automation: n8n webhook integration for event notifications
  • Deployment: Render (PaaS), Python 3.12

Explore the Docs

Quickstart

Get the platform running locally in minutes with step-by-step setup instructions.

Deployment

Deploy to Render using the included render.yaml with PostgreSQL and Cloudinary.

Events Feature

Manage and publish events with automated n8n webhook notifications.

Academics Feature

Courses, timetables, results, Islamiyya registration, and tutor management.

Communications Feature

Announcements, prayer schedules, subscribers, and donation campaigns.

API Authentication

Authenticate external integrations using the N8N token-based API auth system.

Build docs developers (and LLMs) love