added endpoints,apidoc and testcases

Author: hricha11

_apidoc.js

@@ -665,3 +665,87 @@
  * @apiSuccess {String[]} module.cognitiveLevels Array of cognitive levels of
  * attainment as per Bloom's Taxanomy (L1-L6).
  */
+// ------------------------------------------------------------------------------------------
+// Attendance.
+// ------------------------------------------------------------------------------------------
+
+/**
+ * @api {post} /attendance/add Add Attendance
+ * @apiName AddAttendance
+ * @apiGroup Attendance
+ * @apiDescription Add a new attendance.
+ *
+ * @apiBody {String} student Student name.
+ * @apiBody {String} course Course name.
+ * @apiBody {Number} monthlyAttended Monthly attendance of student.
+ * @apiBody {Number} monthlyOccured Monthly occured.
+ * @apiBody {Number} cumulativeAttended sum of attendance of student.
+ * @apiBody {Number} cumulativeOccured sum of occured.
+ * 
+ * @apiSuccess {String} res Response message.
+ * @apiError (Error 500) UserNotFound The  of the User was not found
+ *
+ * @apiSuccessExample Success-Response:
+ *     HTTP/1.1 200 OK
+ *     {
+ *       "res": "added attendance Example Attendance"
+ *     }
+ *
+ * @apiErrorExample Error-Response:
+ *     HTTP/1.1 500 Internal Server Error
+ *     {
+ *       "err": "Error while inserting in DB"
+ *     }
+ */
+
+/**
+ * @api {delete} /attendance/delete/:attendanceId To delete Attendance
+ * @apiName DeleteAttendance
+ * @apiGroup Attendance
+ *
+ * @apiParam {String} attendanceId The ID of the attendance document to delete.
+ *
+ * @apiSuccess {String} res Success message indicating the deletion.
+ *
+ * @apiError (Error 500) err Error message if there was an error during the deletion.
+ *
+* */
+
+/**
+ * @api {post} /attendance/update update attendance details
+ * @apiName UpdateAttendance
+ * @apiGroup Attendance
+ * @apiDescription update Existing attendance
+ *
+ * @apiBody {String} [student] Student name.
+ * @apiBody {String} [course] Course name.
+ * @apiBody {Number} [monthlyAttended] Monthly attendance of student.
+ * @apiBody {Number} [monthlyOccured] Monthly occured.
+ * @apiBody {Number} [cumulativeAttended] sum of attendance of student.
+ * @apiBody {Number} [cumulativeOccured] sum of occured.
+ *
+ * @apiSuccess {String} res Attendance updated.
+ * @apiError (Error 500) err Error in updating database
+ *
+ */
+
+/**
+ * @api {get} attendance/list Get Attendance List
+ * @apiName GetAttendance
+ * @apiGroup Attendance
+ *
+ * @apiBody {String} [student] Student name.
+ * @apiBody {String} [course] Course name.
+ * @apiBody {Number} [monthlyAttended] Monthly attendance of student.
+ * @apiBody {Number} [monthlyOccured] Monthly occured.
+ * @apiBody {Number} [cumulativeAttended] sum of attendance of student.
+ * @apiBody {Number} [cumulativeOccured] sum of occured.
+ *
+ * @apiSuccess {attendance[]} res Array of Filtered attendance Doc.
+ * @apiSuccess {String} attendance._id ID of document given by database.
+ * @apiSuccess {String} attendance.student Name of student.
+ * @apiSuccess {String} attendance.course Name of course.
+ * @apiSuccess {Number} attendance.monthlyAttended Monthly attendance of student.
+ * @apiSuccess {Number} attendance.cumulativeAttended sum of attendance of student.
+ * @apiSuccess {Number} attendance.cumulativeOccured sum of occured.
+ */

controller/attendance.js

@@ -0,0 +1,62 @@
+import {
+    addNewAttendance, deleteAttendanceById, updateAttendanceById, getAttendances,
+  } from "#services/attendance";
+  import { logger } from "#util";
+  
+  async function addAttendance(req, res) {
+    const {
+      student, course, monthlyAttended, monthlyOccured, cumulativeAttended, cumulativeOccured,
+    } = req.body;
+    try {
+      // eslint-disable-next-line max-len
+      const attendance = await addNewAttendance( student, course, monthlyAttended, monthlyOccured, cumulativeAttended, cumulativeOccured);
+      res.json({ res: `added attendance ${attendance.student}`, id: attendance.id });
+    } catch (error) {
+      logger.error("Error while inserting", error);
+      res.status(500);
+      res.json({ err: "Error while inserting in DB" });
+    }
+  }
+  async function deleteAttendance(req, res) {
+    const { id } = req.params;
+    try {
+      await deleteAttendanceById(id);
+      res.json({ res: "Attendance deleted successfully" });
+    } catch (error) {
+      logger.error("Error while deleting", error);
+      res.status(500);
+      res.json({ err: "Error while deleting from DB" });
+    }
+  }
+  
+  async function updateAttendance(req, res) {
+    const { id } = req.params;
+    const {
+      ...data
+    } = req.body;
+  
+    try {
+      await updateAttendanceById(id, data);
+      res.json({ res: `${id} attendance updated` });
+    } catch (error) {
+      logger.error("Error while inserting", error);
+      res.status(500);
+      res.json({ err: "Error while inserting in DB" });
+    }
+  }
+  
+  async function showAttendance(req, res) {
+    try {
+      const attendance = await getAttendances(req.query);
+      return res.json({ res: attendance });
+    } catch (error) {
+      logger.error("Error while fetching", error);
+      res.status(500);
+      return res.json({ err: "Error while fetching the data" });
+    }
+  }
+  
+  export default {
+    addAttendance, updateAttendance, deleteAttendance, showAttendance,
+  };
+  

