02 File Structure

File & Folder Structure

This document outlines the recommended Django project structure for the OUTR Ph.D. platform.

phd_portal/
│
├── phd_portal/             # Django project settings
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── core/                   # Common utilities, base templates, etc.
│   ├── models.py
│   ├── views.py
│   ├── templates/
│   └── static/
│
├── users/                  # User management (students, supervisors, admins)
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/users/
│   └── static/users/
│
├── admissions/             # Admission process, applications, entrance test
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/admissions/
│   └── static/admissions/
│
├── research/               # Progress reports, DSC/DRC, thesis submission
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/research/
│   └── static/research/
│
├── coursework/             # Coursework management
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/coursework/
│   └── static/coursework/
│
├── notifications/          # Email, dashboard alerts, etc.
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── templates/notifications/
│   └── static/notifications/
│
├── templates/              # Project-wide templates (base.html, etc.)
│
├── static/                 # Global static files
│
├── manage.py
│
└── requirements.txt
  • Each app (users, admissions, research, coursework, notifications) contains its own models, views, urls, templates, and static files.
  • core/ holds utilities and shared resources.
  • templates/ and static/ at the root are for global resources.