How sandesh339/ums works
This Django-based Utility Management System serves a campus map of geographic assets and lets users register and manage utility complaints. The main user path is map access through utility views and read APIs; authenticated users can submit geolocated complaints, while administrators can mark them resolved. User registration, activation, and password recovery are a separate identity flow. Geographic layers can also be loaded from shapefiles. The source index and excerpts support the server-side links shown; the map JavaScript’s API interactions were not established by the supplied evidence.
Main entry points: utilities/viewset.py Complaint Handling · user/viewset.py Account Workflows · urls.py Utility Routes · models.py Campus Asset Data
Components 18
Identity and Access
- User Routes
user/urls.py - Account Workflows
user/viewset.py - User Serializer
user/serializers.py - User Account
user/models.py
Campus Mapping
- Utility Routes
utilities/urls.py - Map and Asset APIs
utilities/viewset.py - Map Pages
utilities/templates/utilities - Map Client
utilities/static/utilities/js - Geo Serializers
utilities/serializers.py - Campus Asset Data
utilities/models.py
Utility Complaints
- Complaint Handling
utilities/viewset.py - Complaint Records
utilities/models.py
Geospatial Ingestion
- Load Command
utilities/management/commands/uploaddata.py - Shapefile Loader
utilities/load.py
Other components
- Visitor or User
- Administrator
- Email Service
- PostgreSQL Database
Connections 21
- Visitor or User → User Routes: opens account routes
user/urls.py - User Routes → Account Workflows: routes requests
user/urls.py - Account Workflows → User Serializer: validates registration
user/viewset.py - Account Workflows → User Account: reads and saves
user/viewset.py - Account Workflows → Email Service: sends account email
user/viewset.py - Visitor or User → Utility Routes: opens utility pages
utilities/urls.py - Utility Routes → Map and Asset APIs: routes requests
utilities/urls.py - Map and Asset APIs → Map Pages: renders pages
utilities/viewset.py - Map and Asset APIs → Geo Serializers: serializes asset data
utilities/viewset.py - Map and Asset APIs → Campus Asset Data: queries assets
utilities/viewset.py - Visitor or User → Utility Routes: uses map interface
- Administrator → Utility Routes: manages complaints
- Complaint Handling → Complaint Records: creates and updates
utilities/viewset.py - Complaint Handling → Campus Asset Data: checks boundary
utilities/viewset.py - Complaint Handling → Geo Serializers: validates complaint data
utilities/viewset.py - Complaint Handling → Email Service: emails resolution
utilities/viewset.py - Load Command → Shapefile Loader: runs layer imports
utilities/management/commands/uploaddata.py - Shapefile Loader → Campus Asset Data: loads geographic layers
utilities/load.py - Campus Asset Data → PostgreSQL Database: persists geographic records
README.md - Complaint Records → PostgreSQL Database: persists complaints
README.md - User Account → PostgreSQL Database: persists accounts
README.md