From 294252dfcdeb715a1109f346f887ebd399660ead Mon Sep 17 00:00:00 2001 From: iggybiggy <i.kepka@student.utwente.nl> Date: Sun, 25 Feb 2024 15:15:03 -0600 Subject: [PATCH] Finished README.md for the entire project, as well as, the components. Pruned a bit of code there and there. --- MySU/README.md | 6 ++++++ apps/MySU/README.md | 50 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+) diff --git a/MySU/README.md b/MySU/README.md index e69de29..ec3f111 100644 --- a/MySU/README.md +++ b/MySU/README.md @@ -0,0 +1,6 @@ +# This file provides information about the most imperative files, and the file structure of this Django project. + +## While there is a lot of various folders and classes, the one that are important are: +- router **[Class]** - responsible for handling the URLs of the application via django framework. +- settings **[Folder]** - contains different configuration files for the project. +- urls **[Class]** - contains URL configuration for the project. diff --git a/apps/MySU/README.md b/apps/MySU/README.md index e69de29..f763528 100644 --- a/apps/MySU/README.md +++ b/apps/MySU/README.md @@ -0,0 +1,50 @@ +## This file provides information about the most imperative files, and the file structure of the API. + +### This app is divided into following components: +- admin **[Folder]** - contains configurations related to the Django Admin interface. +- fixtures **[Folder]** - contains predefined data that populates Django Database. +- migrations **[Folder]** - contains changes to the APIs database scheme. +- mixins **[Folder]** - contains classes and utilities that provide reusable functionality for views/viewsets and serializers within API. +- models **[Folder]** - contains classes that define the data models representing the structure of the application's database tables. +- serializers **[Folder]** - contains classes that define how data models are converted to and from JSON/XML types. +- views **[Folder]** - contains classes responsible for processing incoming HTTP requests and returning HTTP responses. +- viewsets **[Folder]** - viewsets are more versatile (and commonly used here) classes that serve the same purpose as views. +- apps **[Class]** - used to set the name for the application. +- urls **[Class]** - contains custom URL configuration that links the app to the base django project. + +### The API processes following data: +- **matchings** +- **events** +- **event_types** +- **enrollments** +- **enrollment_options** +- **users** +- **profiles** +- **institutions** +- **studyrecords** +- **studies** +- **associations** +- **association_data** +- **association_data_fields** +- **notifications** +- **memberships** +- **membertypes** +- **modules** +- **news** +- **groups** +- **group_memberships** +- **emails** +- **debt_collections** +- **invoices** +- **sepa_mandates** + +# In general the most imperative components of this app are: Models, Serializers and Viewsets. + +## **Viewsets** +### Are responsible for the logic of the backend and the frontend. + +## Models +### Allow to change the data models within the Django Database. + +## Serializers +### Allow to parse the incoming and outgoing HTTP traffic into JSON datatype. -- GitLab