# srishtikesh2705/cef-2 architecture

> Architecture diagram of the GitHub repository srishtikesh2705/cef-2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/srishtikesh2705/cef-2
- Repository: https://github.com/srishtikesh2705/cef-2

## Overview

This is a Django backend for a campus event finder, with separate users, clubs, events, and registrations apps. The only fully evidenced user workflow is registration: a request reaches the registration view, which validates and saves through a serializer, then returns user data and JWTs. User identity uses a custom email-based model and manager. Settings configure PostgreSQL and JWT authentication. The README is empty, and the sampled project URL configuration exposes only Django admin; relationships among the other domain apps are therefore not asserted.

Main entry points: [`backend/campus_event_finder/users/models.py`](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/models.py) (User model), [`backend/campus_event_finder/campus_event_finder/settings.py`](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/campus_event_finder/settings.py) (Django settings), [`backend/campus_event_finder/users/urls.py`](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/urls.py) (User routes), [`backend/campus_event_finder/users/views.py`](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/views.py) (Registration API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_project_urls["Project routes<br/>[urls.py]"]
  node_user_routes["User routes<br/>[urls.py]"]
end

subgraph group_identity["User identity"]
  node_register["Registration API<br/>[views.py]"]
  node_user_serializers["User serializers<br/>[serializers.py]"]
  node_user_model["User model<br/>[models.py]"]
  node_user_manager["User manager<br/>[managers.py]"]
  node_user_permissions["User permissions<br/>[permissions.py]"]
end

subgraph group_domain["Campus domains"]
  node_clubs["Clubs domain"]
  node_events["Events domain"]
  node_registrations["Event registrations"]
end

subgraph group_platform["Runtime services"]
  node_settings["Django settings<br/>[settings.py]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]
node_django_admin["Django admin"]

node_project_urls -->|"routes admin"| node_django_admin
node_user_routes -->|"routes registration"| node_register
node_register -->|"validates and saves"| node_user_serializers
node_user_serializers -->|"serializes model"| node_user_model
node_user_model -->|"assigns manager"| node_user_manager
node_settings -->|"configures database"| node_postgres
node_settings -->|"sets auth model"| node_user_model
node_client -.->|"requests registration"| node_user_routes

click node_project_urls "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/campus_event_finder/urls.py"
click node_user_routes "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/urls.py"
click node_register "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/views.py"
click node_user_serializers "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/serializers.py"
click node_user_model "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/models.py"
click node_user_manager "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/managers.py"
click node_user_permissions "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/permissions.py"
click node_clubs "https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/clubs"
click node_events "https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/events"
click node_registrations "https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/registrations"
click node_settings "https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/campus_event_finder/settings.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_project_urls,node_user_routes,node_client toneBlue
class node_register,node_user_serializers,node_user_model,node_user_manager,node_user_permissions,node_postgres toneAmber
class node_clubs,node_events,node_registrations toneMint
class node_settings toneRose
class node_django_admin toneIndigo
```

## Components

### HTTP entry

- [Project routes](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/campus_event_finder/urls.py): `backend/campus_event_finder/campus_event_finder/urls.py`
- [User routes](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/urls.py): `backend/campus_event_finder/users/urls.py`

### User identity

- [Registration API](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/views.py): `backend/campus_event_finder/users/views.py`
- [User serializers](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/serializers.py): `backend/campus_event_finder/users/serializers.py`
- [User model](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/models.py): `backend/campus_event_finder/users/models.py`
- [User manager](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/managers.py): `backend/campus_event_finder/users/managers.py`
- [User permissions](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/users/permissions.py): `backend/campus_event_finder/users/permissions.py`

### Campus domains

- [Clubs domain](https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/clubs): `backend/campus_event_finder/clubs`
- [Events domain](https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/events): `backend/campus_event_finder/events`
- [Event registrations](https://github.com/srishtikesh2705/cef-2/tree/main/backend/campus_event_finder/registrations): `backend/campus_event_finder/registrations`

### Runtime services

- [Django settings](https://github.com/srishtikesh2705/cef-2/blob/main/backend/campus_event_finder/campus_event_finder/settings.py): `backend/campus_event_finder/campus_event_finder/settings.py`

### Other components

- **API client**
- **PostgreSQL**
- **Django admin**

## Connections

- Project routes → Django admin: routes admin (evidence: `backend/campus_event_finder/campus_event_finder/urls.py`)
- User routes → Registration API: routes registration (evidence: `backend/campus_event_finder/users/urls.py`)
- Registration API → User serializers: validates and saves (evidence: `backend/campus_event_finder/users/views.py`)
- User serializers → User model: serializes model (evidence: `backend/campus_event_finder/users/serializers.py`)
- User model → User manager: assigns manager (evidence: `backend/campus_event_finder/users/models.py`)
- Django settings → PostgreSQL: configures database (evidence: `backend/campus_event_finder/campus_event_finder/settings.py`)
- Django settings → User model: sets auth model (evidence: `backend/campus_event_finder/campus_event_finder/settings.py`)
- API client → User routes: requests registration
