Parktimes populated

This reverts commit 97dc792773.

CMakeLists.txt

@@ -1,3 +1,5 @@
+
+
 cmake_minimum_required(VERSION 3.10)
 project(park)
 
@@ -49,3 +51,4 @@ elseif (MSYS OR MINGW)
         libsodium
         )
 endif()
+

Customer.cpp

@@ -2,12 +2,13 @@
 
 
 // constructors
-Customer::Customer(string name_, string password_, Vehicle_type vehicle_, string telephone_)
+Customer::Customer(string name_, string password_, Vehicle_type vehicle_, string telephone_, int role_)
     : id{auto_increment_db() + 1},
       name{name_},
       password{hash_password(password_)},
       vehicle{vehicle_},
-      telephone{telephone_} {
+      telephone{telephone_},
+      role{role_} {
     save_db();
 }
 
@@ -54,8 +55,9 @@ int Customer::parked_at() { return park_instances[park_instances.size() - 1].spo
 // functions that interact with the database
 
 void Customer::save_db() {
-    string statement{"insert into Customer values (, '', '', ,'');"};
+    string statement{"insert into Customer values (, '', '', ,'', );"};
     // after ( = 28)
+    statement.insert(43, to_string(role));
     statement.insert(41, telephone);
     statement.insert(38, to_string(int(vehicle)));
     statement.insert(36, password);
@@ -70,8 +72,9 @@ void Customer::save_db() {
 void Customer::update_db() {
     string statement =
         "UPDATE Customer SET name = '', password = '', "
-        "vehicle = '', telephone = '' where id = '';";
-    statement.insert(87, to_string(id));
+        "vehicle = '', telephone = '', role = '' where id = '';";
+    statement.insert(98, to_string(id));
+    statement.insert(84, to_string(role));
     statement.insert(73, telephone);
     statement.insert(57, to_string(int(vehicle)));
     statement.insert(43, password);

Interface.cpp

@@ -6,42 +6,46 @@
 // cin.ignore(10000, '\n');
 // so it skips to the next newline, in essence clearing the cin buffer
 
-void interface(vector<Park_spot>& spots) {
-    int selector;
-    cout << "\nHello and welcome to the parking spot! Please select a suitable "
-            "option:";
-    cout << "\n[1]Log in as member";
-    cout << "\n[2]Log in as administrator";
-    cin >> selector;
-    cin.ignore(10000, '\n');
-    switch (selector) {
-    case 1: {
-        interface_member(spots);
-        break;
-    }
-    case 2: {
-        interface_admin(spots);
-        break;
-    }
-    }
-}
+bool verify(void);
 
-void interface_member(vector<Park_spot>& spots) {
+void interface(vector<Park_spot>& spots) {
+    /*
+    string introduction = "P A R K M A N N E"; //logo animation, disable during testing
+    text_animation(introduction, 50);
+    */
+   __label__ exit;
+    cout << "\nWelcome to the parking system. Please login...";
     int id;
     string password;
-    cout << "\nPlease input id:";
+    cout << "\nEnter your id: ";
     cin >> id;
     cin.ignore(10000, '\n');
     Customer c = query_customer_with_id(id);
-    cout << "\nPlease input password:";
+    cout << "\nEnter your password: ";
     std::getline(cin, password);
+    
     while (!(verify_password(c.password, password))) {
-        cout << "ERROR: wrong password. Please retype your password:\n";
+        cout << "ERROR: wrong password. Please retype your password or type [x] to exit:\n";
         std::getline(cin, password);
+        if(password=="x")goto exit;
+    }
+    if (query_role_customer(id) == 1) {
+        interface_admin(spots);
+    } else if (query_role_customer(id) == 0) {
+        interface_member(spots, c);
+    } else {
+        cout << "ERROR ROLE_INVALID!";
+    }
+    exit:;
 }
 
-    cout << "Logged in succesfully\n";
-    cout << "select an option\n [1] Parking options\n[2]monthy report\n";
+void interface_member(vector<Park_spot>& spots, Customer& c) {
+    __label__ begin, exit;
+    cout << "\nLogged in succesfully!\n";
+    
+    begin:
+    cout <<"Hello! "<<c.name<< ", please select an option:\n[1]Parking\n[2]Monthly report\n"
+    "[3]Edit information\n[4]Exit\n";
     int option;
     cin >> option;
     cin.ignore(10000, '\n');
@@ -55,94 +59,163 @@ void interface_member(vector<Park_spot>& spots) {
         break;
     }
 
+    case 3: {
+        cout << "Has not been implemented yet\n";
+        break;
+    }
+
+    case 4: {
+        cout << "Exiting...\n";
+        goto exit;
+        break;
+    }
+
     default:
         break;
     }
+    goto begin;
+    exit:;
 }
 
 void interface_admin(vector<Park_spot>& spots) {
-    cout << "Welcome to the admin interface. It is not completely ready yet.\n";
-    cout << "[1] See monthly report of ALL parking spots\n";
-    cout << "[2] See weekly report of ALL parking spots\n";
-    cout << "[3] See monthly report of a specific parking spot\n";
-    cout << "[4] See weekly report of a specific parking spot\n";
-    cout << "[5] See current status of parking spots\n";
-    cout << "[6] Make new customer\n";
-    cout << "[7] Make new parking spot\n";
-    cout << "option[1-7]:";
+    __label__ begin,exit;
+    begin:
+    cout << "\nWelcome to the admin interface\n";
+    cout << "\n[1] Reports & analytics";
+    cout << "\n[2] Parking spots";
+    cout << "\n[3] Make new user";
+    cout << "\n[4] Exit";
+    cout << "\nEnter option number: ";
     int option;
     cin >> option;
     cin.ignore(10000, '\n');
     switch (option) {
     case 1: {
-        reports_from_allparkspots();
+        cout << "[1] See monthly report of ALL parking spots\n";
+        cout << "[2] See weekly report of ALL parking spots\n";
+        cout << "[3] See monthly report of a specific parking spot\n";
+        cout << "[4] See weekly report of a specific parking spot\n";
+        cout << "[5] Return\n";
+        cout << "Enter option number: ";
+        int option_1;
+        cin >> option_1;
+        cin.ignore(10000, '\n');
+        switch (option_1) {
+        case 1: {
+            report_all_spots();
             break;
         }
         case 2: {
-        reports_from_allparkspots(true);
+            report_all_spots(true);
             break;
         }
         case 3: {
-        cout << "Which parking spot would you like a report on?ID:";
-        int spotid;
-        cin >> spotid;
-        cin.ignore(10000, '\n');
-        reports_from_parkspot(spotid);
+            report_single_spot();
             break;
         }
         case 4: {
-        cout << "Which parking spot would you like a report on?ID:";
-        int spotid;
-        cin >> spotid;
-        cin.ignore(10000, '\n');
-        reports_from_parkspot(spotid, true);
+            report_single_spot(true);
             break;
         }
         case 5:{
+            goto begin;
+            break;
+        }
+        break;
+        }
+    }
+    case 2: {
+        cout << "[1] See current status of parking spots\n";
+        cout << "[2] Make new parking spot\n";
+        cout << "[3] Return\n";
+        cout << "Enter option number: ";
+        int option_2;
+        cin >> option_2;
+        cin.ignore(10000, '\n');
+        switch (option_2) {
+        case 1: {
             current_status_parkspots(spots);
             break;
         }
-    case 6: {
+        case 2: {
+            new_parkspot(spots);
+            break;
+        }
+        case 3:{
+            goto begin;
+            break;
+        }
+        default:
+            break;
+        }
+        break;
+    }
+    case 3: {
+        cout << "[1] Make new customer\n";
+        cout << "[2] Make new admin\n";
+        cout << "[3] Return\n";
+        cout << "Enter option number: ";
+        int option_3;
+        cin >> option_3;
+        cin.ignore(10000, '\n');
+        switch (option_3) {
+        case 1: {
             new_customer();
             break;
         }
-    case 7: {
-        new_parkspot(spots);
+        case 2: {
+            new_admin();
+            break;
+        }
+        case 3:{
+            goto begin;
+            break;
+        }
+        default:
+            break;
+        }
+        case 4: {goto exit;break;}
         break;
     }
 
     default:
         break;
     }
+    goto begin;
+    exit:;
 }
 
 // --------- individual things.
 
 void park(Customer& c, vector<Park_spot>& spots) {
-    cout << "You have selected parking option";
+    __label__ exit;
+    cout << "You have selected parking option.\n";
     if (!(c.parked())) {
-        cout << "The following spots[which can fit your vehicle] are "
-                "available: ";
+        cout << "The following spots fit your vehicle and are available: \n";
         for (Park_spot i : spots) {
-            if (i.v_type == c.vehicle) {
+            if ((i.v_type == c.vehicle)&(i.taken==false)) {
                 cout << i.id << ", ";
             }
         }
 
-        cout << "where do you want to park?";
-        int parkid;
-        cin >> parkid;
+        cout << "\nWhere do you want to park? Or type [0] to exit.";
+        int parkID;
+        cin >> parkID;
+        if (!parkID)goto exit;
         cin.ignore(10000, '\n');
         for (Park_spot& i : spots) {
-            if (i.id == parkid) {
+            if (i.id == parkID) {
+                if (verify())
+                {
                 i.clock(c);
-                cout << "You have parked sucessfully";
+                cout << "You have parked sucessfully!";
+                }
             }
         }
 
     } else {
         cout << "You are parked at spot " << c.parked_at()
-             << ", do you want to clock out?\n enter [1] for yes and [0] for no";
+             << ", do you want to clock out?\n[1] Yes\n[2] No";
         int answer = 0;
         cin >> answer;
         cin.ignore(10000, '\n');
@@ -150,9 +223,10 @@ void park(Customer& c, vector<Park_spot>& spots) {
             query_parkspot_with_id(c.parked_at(), spots).clock(c);
             cout << "You have sucessfully clocked out.";
         } else {
-            cout << "OK, have a nice day";
+            cout << "OK, have a nice day."; // exit to customer login
         }
     }
+    exit:;
 }
 
 void new_customer() {
@@ -160,26 +234,138 @@ void new_customer() {
     string name;
     string password;
     string telephone;
-    cout << "What's the name of the customer? ";
+    int role = 0;
+    cout << "\nWhat's the name of the customer? ";
     std::getline(cin, name);
-    cout << "What's the vehicle type? [1]twoweeler, [2] fourweeler: ";
+    cout << "\nWhat's the vehicle type? \n[1]Twowheeler\n[2] Fourwheeler\n";
     cin >> vtype;
     cin.ignore(10000, '\n');
-    cout << "What's the telephone number? ";
+    cout << "What's the telephone number? +";
     std::getline(cin, telephone);
-    cout << "What's the password?";
+    cout << "\nWhat's the password? ";
     std::getline(cin, password);
-    Customer newcustomer{name, password, Vehicle_type(vtype), telephone};
-    cout << "New customer sucessfully created\n";
-    newcustomer.update_db();
+    Customer newcustomer{name, password, Vehicle_type(vtype), telephone, role};
+    cout << "\nNew customer sucessfully created\n";
+    if (verify())newcustomer.update_db();
+}
+
+void new_admin() {
+    int vtype = 2; // revision required! Needs to be set to NULL
+    string name;
+    string password;
+    string telephone;
+    int role = 1;
+    cout << "\nWhat's the name of the admin? ";
+    std::getline(cin, name);
+    cout << "\nWhat's the telephone number? +";
+    std::getline(cin, telephone);
+    cout << "\nWhat's the password?";
+    std::getline(cin, password);
+    Customer newcustomer{name, password, Vehicle_type(vtype), telephone, role};
+    cout << "\nNew customer sucessfully created\n";
+    if(verify())newcustomer.update_db();
 }
 
 void new_parkspot(vector<Park_spot>& spots) {
-    cout << "What type of parking spot? [1] twoweeler, [2] fourweeler: ";
+    cout << "What type of parking spot? \n[1] Twowheeler\n[2] Fourwheeler\n";
     int vtype;
     cin >> vtype;
     cin.ignore(10000, '\n');
     Park_spot newspot{Vehicle_type(vtype)};
-    spots.push_back(newspot);
-    cout << "new parking spot sucessfully created.\n";
+    if(verify()){spots.push_back(newspot);
+    cout << "New parking spot sucessfully created.\n";}
+}
+
+// time stuff-----------------------------------------------------
+
+pair<int, int> create_month_period() {
+    std::time_t t = std::time(0);
+    std::tm* date = std::localtime(&t);
+    int month, year = 0;
+    cout << "Which month do you want a report on?[6 2018 for June 2018]\n";
+    cin >> month >> year;
+    date->tm_year = year - 1900;
+    date->tm_mday = 1;
+    date->tm_mon = month - 1;
+    pair<int, int> period;
+    period.first = mktime(date);
+    date->tm_mon = month;
+    period.second = mktime(date);
+    return period;
+}
+
+pair<int, int> create_week_period() {
+    std::time_t t = std::time(0);
+    std::tm* date = std::localtime(&t);
+    int day, month, year = 0;
+    cout << "Which month do you want a report on?[ 20 6 2018 for June 20th, 2018]\n";
+    cin >> day >> month >> year;
+    date->tm_year = year - 1900;
+    date->tm_mday = day;
+    date->tm_mon = month - 1;
+    date->tm_hour = 0;
+    date->tm_min = 0;
+    pair<int, int> period;
+    period.first = mktime(date);
+    period.second = period.first + 604800; // plus 7 days in seconds.
+    return period;
+}
+
+// ------------------------------ report stuff
+
+void report_all_spots(bool weekly) {
+    pair<int, int> period;
+    if (weekly) {
+        period = create_week_period(); // remove the pair<int, int>
+    } else {
+        period = create_month_period(); // ^
+    }
+
+    cout << "working timeperiods: " << period.first << ", " << period.second; // DEBUG
+
+    reports_from_allparkspots(period); // TODO: namechange of reports_from_allparkspots in  query?
+}
+
+void report_single_spot(bool weekly) {
+    cout << "Which parking spot would you like a report on?\n";
+    cout << "Parking spot ID: ";
+    int spotID;
+    cin >> spotID;
+    cin.ignore(10000, '\n');
+    pair<int, int> period;
+    if (weekly) {
+        period = create_week_period(); // remove the pair<int, int>
+    } else {
+         period = create_month_period();
+    }
+    reports_from_parkspot(spotID, period);
+}
+
+void report_customer(int customerID, bool weekly) {
+    // use report_customer(0) to make interactive
+    // so admin can call the interactive version, but customer can only call
+    // report_customer(own_cid)
+    if (!customerID) {
+        cout << "What customer do you want a report on? ID: ";
+        cin >> customerID;
+    }
+    pair<int, int> period;
+    if (weekly) {
+        pair<int, int> period = create_week_period();
+    } else {
+        pair<int, int> period = create_month_period();
+    }
+    reports_from_customer(customerID, period);
+}
+
+bool verify(void)
+{
+string ver;
+std::cout<<"\nAre you sure you want to commit these actions?"
+	"\n[No] Revert."
+	"\n[Yes] Commit.";
+std::cin>>ver;
+if (ver=="YES"|ver=="Yes"|ver=="yes") return true;
+else return false;
+
 }

Park_time.cpp

@@ -122,3 +122,12 @@ cpp/header
  */
     std::this_thread::sleep_for(seconds{sec});
 }
+
+// text animtion duh
+void text_animation(const string& text, unsigned int pause_time) {
+    for (const char m : text) // range loop; for each character in string
+    {
+        cout << m << flush;
+        sleep_for(milliseconds(pause_time));
+    }
+}

Query.cpp

@@ -65,15 +65,23 @@ Customer query_customer_with_id(int id) {
         string telephone = query.getColumn(4);
         vector<Park_time> park_instances = query_parktimes_for_customer(id);
         Customer result{id, name, password, Vehicle_type(vehicle), park_instances, telephone};
-        // DEBUG
-        // cout << "{" << result.id << "," <<result.password <<"," <<
-        // int(vehicle) << "}\n";
         return result;
     }
 }
 
+int query_role_customer(int id) {
+    SQLite::Statement query(data::db, "SELECT * FROM Customer WHERE id = ?;");
+    query.bind(1, id);
+    while (query.executeStep()) {
+        int role = query.getColumn(5);
+        return role;
+    }
+}
+
 //------------------------------- parkspot info
 
+// -- parkspots info, report gen
+
 Park_spot query_parkspot_with_id(int id, vector<Park_spot>& parkspots) {
     for (Park_spot& i : parkspots) {
         if (i.id == id) {
@@ -82,22 +90,13 @@ Park_spot query_parkspot_with_id(int id, vector<Park_spot>& parkspots) {
     }
 }
 
-void reports_from_parkspot(int spotid, bool weekly) {
-    std::time_t t = std::time(0); // get time now
-    std::tm* now = std::localtime(&t);
-
-    if (weekly) {
-        now->tm_wday = 1;
-    } else {
-        now->tm_mday = 1;
-    }
-
-    int s_since_epoch = mktime(now);
-
+void reports_from_parkspot(int spotid, pair<int, int> period) {
     vector<Park_time> park_times;
-    SQLite::Statement query(data::db, "SELECT * FROM Park_time WHERE spot_id = ? AND start > ?;");
+    SQLite::Statement query(data::db,
+                            "SELECT * FROM Park_time WHERE spot_id = ? AND start > ? AND end < ?;");
     query.bind(1, spotid);
-    query.bind(2, s_since_epoch);
+    query.bind(2, period.first);
+    query.bind(3, period.second);
     while (query.executeStep()) {
         int id = query.getColumn(0);
         int cid = query.getColumn(1);
@@ -113,20 +112,12 @@ void reports_from_parkspot(int spotid, bool weekly) {
     }
 }
 
-void reports_from_allparkspots(bool weekly) {
-    std::time_t t = std::time(0); // get time now
-    std::tm* now = std::localtime(&t);
-    if (weekly) {
-        now->tm_wday = 1;
-    } else {
-        now->tm_mday = 1;
-    }
-
-    int s_since_epoch = mktime(now);
-
+void reports_from_allparkspots(pair<int, int> period) {
     vector<Park_time> park_times;
-    SQLite::Statement query(data::db, "SELECT * FROM Park_time WHERE start > ?;");
-    query.bind(1, s_since_epoch);
+    SQLite::Statement query(data::db, "SELECT * FROM Park_time WHERE start > ? AND end < ?;");
+    query.bind(1, period.first);
+    query.bind(2, period.second);
+
     while (query.executeStep()) {
         int id = query.getColumn(0);
         int cid = query.getColumn(1);
@@ -154,19 +145,25 @@ void current_status_parkspots(vector<Park_spot>& spots) {
     }
 }
 
-// -------------- paroking spots
+vector<Park_time> reports_from_customer(int cid, pair<int, int> period) {
+    vector<Park_time> park_times;
+    SQLite::Statement query(
+        data::db, "SELECT * FROM Park_time WHERE customer_id = ? AND start > ? AND end < ?;");
+    query.bind(1, cid);
+    query.bind(2, period.first);
+    query.bind(3, period.second);
+    while (query.executeStep()) {
+        int id = query.getColumn(0);
+        int spotid = query.getColumn(2);
+        int start = query.getColumn(3);
+        int duration = query.getColumn(5);
+        Park_time result{id, cid, spotid, start, duration};
+        park_times.push_back(result);
+    }
+    query.reset();
 
-// vector<Park_spot> populate_spots(){
-//         vector<Park_spot> spots;
-//     SQLite::Statement query(data::db, "SELECT * FROM Park_spot WHERE id >
-//     0;");
-//     // query.bind(1, 2);
-//     while (query.executeStep()) {
-//         int id = query.getColumn(0);
-//         int taken = query.getColumn(1);
-//         int cid = query.getColumn(2);
-//         // park_customers.push_back(query_customer_with_id(cid));
-//         spots.push_back({id, taken, cid});
-//     }
-//     return spots;
-// }
+    for (auto i : park_times) {
+        cout << i;
+    }
+    return park_times;
+}

data.cpp

@@ -13,7 +13,9 @@ SQLite::Database start_db() {
         This shouldn't be here, really, but I can't think of a better place
         where it runs at least once. This seeds the random generator needed for
         salts and other stuff, and needs to be run at least once when working
-        with any libsodium function.
+        with any libsodium function. And since this definitely needs to be run at least once, why
+        not include it here? you can't (well, shouldn't be able to) login into anything if this
+        doesn't run, since you need to compare passwords to login
          */
     }
     db.exec(

headers/Customer.h

@@ -40,7 +40,8 @@ class Customer {
     string password;
     Vehicle_type vehicle;
     string telephone;
-    Customer(string name_, string password_, Vehicle_type vehicle_, string telephone_);
+    int role;
+    Customer(string name_, string password_, Vehicle_type vehicle_, string telephone_, int role);
     Customer(int id_, string name_, string password_, Vehicle_type vehicle_,
              vector<Park_time> instances, string telephone_);
     void clock_in(int s_id);

headers/Interface.h

@@ -1,13 +1,19 @@
-
-
 #include "Query.h"
 
-
 using std::cin;
 
 void interface(vector<Park_spot>& spots);
-void interface_member(vector<Park_spot>& spots);
+void interface_member(vector<Park_spot>& spots, Customer& c);
 void interface_admin(vector<Park_spot>& spots);
 void park(Customer& c, vector<Park_spot>& spots);
 void new_customer();
+void new_admin();
 void new_parkspot(vector<Park_spot>& spots);
+
+// time creation
+pair<int, int> create_month_period();
+pair<int, int> create_week_period();
+
+// report stuff
+void report_single_spot(bool weekly = false);
+void report_all_spots(bool weekly = false);

headers/Park_time.h

@@ -12,8 +12,11 @@
 
 using namespace std::chrono;
 using std::cout;
+using std::flush;
 using std::string;
 using std::to_string;
+using std::chrono::milliseconds;
+using std::this_thread::sleep_for;
 /*
 
 
@@ -64,7 +67,10 @@ class Park_time {
     int start_to_int();      // helper
 };
 
-// test funciton
+// test function
 void Wait(int sec);
 
+// function that slowly outputs each character one by one
+void text_animation(const string& text, unsigned int pause_time);
+
 #endif // Park_time

headers/Query.h

@@ -3,6 +3,7 @@
 #pragma once
 
 #include "Park_spot.h"
+using std::pair;
 
 /*these are the functions that search the database and create objects from it.
 
@@ -52,16 +53,16 @@ furhter.
  */
 
 vector<Park_time> query_parktimes_for_customer(int cid);
-
 vector<Customer> query_customer_with_name(string name);
 Customer query_customer_with_id(int id);
+Park_spot query_parkspot_with_id(int id, vector<Park_spot>& parkspots);
+int query_role_customer(int id);
 
 vector<Park_spot> populate_spots();
 
-Park_spot query_parkspot_with_id(int id, vector<Park_spot>& parkspots);
-
-void reports_from_parkspot(int spotid, bool weekly = false);
-void reports_from_allparkspots(bool weekly = false);
-
+void reports_from_parkspot(int spotid, pair<int, int> period);
+void reports_from_allparkspots(pair<int, int> period);
 void current_status_parkspots(vector<Park_spot>& spots);
+vector<Park_time> reports_from_customer(int cid, pair<int, int> period);
+
 #endif // CUSTOMER_H

main.cpp

@@ -1,5 +1,6 @@
 #include "headers/Interface.h"
 
+
 /*
 Code structure is like this:
 1. encrypt.cpp en /header/encrypt.h contain functions to hash passwords and
@@ -44,18 +45,18 @@ static vector<Park_spot> parking_spots = populate_spots();
 static vector<Customer> park_customers;
 
 int main() {
-    // state of db:
-    // er zijn 10 parkspots, 5 met biketype en 5 met pickup type
-    // er is een customer met id 1(testcustomer) met password "password"
     
-    interface(parking_spots);
+    while (true) {interface(parking_spots); }         
+        
     }
 
+
 /*
 Why is this not in query.cpp? Because somehow, it errors out when it's there.
 The error message indicates it is a memory issue but I suspect it's a
 concurrency issue. Do not move this.
  */
+
 vector<Park_spot> populate_spots() {
     vector<Park_spot> spots;
     SQLite::Statement query(data::db, "SELECT * FROM Park_spot WHERE id > 0;");

newParkManne.cpp

@@ -0,0 +1,5 @@
+#include <iostream>
+
+void say_hello(){
+    std::cout << "Hello, from newParkManne!\n";
+}

readme.md

@@ -12,6 +12,14 @@ Or click the build icon in vscode *shrugs*
 # Parkmanne
 ## A stroll in the park
 
+######TO-DO List:
+- [x] Admin login
+- [ ] Billing report menu
+- [ ] Report from a specific month i.e. january
+- [ ] Edit option in menu
+- [ ] Option to confirm edit after input
+- [ ] Divide menu in sub menus
+- [ ] Analytics of customer (e.g. # customers with 2-wheeler or list of customer and telephone numbers etc.)
 
 This is a graph of how everything is connected.
 If you need to add functionality that doesn't fall in any of these, and you're unsure of what to include, you can decide something like this: