# School Management API Documentation

The School Management API Documentation, defining all functions and their purpose. As well as how to use the API, how to properly call functions and provide the necessary fields. 

### Contents

* [Getting Started](#getting-started)
* [General Functions](#general-functions)
* [Creating Accounts](#creating-accounts)
    * [Creating Administrators](#creating-administrators)
    * [Registering a Teacher](#registering-a-teacher)
    * [Enrolling a Student](#enrolling-a-student)
    * [Additional Info](#additional-information-after-creating-an-account)
* [Log into Accounts](#log-into-accounts)
	* [Logging Into Admin](#logging-into-admin)
	* [Logging Into Teacher](#logging-into-teacher)
	* [Logging Into Student](#logging-into-student)
* [Get Account](#get-account)
	* [Get Admin Account](#get-admin-account)
	* [Get Teacher Account](#get-teacher-account)
	* [Get Student Account](#get-student-account)
* [Updating Account information](#updating-accounts)
	* **Update Student...**
	* [Name](#update-student-name)
	* [Grade Level](#update-student-grade-level)
	* [Homeroom](#update-student-homeroom)
	* [Locker](#update-student-locker)
	* [YOG](#update-student-year-of-graduation)
	* [Password](#update-student-password)
	* [Email](#update-student-email)
	* [Address](#update-student-address)
	* [Photo](#update-student-photo)
    <br></br>
	* **Update Teacher...**
	* [Name](#update-teacher-name)
	* [Homeroom](#update-teacher-homeroom)
	* [Password](#update-teacher-password)
	* [Email](#update-teacher-email)
	* [Address](#update-teacher-address)
	* [Photo](#update-teacher-photo)
	<br></br>
	* **Update Admin...**
	* [Name](#update-admin-name) - **(Coming Soon)**
	* [Password](#update-admin-password) - **(Coming Soon)**
	* [Email](#update-admin-email) - **(Coming Soon)**
	* [Photo](#update-admin-photo) - **(Coming Soon)**

<br>

## Getting Started 

* ### Installation & Deployment
    The API is an all in one package and is simple and easy to deploy. Eliminating any long unforgiving configurations you may face in other software.

    1. Clone the repo
        ```bash
        $ git clone https://github.com/SowinskiBraeden/school-management-api
        $ cd school-management-api
        ```
    
    2. Rename `.env.example` to `.env`
    
    3. Enter desired values into `.env`
        ```bash
        mongoURI='your mongo URI'
        dbo='school'
        secret='your 256 bit secret'
        
        # Suggested port for Production: 80
        # Suggested port for Development: 8000
        PORT='desired port'
        
        # This is to enable the system to send emails
        SYSTEM_EMAIL='your system email'
        SYSTEM_PASSWORD='your system email password'
        ```
    
    4. Run the system in your terminal
        ```bash
        $ go run main.go
        ```
    
    Or...
    
    5. Build and compile the system into an executable
        ```bash
        $ go build
        ```

* ### Initializing the System

    Upon running the system for the first time, you will be prompted to create an admin.
    In order to perform many actions with the API, an Admin account is required. You will be prompted to create your default admin account seen below...
    
    ![init](previews/init.png)
    
    Upon completing the initial setup and creating your default administrator for the system, it is ready to use and this box will appear below, displaying basic system details seen below...
    
    ![running](previews/running.png)
    
<br>

## General Functions

* ### API Status
    **Method:** `GET`
    ```
    <API_URL>/api/v1/status
    ```
    
    **Returns:**
    * Status 200: `OK`
    * JSON: 
        ```jsonc
        {
            "success": true,
            "message": "the API is active"
        }
        ```

<br>
  
## Creating Accounts

There are several account that can be registered into the system. As you may guess they are Administrators, Teachers and Students.

<br>

+ ### Creating Administrators
    You can create Administrates- who will have permissions to perform majority of the actions in the API. It is common that there are more than one Administrator to help manage the system.

    **Method:** `POST`
    ```
    <API_URL>/admin/create
    ```
    
    **Required:**
    + Logged into an existing Admin account
    + JSON:
        ```jsonc
        {
            "firstname": "John",
            "lastname": "Doe",
            "dob": "01-01-1999",
            "email": "john_doe@example.com"
        }
        ```
    
    **Returns:**
    + Status 200: `OK`
    + JSON:
        ```jsonc
        {
            "success": true,
            "message": "successfully inserted admin"
        }
        ```
    
    <br>
    
+ ### Registering a Teacher
    Obviously a school management system will require teachers to manage and teach students. Teachers have an important role for the system.

    **Method:** `POST`
    ```
    <API_URL>/teacher/register
    ```
    
    **Required:**
    + Logged into an existing Admin account
    + JSON:
        ```jsonc
        {
            "firstname": "Homer",
            "middlename": "Jay",
            "lastname": "Simson",
            "dob": "12-05-1956",
            "email": "homerdog_simpson@example.com"
        }
        ```
    
    **Returns:**
    + Status 200: `OK`
    + JSON:
        ```jsonc
        {
            "success": true,
            "message": "successfully inserted teacher"
        }
        ```
        
+ ### Enrolling a Student
    What is a school without students? A professional day, but not the point. Students when their application to the school has been accepted by an admin can be enrolled into the school.

    **Method:** `POST`
    ```
    <API_URL>/student/enroll
    ```
    
    **Required:**
    + Logged into an existing Admin account
    + JSON:
        ```jsonc
        {
            "firstname": "Bart",
            "middlename": "JoJo",
            "lastname": "Simpson",
            "age": 10,
            "gradelevel": 4,
            "dob": "17-12-1979",
            "province": "...",
            "city": "Springfield",
            "address": "742 Evergreen Terrace",
            "postal": "..."
        }
        ```
        
    **Returns:**
    + Status 200: `OK`
    + JSON:
        ```jsonc
        {
            "success": true,
            "successfully inserted student"
        }
        ```
        
+ ### Additional Information After creating an account
    1. After successfully creating an account for another admin, teacher or student. A school email will be generated for them using their first and last name, each formatted differently based on the type of account.

    2. All users are given a random ID used to sign into the system. Each ID is a random 6 digit number.
    
    3. Students are given a random PEN (Personal Education Number). A random 12 digit number.
    
    4. Accounts are given a default profile image. This can be updated in the future.
    
    **(Coming Soon)**
    5. All new users, once have verified their email, will receive and email containing their ID.
    
    **(Currently No verified email required)**
    6. All new users, once have verified their email, will receive and email containing their temporary password.

<br>

## Log Into Accounts

+ ### Logging into Admin
	**Method:** `POST`
	```
	<API_URL>/admin/login
	```

	**Required:**
	* JSON:
		```jsonc
		{
			"tid": "123456",
			"password": "myawesomepassword123"
		}
		```
		
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```
		{
			"success": true,
			"message": "correct password"
		}
		```

<br>

+ ### Logging into Teacher
	**Method:** `POST`
	```
	<API_URL>/teacher/login
	```

	**Required:**
	* JSON:
		```jsonc
		{
			"tid": "123456",
			"password": "myawesomepassword123"
		}
		```
		
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "correct password"
		}
		```

<br>

+ ### Logging into Student
	**Method:** `POST`
	```
	<API_URL>/student/login
	```

	**Required:**
	* JSON:
		```jsonc
		{
			"sid": "123456",
			"password": "myawesomepassword123"
		}
		```
		
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "correct password"
		}
		```

<br>

## Get Account

+ ### Get Admin Account
	**Method:** `GET`
	```
	<API_URL>/admin
	```

	**Required:**
	* Logged into an admin account
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully logged into admin",
			"admin:" <admin object>
		}
		```

<br>

+ ### Get Teacher Account
	**Method:** `GET`
	```
	<API_URL>/teacher
	```

	**Required:**
	* Logged into an teacher account
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully logged into teacher",
			"teacher:" <teacher object>
		}
		```

<br>

+ ### Get Student Account
	 **Method:** `GET`
	```
	<API_URL>/student
	```

	**Required:**
	* Logged into an admin account
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully logged into teacher",
			"student:" <student object>
		}
		```

<br>

## Updating Account Information

+ ### Update Student Name
    **Method:** `POST`
	```
	<API_URL>/student/updateName
	```

	**Required:**
	* Logged into an admin account
    * JSON:
        ```jsonc
        {
            "sid": "123456",
            "firstname": "Lisa",
            "middlename": "Marie", // (OPTIONAL)
            "lastname": "Simpson"
        }
        ```

	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Grade Level
    **Method:** `POST`
	```
	<API_URL>/student/updateGradeLevel
	```

	**Required:**
	* Logged into an admin account
	* JSON":
	    ```jsonc
	    {
	        "sid": "123456",
	        "gradelevel": 11
	    }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Homeroom
    **Method:** `POST`
	```
	<API_URL>/student/updateHomeroom
	```

	**Required:**
	* Logged into an admin account
    * JSON:
        ```jsonc
        {
            "sid": "123456",
            "homeroom": "A123"
        }
        ```

	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Locker
    **Method:** `POST`
	```
	<API_URL>/student/updateLocker
	```

	**Required:**
	* Logged into an admin account
	* JSON:
	    ```jsonc
	    {
	        "sid": "123456",
	        "lockernumber": "B123"
	    }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Year of Graduation
    **Method:** `POST`
	```
	<API_URL>/student/updateYOG
	```

	**Required:**
	* Logged into an admin account
	* JSON:
	    ```jsonc
	    {
	        "sid": "123456",
	        "yog": 2020
	    }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Password
    **Method:** `POST`
	```
	<API_URL>/student/updatePassword
	```

	**Required:**
	* Logged into students account
	* JSON:
		```jsonc
		{
			"password": "myOldPassword",
			"newpassword1": "myNewPassword",
			"newpassword2": "myNewPassword"
		}
		```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student password"
		}
		```
	* Emails student an alert of password change

<br></br>

+ ### Update Student Email
    **Method:** `POST`
	```
	<API_URL>/student/updateEmail
	```

	**Required:**
	* Logged into an admin account
	__or__
	* Logged into students account
	* JSON:
		```jsonc
		{
			"sid": "123456", // (Only required if signed in as admin)
			"email": "BartSimpsonsCoolEmail@example.com"
		}
		```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated"
		}
		```

<br></br>

+ ### Update Student Address
    **Method:** `POST`
	```
	<API_URL>/student/updateAddress
	```

	**Required:**
	* Logged into an admin account
	* JSON:
	    ```jsonc
	   {
	       "sid": "123456",
	       "address": "742 Evergreen Terrace",
	       "city": "Springfield",
	       "province": "...",
	       "postal": "..."
	   }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student"
		}
		```

<br></br>

+ ### Update Student Photo
    **Method:** `POST`
	```
	<API_URL>/student/updatePhoto
	```

	**Required:**
	* Logged into an admin account
    * Form Submission:
        ```
            sid: "123456"
            image: newStudentPhoto.png
        ```

	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated student photo"
		}
		```

<br></br>

+ ### Update Teacher Name
    **Method:** `POST`
	```
	<API_URL>/teacher/updateName
	```

	**Required:**
	* Logged into an admin account
    * JSON:
        ```jsonc
        {
            "tid": "123456",
            "firstname": "Marjorie",
            "middlename": "Jacqueline", // (Optional)
            "lastname": "Simpson"
        }
        ```

	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated teacher"
		}
		```

<br></br>

+ ### Update Teacher Homeroom
    **Method:** `POST`
	```
	<API_URL>/teacher/updateHomeroom
	```

	**Required:**
	* Logged into an admin account
	* JSON:
	    ```
	    {
	        "tid": "123456",
	        "homeroom": "A123"
	    }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated teacher"
		}
		```

<br></br>

+ ### Update Teacher Password
    **Method:** `POST`
	```
	<API_URL>/teacher/updatePassword
	```

	**Required:**
	* Logged into teacher account
	* JSON:
	    ```jsonc
	        {
	            "password": "myOldPassword",
	            "newpassword1": "myNewPassword",
	            "newpassword2": "myNewPassword"
	        }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated teacher password"
		}
		```
	* Emails teacher an alert of password change

<br></br>

+ ### Update Teacher Email
    **Method:** `POST`
	```
	<API_URL>/teacher/updateEmail
	```

	**Required:**
	* Logged into an admin account
	**or**
    * Logged into teachers account
    * JSON:
        ```jsonc
        {
            "tid": "123456", // (Only required if igned in as admin)
            "email": "MargeSimpson@example.com"
        }
        ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated teacher"
		}
		```

<br></br>

+ ### Update Teacher Address
    **Method:** `POST`
	```
	<API_URL>/teacher/updateAddress
	```

	**Required:**
	* Logged into an admin account
	* JSON:
	    ```jsonc
	    {
	        "tid": "123456",
	        "address": "742 Evergreen Terrace",
	        "city": "Springfield",
	        "province": "...",
	        "postal": "..."
	    }
	    ```
	
	**Returns:**
	* Status 200: `OK`
	* JSON:
		```jsonc
		{
			"success": true,
			"message": "successfully updated teacher"
		}
		```

<br></br>

+ ### Update Teacher Photo
    **Method:** `POST`
    ```
    <API_URL>/teacher/updatePhoto
    ```

    **Required:**
    * Logged into an admin
    * Form Submission:
        ```
            tid: "123456"
            image: newTeacherPhoto.png
        ```
        
    **Returns:**
    * Status 200: `OK`
    * JSON:
        ```jsonc
        {
            "success": true,
            "message": "successfully updated teacher photo"
        }
        ```

<br></br>

+ ### Update Admin Name
    **Coming Soon...**

<br></br>

+ ### Update Admin Password
    **Coming Soon...**

<br></br>

+ ### Update Admin Email
    **Coming Soon...**

<br></br>

+ ### Update Admin Photo
    **Coming Soon...**

<br></br>