routes/attendance.js

@@ -0,0 +1,10 @@
+import express from "express";
+import attendanceController from "#controller/attendance";
+
+const router = express.Router();
+router.get("/list", attendanceController.showAttendance);
+router.post("/add", attendanceController.addAttendance);
+router.delete("/delete/:id", attendanceController.deleteAttendance);
+router.post("/update/:id", attendanceController.updateAttendance);
+
+export default router;

services/attendance.js

@@ -0,0 +1,41 @@
+import Attendance from "#models/attendance";
+import databaseError from "#error/database";
+
+export async function addNewAttendance( student, course, monthlyAttended, monthlyOccured, cumulativeAttended, cumulativeOccured) {
+  const newAttendance = await Attendance.create({
+    student,
+    course,
+    monthlyAttended,
+    monthlyOccured,
+    cumulativeAttended,
+    cumulativeOccured,
+  });
+  if (newAttendance.student === student) {
+    return newAttendance;
+  }
+  throw new databaseError.DataEntryError("Add Attendance");
+}
+
+export async function getAttendances(filter) {
+  const attendances = await Attendance.read(filter);
+  if (attendances) {
+    return attendances;
+  }
+  throw new databaseError.DataNotFoundError("Attendance");
+}
+
+export async function deleteAttendanceById(attendanceId) {
+  const deleted = await Attendance.remove({ _id: attendanceId });
+  if (deleted) {
+    return deleted;
+  }
+  throw new databaseError.DataDeleteError("Attendance");
+}
+
+export async function updateAttendanceById(id, data) {
+  const updated = await Attendance.update({ _id: id }, data);
+  if (updated) {
+    return updated;
+  }
+  throw new databaseError.DataEntryError("Attendance");
+}

test/routes/attendance.test.js

@@ -0,0 +1,82 @@
+import request from "supertest";
+import { jest } from "@jest/globals"; // eslint-disable-line import/no-extraneous-dependencies
+import app from "#app";
+import attendanceModel from "#models/attendance";
+import connector from "#models/databaseUtil";
+
+jest.mock("#util");
+
+let server;
+let agent;
+beforeAll((done) => {
+  server = app.listen(null, () => {
+    agent = request.agent(server);
+    connector.set("debug", false);
+    done();
+  });
+});
+
+function cleanUp(callback) {
+  attendanceModel.remove({ name: "xyz" }).then(() => {
+    connector.disconnect((DBerr) => {
+      if (DBerr) console.log("Database dissconnnect error: ", DBerr);
+      server.close((serverErr) => {
+        if (serverErr) console.log(serverErr);
+        callback();
+      });
+    });
+  });
+}
+
+afterAll((done) => {
+  cleanUp(done);
+});
+
+describe("checking attendance functions", () => {
+  it("create attendance", async () => {
+    const response = await agent.post("/attendance/add").send({
+      name: "xyz",
+      course: "XYZ",
+      monthlyAttended: 123,
+      monthlyOccured: 123,
+      cumulativeAttended: 123,
+      cumulativeOccured: 123,
+    });
+    expect(response.headers["content-type"]).toMatch(/json/);
+    expect(response.status).toBe(200);
+    expect(response.body.res).toMatch(/added attendance/);
+  });
+  let id;
+  beforeEach(async () => {
+    id = await agent.post("/attendance/add").send({
+        name: "xyz",
+        course: "XYZ",
+        monthlyAttended: 123,
+        monthlyOccured: 123,
+        cumulativeAttended: 123,
+        cumulativeOccured: 123,
+    });
+    id = JSON.parse(id.res.text).id;
+  });
+
+  afterEach(async () => {
+    await attendanceModel.remove({ name: "xyz" });
+  });
+
+  it("read attendance", async () => {
+    const response = await agent
+      .get("/attendance/list")
+      .send({ name: "xyz" });
+    expect(response.status).toBe(200);
+    expect(response.body.res).toBeDefined();
+  });
+
+  it("update attendance", async () => {
+    const response = await agent
+      .post(`/attendance/update/${id}`)
+      .send({ name: "xyz" }, { name: "123" });
+    expect(response.headers["content-type"]).toMatch(/json/);
+    expect(response.status).toBe(200);
+    expect(response.body.res).toMatch(/attendance updated/);
+  });
+});