Initial version

.cursorrules

@@ -0,0 +1,305 @@
+# Cursor Rules - Group 1: Development Philosophy & Coding Conventions
+1. Overall Architecture & Structure:
+   - Enforce a clear separation of concerns between the backend and the frontend:
+     - **Backend**: Use Express for routing, Passport for authentication, and Swagger for API documentation. Organize code into modules such as routes, services, and helpers.
+       - **Example**:
+         - Routes: `src/routes/auth.js` for authentication routes.
+         - Services: `src/services/auth.js` for authentication logic.
+         - Helpers: `src/helpers/wrapAsync.js` for wrapping asynchronous functions.
+     - **Frontend**: Use Next.js with React and TypeScript. Structure components using functional components, hooks, and layouts.
+       - **Example**:
+         - Pages: `pages/index.tsx` for the main page.
+         - Components: `components/Header.tsx` for the header component.
+         - Layouts: `layouts/MainLayout.tsx` for common page layouts.
+   - Ensure that backend modules and frontend components are organized for reusability and maintainability:
+     - **Backend**: Separate business logic into services and use middleware for common tasks.
+     - **Frontend**: Use reusable components and hooks to manage state and lifecycle.
+
+2. Coding Style & Formatting:
+   - For the backend (JavaScript):
+       • Use ES6+ features (const/let, arrow functions) consistently.
+       • Follow Prettier and ESLint configurations (e.g., consistent 2-space indentation, semicolons, and single quotes).
+       • Maintain clear asynchronous patterns with helper wrappers (e.g., wrapAsync).
+         - **Example from auth.js**:
+           ```javascript
+           router.post('/signin/local', wrapAsync(async (req, res) => {
+             const payload = await AuthService.signin(req.body.email, req.body.password, req);
+             res.status(200).send(payload);
+           }));
+           ```
+      • Document API endpoints with inline Swagger comments to ensure API clarity and consistency.
+         - **Example**:
+           ```javascript
+           /**
+            * @swagger
+            * /api/auth/signin:
+            *   post:
+            *     summary: Sign in a user
+            *     responses:
+            *       200:
+            *         description: Successful login
+            */
+           ```
+   - For the frontend (TypeScript/React):
+       • Use functional components with strict typing and separation of concerns.
+         - **Example**:
+           ```typescript
+           const Button: React.FC<{ onClick: () => void }> = ({ onClick }) => (
+             <button onClick={onClick}>Click me</button>
+           );
+           ```
+       • Follow naming conventions: PascalCase for components and types/interfaces, camelCase for variables, hooks, and function names.
+         - **Example**:
+           ```typescript
+           const useCustomHook = () => {
+             const [state, setState] = useState(false);
+             return [state, setState];
+           };
+           ```
+       • Utilize hooks (useEffect, useState) to manage state and lifecycle in a clear and concise manner.
+         - **Example**:
+           ```typescript
+           useEffect(() => {
+             console.log('Component mounted');
+           }, []);
+           ```
+
+3. Code Quality & Best Practices:
+   - Ensure code modularity by splitting complex logic into smaller, testable units.
+     - **Example**: In `auth.js`, routes are separated from business logic, which is handled in `AuthService`.
+   - Write self-documenting code and add comments where the logic is non-trivial.
+     - **Example**: Use descriptive function and variable names in `auth.js`, and add comments for complex asynchronous operations.
+   - Embrace declarative programming and adhere to SOLID principles.
+     - **Example**: In service functions, ensure each function has a single responsibility and dependencies are injected rather than hardcoded.
+
+4. Consistency & Tools Integration:
+   - Leverage existing tools like Prettier and ESLint to automatically enforce style and formatting rules.
+     - **Example**: Use `.prettierrc` and `.eslintrc.cjs` for configuration in your project.
+   - Use TypeScript in the frontend to ensure type safety and catch errors early.
+     - **Example**: Define interfaces and types in your React components to enforce strict typing.
+   - Maintain uniformity in API design and error handling strategies.
+     - **Example**: Consistently use Passport for authentication and a common error handling middleware in `auth.js`.
+
+## Group 2 – Naming Conventions
+1. File Naming and Structure:
+   • Frontend:
+     - Page Files: Use lower-case filenames (e.g., index.tsx) as prescribed by Next.js conventions.
+       - **Example**: `pages/index.tsx`, `pages/about.tsx`
+     - Component Files: Use PascalCase for React component files (e.g., WebSiteHeader.tsx, NavBar.tsx).
+       - **Example**: `components/Header.tsx`, `components/Footer.tsx`
+     - Directories: Use clear, descriptive names (e.g., 'pages', 'components', 'WebPageComponents').
+       - **Example**: `src/pages`, `src/components`
+   • Backend:
+     - Use lower-case filenames for modules (e.g., index.js, auth.js, projects.js).
+       - **Example**: `routes/auth.js`, `services/user.js`
+     - When needed, use hyphenation for clarity, but maintain consistency.
+       - **Example**: `helpers/wrap-async.js`
+
+2. Component and Module Naming:
+   • Frontend:
+     - React Components: Define components in PascalCase.
+     - TypeScript Interfaces/Types: Use PascalCase (e.g., WebSiteHeaderProps).
+   • Backend:
+     - Classes (if any) and constructors should be in PascalCase; most helper functions and modules use camelCase.
+
+3. Variable, Function, and Hook Naming:
+   • Use camelCase for variables and function names in both frontend and backend.
+     - **Example**:
+       ```javascript
+       const userName = 'John Doe';
+       function handleLogin() { ... }
+       ```
+   • Custom Hooks: Prefix with 'use' (e.g., useAuth, useForm).
+     - **Example**:
+       ```typescript
+       const useAuth = () => {
+         const [isAuthenticated, setIsAuthenticated] = useState(false);
+         return { isAuthenticated, setIsAuthenticated };
+       };
+       ```
+
+4. Consistency and Readability:
+   • Maintain uniform naming across the project to ensure clarity and ease of maintenance.
+     - **Example**: Use consistent naming conventions for variables, functions, and components, such as camelCase for variables and functions, and PascalCase for components.
+     - **Example**: In `auth.js`, ensure that all function names clearly describe their purpose, such as `handleLogin` or `validateUserInput`.
+
+## Group 3 – Frontend & React Best Practices
+1. Use of Functional Components & TypeScript:
+   • Build all components as functional components.
+     - **Example**:
+       ```typescript
+       const Header: React.FC = () => {
+         return <header>Header Content</header>;
+       };
+       ```
+   • Leverage TypeScript for static type checking and enforce strict prop and state types.
+     - **Example**:
+       ```typescript
+       interface ButtonProps {
+         onClick: () => void;
+       }
+       const Button: React.FC<ButtonProps> = ({ onClick }) => (
+         <button onClick={onClick}>Click me</button>
+       );
+       ```
+
+2. Effective Use of React Hooks:
+   • Utilize useState and useEffect appropriately with proper dependency arrays.
+     - **Example**:
+       ```typescript
+       const [count, setCount] = useState(0);
+       useEffect(() => {
+         console.log('Component mounted');
+       }, []);
+       ```
+   • Create custom hooks to encapsulate shared logic (e.g., useAppSelector).
+     - **Example**:
+       ```typescript
+       const useAuth = () => {
+         const [isAuthenticated, setIsAuthenticated] = useState(false);
+         return { isAuthenticated, setIsAuthenticated };
+       };
+       ```
+
+3. Component Composition & Separation of Concerns:
+   • Separate presentational (stateless) components from container components managing logic.
+     - **Example**: Use `LayoutGuest` to encapsulate common page structures.
+
+4. Code Quality & Readability:
+   • Maintain consistent formatting and adhere to Prettier and ESLint rules.
+   • Use descriptive names for variables, functions, and components.
+   • Document non-trivial logic with inline comments and consider implementing error boundaries where needed.
+   • New code must adhere to these conventions to avoid ambiguity.
+   • Use descriptive names that reflect the purpose and domain, avoiding abbreviations unless standard in the project.
+
+## Group 4 – Backend & API Guidelines
+1. API Endpoint Design & Documentation:
+   • Follow RESTful naming conventions; all route handlers should be named clearly and consistently.
+     - **Example**: Use verbs like `GET`, `POST`, `PUT`, `DELETE` to define actions, e.g., `GET /api/auth/me` to retrieve user info.
+   • Document endpoints with Swagger annotations to provide descriptions, expected request bodies, and response codes.
+     - **Example**:
+       ```javascript
+       /**
+        * @swagger
+        * /api/auth/signin:
+        *   post:
+        *     summary: Sign in a user
+        *     requestBody:
+        *       description: User credentials
+        *       content:
+        *         application/json:
+        *           schema:
+        *             $ref: "#/components/schemas/Auth"
+        *     responses:
+        *       200:
+        *         description: Successful login
+        *       400:
+        *         description: Invalid username/password supplied
+        */
+       ```
+   • Examples (for Auth endpoints):
+       - POST /api/auth/signin/local
+           • Description: Logs the user into the system.
+           • Request Body (application/json):
+               { "email": "admin@flatlogic.com", "password": "password" }
+           • Responses:
+               - 200: Successful login (returns token and user data).
+               - 400: Invalid username/password supplied.
+       - GET /api/auth/me
+           • Description: Retrieves current authorized user information.
+           • Secured via Passport JWT; uses req.currentUser.
+           • Responses:
+               - 200: Returns current user info.
+               - 400: Invalid credentials or missing user data.
+       - POST /api/auth/signup
+           • Description: Registers a new user.
+           • Request Body (application/json):
+               { "email": "admin@flatlogic.com", "password": "password" }
+           • Responses:
+               - 200: New user signed up successfully.
+               - 400: Invalid input supplied.
+               - 500: Server error.
+
+## Group 5 – Testing, Quality Assurance & Error Handling
+1. Testing Guidelines:
+   • Write unit tests for critical backend and frontend components using frameworks such as Jest, React Testing Library, and Mocha/Chai.
+     - **Example**:
+       ```javascript
+       test('should return user data', async () => {
+         const user = await getUserData();
+         expect(user).toHaveProperty('email');
+       });
+       ```
+   • Practice test-driven development and maintain high test coverage.
+   • Regularly update tests following changes in business logic.
+
+2. Quality Assurance:
+   • Enforce code quality with ESLint, Prettier, and static analysis tools.
+   • Integrate continuous testing workflows (CI/CD) to catch issues early.
+     - **Example**: Use GitHub Actions for automated testing and deployment.
+   • Ensure documentation is kept up-to-date with the implemented code.
+
+3. Error Handling:
+   • Back-end:
+       - Wrap asynchronous route handlers with a helper (e.g., wrapAsync) to capture errors.
+         - **Example**:
+           ```javascript
+           router.post('/signin', wrapAsync(async (req, res) => {
+             const user = await AuthService.signin(req.body);
+             res.send(user);
+           }));
+           ```
+       - Use centralized error handling middleware (e.g., commonErrorHandler) for uniform error responses.
+   • Front-end:
+       - Implement error boundaries in React to gracefully handle runtime errors.
+       - Display user-friendly error messages and log errors for further analysis.
+
+2. Authentication & Security:
+   • Protect endpoints by using Passport.js with JWT (e.g., passport.authenticate('jwt', { session: false })).
+     - **Example**:
+       ```javascript
+       router.get('/profile', passport.authenticate('jwt', { session: false }), (req, res) => {
+         res.send(req.user);
+       });
+       ```
+   • Ensure that secure routes check for existence of req.currentUser. If absent, return a ForbiddenError.
+
+3. Consistent Error Handling & Middleware Usage:
+   • Wrap asynchronous route handlers with helpers like wrapAsync for error propagation.
+   • Use centralized error handling middleware (e.g., commonErrorHandler) to capture and format errors uniformly.
+
+4. Modular Code Organization:
+   • Organize backend code into separate files for routes, services, and database access (e.g., auth.js, projects.js, tasks.js).
+   • Use descriptive, lowercase filenames for modules and routes.
+
+5. Endpoint Security Best Practices:
+   • Validate input data and sanitize requests where necessary.
+   • Restrict sensitive operations to authenticated users with proper role-based permissions.
+
+
+────────────────────────────────────────
+Group 6 – Accessibility, UI, and Styling Guidelines (Updated)
+────────────────────────────────────────
+1. Sidebar Styling:
+   • The sidebar is implemented in the authenticated layout via the AsideMenu component, with the actual element defined in AsideMenuLayer (located at frontend/src/components/AsideMenuLayer.tsx) as an <aside> element with id="asideMenu".
+     - **Example**:
+       ```css
+       #asideMenu {
+           background-color: #F8F4E1 !important;
+       }
+       ```
+   • When modifying sidebar styles, target #asideMenu and its child elements rather than generic selectors (e.g., avoid .app-sidebar) to ensure that the changes affect the actual rendered sidebar.
+   • Remove or override any conflicting background utilities (such as an unwanted bg-white) so our desired background color (#F8F4E1) is fully visible. Use a highly specific selector if necessary.
+   • Adjust spacing (padding/margins) at both the container (#asideMenu) and the individual menu item level to maintain a consistent, compact design.
+
+2. General Project Styling and Tailwind CSS Usage:
+   • The application leverages Tailwind CSS extensively, with core styling defined in _theme.css using the @apply directive. Any new modifications should follow this pattern to ensure consistency.
+     - **Example**:
+       ```css
+       .btn {
+           @apply bg-blue-500 text-white;
+       }
+       ```
+   • The themed blocks (like .theme-pink and .theme-green) standardize the UI's appearance. When applying custom overrides, ensure they integrate cleanly into these structures and avoid conflicts or circular dependency errors (e.g., issues when redefining utilities such as text-blue-600).
+   • Adjustments via Tailwind CSS generally require modifying class names in the components and ensuring that global overrides are applied in the correct order. Consistent use of design tokens and custom color codes (e.g., #F8F4E1) throughout the app is crucial to a cohesive design.
+   • Specificity is key. If a change isn't visually reflected as expected, inspect the rendered HTML to identify which classes are taking precedence.

.dockerignore

@@ -0,0 +1,3 @@
+backend/node_modules
+frontend/node_modules
+frontend/build

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+*/node_modules/
+*/build/

502.html

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Service Starting</title>
+    <style>
+        body {
+            font-family: sans-serif;
+            display: flex;
+            flex-direction: column;
+            justify-content: center;
+            align-items: center;
+            min-height: 100vh;
+            background-color: #f4f4f4;
+            margin: 0;
+            padding: 20px;
+            box-sizing: border-box;
+        }
+        .container {
+            text-align: center;
+            padding: 30px;
+            background-color: #fff;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+            margin-bottom: 20px;
+        }
+        h1 {
+            color: #333;
+            margin-bottom: 15px;
+        }
+        p {
+            color: #666;
+            font-size: 1.1em;
+            margin-bottom: 10px;
+        }
+        .tip {
+            color: #999;
+            font-size: 0.9em;
+            margin-bottom: 20px;
+        }
+        .loader-container {
+            display: flex;
+            justify-content: center;
+            width: 100%;
+            margin-top: 20px;
+        }
+        .loader {
+            border: 4px solid #f3f3f3; /* Light grey border */
+            border-top: 4px solid #3498db; /* Blue border */
+            border-radius: 50%;
+            width: 40px;
+            height: 40px;
+            animation: spin 2s linear infinite;
+        }
+        .hidden {
+            display: none;
+        }
+
+        @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+        }
+    </style>
+</head>
+<body>
+<div class="container">
+    <h1 id="status-heading">Service is Starting</h1>
+    <p id="status-message">The application is currently launching.</p>
+    <p class="tip">The page will automatically refresh once the site is available.</p>
+    <div class="loader-container">
+        <div class="loader"></div>
+    </div>
+</div>
+
+<script>
+    function checkAvailability() {
+        fetch('/')
+            .then(response => {
+                if (response.ok) {
+                    window.location.reload();
+                } else {
+                    setTimeout(checkAvailability, 5000);
+                }
+            })
+            .catch(() => {
+                setTimeout(checkAvailability, 5000);
+            });
+    }
+    document.addEventListener('DOMContentLoaded', checkAvailability);
+</script>
+</body>
+</html>

Dockerfile

@@ -0,0 +1,17 @@
+FROM node:20.15.1-alpine AS builder
+RUN apk add --no-cache git
+WORKDIR /app
+COPY frontend/package.json frontend/yarn.lock ./
+RUN yarn install --pure-lockfile
+COPY frontend .
+RUN yarn build
+
+FROM node:20.15.1-alpine
+WORKDIR /app
+COPY backend/package.json backend/yarn.lock ./
+RUN yarn install --pure-lockfile
+COPY backend .
+
+COPY --from=builder /app/build /app/public
+CMD ["yarn", "start"]
+

Dockerfile.dev

@@ -0,0 +1,73 @@
+# Base image for Node.js dependencies
+FROM node:20.15.1-alpine AS frontend-deps
+RUN apk add --no-cache git
+WORKDIR /app/frontend
+COPY frontend/package.json frontend/yarn.lock ./
+RUN yarn install --pure-lockfile
+
+FROM node:20.15.1-alpine AS backend-deps
+RUN apk add --no-cache git
+WORKDIR /app/backend
+COPY backend/package.json backend/yarn.lock ./
+RUN yarn install --pure-lockfile
+
+FROM node:20.15.1-alpine AS app-shell-deps
+RUN apk add --no-cache git
+WORKDIR /app/app-shell
+COPY app-shell/package.json app-shell/yarn.lock ./
+RUN yarn install --pure-lockfile
+
+# Nginx setup and application build
+FROM node:20.15.1-alpine AS build
+RUN apk add --no-cache git nginx
+RUN apk add --no-cache lsof procps
+RUN yarn global add concurrently
+
+RUN mkdir -p /app/pids
+
+# Make sure to add yarn global bin to PATH
+ENV PATH /root/.yarn/bin:/root/.config/yarn/global/node_modules/.bin:$PATH
+
+# Copy dependencies
+WORKDIR /app
+COPY --from=frontend-deps /app/frontend /app/frontend
+COPY --from=backend-deps /app/backend /app/backend
+COPY --from=app-shell-deps /app/app-shell /app/app-shell
+
+COPY frontend /app/frontend
+COPY backend /app/backend
+COPY app-shell /app/app-shell
+COPY docker /app/docker
+
+# Copy Nginx configuration
+COPY nginx.conf /etc/nginx/nginx.conf
+
+# Copy custom error page
+COPY 502.html /usr/share/nginx/html/502.html
+
+# Change owner and permissions of the error page
+RUN chown nginx:nginx /usr/share/nginx/html/502.html && \
+    chmod 644 /usr/share/nginx/html/502.html
+
+# Copy all files from root to /app
+COPY . /app
+
+# Expose the port the app runs on
+EXPOSE 8080
+ENV NODE_ENV=dev_stage
+ENV FRONT_PORT=3001
+ENV BACKEND_PORT=3000
+ENV APP_SHELL_PORT=4000
+
+CMD ["sh", "-c", "\
+  yarn --cwd /app/frontend dev & echo $! > /app/pids/frontend.pid && \
+  yarn --cwd /app/backend start & echo $! > /app/pids/backend.pid && \
+  sleep 10 && nginx -g 'daemon off;' & \
+  NGINX_PID=$! && \
+  echo 'Waiting for backend (port 3000) to be available...' && \
+  while ! nc -z localhost ${BACKEND_PORT}; do \
+    sleep 2; \
+  done && \
+  echo 'Backend is up. Starting app_shell for Git check...' && \
+  yarn --cwd /app/app-shell start && \
+  wait $NGINX_PID"]

LICENSE

@@ -0,0 +1 @@
+https://flatlogic.com/

README.md

@@ -0,0 +1,200 @@
+
+
+# Nexus school management
+
+## This project was generated by [Flatlogic Platform](https://flatlogic.com).
+
+  - Frontend: [React.js](https://flatlogic.com/templates?framework%5B%5D=react&sort=default)
+
+  - Backend: [NodeJS](https://flatlogic.com/templates?backend%5B%5D=nodejs&sort=default)
+
+    <details><summary>Backend Folder Structure</summary>   
+
+    The generated application has the following backend folder structure: 
+
+    `src` folder which contains your working files that will be used later to create the build. The src folder contains folders as:
+
+      - `auth` - config the library for authentication and authorization;
+
+      - `db` - contains such folders as:
+
+        - `api` - documentation that is automatically generated by jsdoc or other tools;
+
+        - `migrations` - is a skeleton of the database or all the actions that users do with the database;
+
+        - `models`- what will represent the database for the backend;
+
+        - `seeders` -  the entity that creates the data for the database.
+
+      - `routes` - this folder would contain all the routes that you have created using Express Router and what they do would be exported from a Controller file;
+
+      - `services` - contains such folders as `emails` and `notifications`.   
+    </details> 
+
+  - Database: PostgreSQL
+
+  - app-shel: Core application framework that provides essential infrastructure services
+for the entire application.
+  -----------------------
+### We offer 2 ways how to start the project locally: by running Frontend and Backend or with Docker.
+-----------------------
+
+## To start the project:
+
+### Backend:
+
+> Please change current folder: `cd backend`
+
+#### Install local dependencies:
+`yarn install`
+
+  ------------
+
+#### Adjust local db:
+##### 1.  Install postgres:
+
+MacOS:
+
+`brew install postgres`
+
+    > if you don’t have ‘brew‘ please install it (https://brew.sh) and repeat step `brew install postgres`.
+
+Ubuntu:
+
+`sudo apt update`
+
+`sudo apt install postgresql postgresql-contrib`
+
+##### 2. Create db and admin user:
+Before run and test connection, make sure you have created a database as described in the above configuration. You can use the `psql` command to create a user and database.
+
+`psql postgres --u postgres`
+
+Next, type this command for creating a new user with password then give access for creating the database.
+
+`postgres-# CREATE ROLE admin WITH LOGIN PASSWORD 'admin_pass';`
+
+`postgres-# ALTER ROLE admin CREATEDB;`
+
+Quit `psql` then log in again using the new user that previously created.
+
+`postgres-# \q`
+
+`psql postgres -U admin`
+
+Type this command to creating a new database.
+
+`postgres=> CREATE DATABASE db_{your_project_name};`
+
+Then give that new user privileges to the new database then quit the `psql`.
+
+`postgres=> GRANT ALL PRIVILEGES ON DATABASE db_{your_project_name} TO admin;`
+
+`postgres=> \q`
+
+  ------------
+
+#### Create database:
+`yarn db:create`
+
+#### Start production build:
+`yarn start`
+
+### Frontend:
+
+> Please change current folder: `cd frontend`
+
+## To start the project with Docker:
+### Description:
+
+The project contains the **docker folder** and the `Dockerfile`.
+
+The `Dockerfile` is used to Deploy the project to Google Cloud.
+
+The **docker folder** contains a couple of helper scripts:
+
+- `docker-compose.yml` (all our services: web, backend, db are described here)
+- `start-backend.sh` (starts backend, but only after the database)
+- `wait-for-it.sh` (imported from https://github.com/vishnubob/wait-for-it)
+
+    > To avoid breaking the application, we recommend you don't edit the following files: everything that includes the **docker folder** and `Dokerfile`.
+
+## Run services:
+
+1. Install docker compose (https://docs.docker.com/compose/install/)
+
+2. Move to `docker` folder. All next steps should be done from this folder.
+
+   ``` cd docker ```
+
+3. Make executables from `wait-for-it.sh` and `start-backend.sh`:
+
+   ``` chmod +x start-backend.sh && chmod +x wait-for-it.sh ```
+
+4. Download dependend projects for services.
+
+5. Review the docker-compose.yml file. Make sure that all services have Dockerfiles. Only db service doesn't require a Dockerfile.
+
+6. Make sure you have needed ports (see them in `ports`) available on your local machine.
+
+7. Start services:
+
+   7.1. With an empty database `rm -rf data && docker-compose up`
+
+   7.2. With a stored (from previus runs) database data `docker-compose up`
+
+8. Check http://localhost:3000
+
+9. Stop services:
+
+   9.1. Just press `Ctr+C`
+
+## Most common errors:
+
+1. `connection refused`
+
+   There could be many reasons, but the most common are:
+
+  - The port is not open on the destination machine.
+
+  - The port is open on the destination machine, but its backlog of pending connections is full.
+
+  - A firewall between the client and server is blocking access (also check local firewalls).
+
+   After checking for firewalls and that the port is open, use telnet to connect to the IP/port to test connectivity. This removes any potential issues from your application.
+
+   ***MacOS:***
+
+   If you suspect that your SSH service might be down, you can run this command to find out:
+
+   `sudo service ssh status`
+
+   If the command line returns a status of down, then you’ve likely found the reason behind your connectivity error.
+
+   ***Ubuntu:***
+
+   Sometimes a connection refused error can also indicate that there is an IP address conflict on your network. You can search for possible IP conflicts by running:
+
+   `arp-scan -I eth0 -l | grep <ipaddress>`
+
+   `arp-scan -I eth0 -l | grep <ipaddress>`
+
+   and
+
+   `arping <ipaddress>`
+
+2. `yarn db:create` creates database with the assembled tables (on MacOS with Postgres database)
+
+   The workaround - put the next commands to your Postgres database terminal:
+
+   `DROP SCHEMA public CASCADE;`
+
+   `CREATE SCHEMA public;`
+
+   `GRANT ALL ON SCHEMA public TO postgres;`
+
+   `GRANT ALL ON SCHEMA public TO public;`
+
+   Afterwards, continue to start your project in the backend directory by running:
+
+   `yarn start`

app-shell/.eslintrc.cjs

@@ -0,0 +1,26 @@
+const globals = require('globals');
+
+module.exports = [
+  {
+    files: ['**/*.js', '**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      ecmaVersion: 2021,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+      parser: '@typescript-eslint/parser',
+    },
+    plugins: ['@typescript-eslint'],
+    rules: {
+      'no-unused-vars': 'warn',
+      'no-console': 'off',
+      'indent': ['error', 2],
+      'quotes': ['error', 'single'],
+      'semi': ['error', 'always'],
+
+      '@typescript-eslint/no-unused-vars': 'warn',
+    },
+  },
+];

app-shell/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 80,
+  "trailingComma": "all",
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": true,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always"
+}

app-shell/.sequelizerc

@@ -0,0 +1,7 @@
+const path = require('path');
+module.exports = {
+  "config": path.resolve("src", "db", "db.config.js"),
+  "models-path": path.resolve("src", "db", "models"),
+  "seeders-path": path.resolve("src", "db", "seeders"),
+  "migrations-path": path.resolve("src", "db", "migrations")
+};

app-shell/Dockerfile

@@ -0,0 +1,23 @@
+FROM node:20.15.1-alpine
+
+RUN apk update && apk add bash
+# Create app directory
+WORKDIR /usr/src/app
+
+# Install app dependencies
+# A wildcard is used to ensure both package.json AND package-lock.json are copied
+# where available (npm@5+)
+COPY package*.json ./
+
+RUN yarn install
+# If you are building your code for production
+# RUN npm ci --only=production
+
+
+# Bundle app source
+COPY . .
+
+
+EXPOSE 4000
+
+CMD [ "yarn", "start" ]

app-shell/README.md

@@ -0,0 +1,13 @@
+#test - template backend,
+
+#### Run App on local machine:
+
+##### Install local dependencies:
+
+- `yarn install`
+
+---
+
+##### Start build:
+
+- `yarn start`

app-shell/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "app-shell",
+  "description": "app-shell",
+  "scripts": {
+    "start": "node ./src/index.js"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.26.7",
+    "adm-zip": "^0.5.16",
+    "axios": "^1.6.7",
+    "bcrypt": "5.1.1",
+    "cors": "2.8.5",
+    "eslint": "^9.13.0",
+    "express": "4.18.2",
+    "formidable": "1.2.2",
+    "helmet": "4.1.1",
+    "json2csv": "^5.0.7",
+    "jsonwebtoken": "8.5.1",
+    "lodash": "4.17.21",
+    "moment": "2.30.1",
+    "multer": "^1.4.4",
+    "passport": "^0.7.0",
+    "passport-google-oauth2": "^0.2.0",
+    "passport-jwt": "^4.0.1",
+    "passport-microsoft": "^0.1.0",
+    "postcss": "^8.5.1",
+    "sequelize-json-schema": "^2.1.1",
+    "pg": "^8.13.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "private": true,
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.12.2",
+    "@typescript-eslint/parser": "^8.12.2",
+    "cross-env": "7.0.3",
+    "mocha": "8.1.3",
+    "nodemon": "^3.1.7",
+    "sequelize-cli": "6.6.2"
+  }
+}

app-shell/src/config.js

@@ -0,0 +1,16 @@
+
+
+const config = {
+  schema_encryption_key: process.env.SCHEMA_ENCRYPTION_KEY || '',
+
+  project_uuid: '7c55a83d-5acf-40d5-8b78-fe8f9431a242',
+  flHost: process.env.NODE_ENV === 'production' ? 'https://flatlogic.com/projects' : 'http://localhost:3000/projects',
+
+  gitea_domain: process.env.GITEA_DOMAIN || 'gitea.flatlogic.app',
+  gitea_username: process.env.GITEA_USERNAME || 'admin',
+  gitea_api_token: process.env.GITEA_API_TOKEN || null,
+  github_repo_url: process.env.GITHUB_REPO_URL || null,
+  github_token: process.env.GITHUB_TOKEN || null,
+};
+
+module.exports = config;

app-shell/src/helpers.js

@@ -0,0 +1,23 @@
+const jwt = require('jsonwebtoken');
+const config = require('./config');
+
+module.exports = class Helpers {
+  static wrapAsync(fn) {
+    return function (req, res, next) {
+      fn(req, res, next).catch(next);
+    };
+  }
+
+  static commonErrorHandler(error, req, res, next) {
+    if ([400, 403, 404].includes(error.code)) {
+      return res.status(error.code).send(error.message);
+    }
+
+    console.error(error);
+    return res.status(500).send(error.message);
+  }
+
+  static jwtSign(data) {
+    return jwt.sign(data, config.secret_key, { expiresIn: '6h' });
+  }
+};

app-shell/src/index.js

@@ -0,0 +1,54 @@
+const express = require('express');
+const cors = require('cors');
+const app = express();
+const bodyParser = require('body-parser');
+const checkPermissions = require('./middlewares/check-permissions');
+const modifyPath = require('./middlewares/modify-path');
+const VCS = require('./services/vcs');
+
+const executorRoutes = require('./routes/executor');
+const vcsRoutes = require('./routes/vcs');
+
+// Function to initialize the Git repository
+function initRepo() {
+    const projectId = '30831';
+    return VCS.initRepo(projectId);
+}
+
+// Start the Express app on APP_SHELL_PORT (4000)
+function startServer() {
+    const PORT = 4000;
+    app.listen(PORT, () => {
+        console.log(`Listening on port ${PORT}`);
+    });
+}
+
+// Run Git check after the server is up
+function runGitCheck() {
+    initRepo()
+      .then(result => {
+          console.log(result?.message ? result.message : result);
+          // Here you can add additional logic if needed
+      })
+      .catch(err => {
+          console.error('Error during repo initialization:', err);
+          // Optionally exit the process if Git check is critical:
+          // process.exit(1);
+      });
+}
+
+app.use(cors({ origin: true }));
+app.use(bodyParser.json());
+app.use(checkPermissions);
+app.use(modifyPath);
+
+app.use('/executor', executorRoutes);
+app.use('/vcs', vcsRoutes);
+
+// Start the app_shell server
+startServer();
+
+// Now perform Git check
+runGitCheck();
+
+module.exports = app;

app-shell/src/middlewares/check-permissions.js

@@ -0,0 +1,17 @@
+const config = require('../config');
+
+function checkPermissions(req, res, next) {
+  const project_uuid = config.project_uuid;
+  const requiredHeader = 'X-Project-UUID';
+  const headerValue = req.headers[requiredHeader.toLowerCase()];
+  // Logging whatever request we're getting
+  console.log('Request:', req.url, req.method, req.body, req.headers);
+
+  if (headerValue && headerValue === project_uuid) {
+    next();
+  } else {
+    res.status(403).send({ error: 'Stop right there, criminal scum! Your project UUID is invalid or missing.' });
+  }
+}
+
+module.exports = checkPermissions;

app-shell/src/middlewares/modify-path.js

@@ -0,0 +1,8 @@
+function modifyPath(req, res, next) {
+    if (req.body && req.body.path) {
+      req.body.path = '../../../' + req.body.path;
+    }
+    next();
+  }
+  
+module.exports = modifyPath;

app-shell/src/routes/executor.js

@@ -0,0 +1,312 @@
+const express = require('express');
+const multer = require('multer');
+const upload = multer({ dest: 'uploads/' });
+const fs = require('fs');
+
+const ExecutorService = require('../services/executor');
+
+const wrapAsync = require('../helpers').wrapAsync;
+
+const router = express.Router();
+
+router.post(
+    '/read_project_tree',
+    wrapAsync(async (req, res) => {
+        const { path } = req.body;
+        const tree = await ExecutorService.readProjectTree(path);
+        res.status(200).send(tree);
+    }),
+);
+
+router.post(
+    '/read_file',
+    wrapAsync(async (req, res) => {
+        const { path, showLines } = req.body;
+        const content = await ExecutorService.readFileContents(path, showLines);
+        res.status(200).send(content);
+    }),
+);
+
+router.post(
+    '/count_file_lines',
+    wrapAsync(async (req, res) => {
+        const { path } = req.body;
+        const content = await ExecutorService.countFileLines(path);
+        res.status(200).send(content);
+    }),
+);
+
+// router.post(
+//     '/read_file_header',
+//     wrapAsync(async (req, res) => {
+//         const { path, N } = req.body;
+//         try {
+//             const header = await ExecutorService.readFileHeader(path, N);
+//             res.status(200).send(header);
+//         } catch (error) {
+//             res.status(500).send({
+//                 error: true,
+//                 message: error.message,
+//                 details: error.details || error.stack,
+//                 validation: error.validation
+//             });
+//         }
+//     }),
+// );
+
+router.post(
+    '/read_file_line_context',
+    wrapAsync(async (req, res) => {
+        const { path, lineNumber, windowSize, showLines } = req.body;
+        try {
+            const context = await ExecutorService.readFileLineContext(path, lineNumber, windowSize, showLines);
+            res.status(200).send(context);
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+router.post(
+    '/write_file',
+    wrapAsync(async (req, res) => {
+        const { path, fileContents, comment } = req.body;
+        try {
+            await ExecutorService.writeFile(path, fileContents, comment);
+            res.status(200).send({ message: 'File written successfully' });
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+router.post(
+    '/insert_file_content',
+    wrapAsync(async (req, res) => {
+        const { path, lineNumber, newContent, message } = req.body;
+        try {
+            await ExecutorService.insertFileContent(path, lineNumber, newContent, message);
+            res.status(200).send({ message: 'File written successfully' });
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+router.post(
+    '/replace_file_line',
+    wrapAsync(async (req, res) => {
+        const { path, lineNumber, newText } = req.body;
+        try {
+            const result = await ExecutorService.replaceFileLine(path, lineNumber, newText);
+            res.status(200).send(result);
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+router.post(
+    '/replace_file_chunk',
+    wrapAsync(async (req, res) => {
+        const { path, startLine, endLine, newCode } = req.body;
+        try {
+            const result = await ExecutorService.replaceFileChunk(path, startLine, endLine, newCode);
+            res.status(200).send(result);
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+router.post(
+    '/delete_file_lines',
+    wrapAsync(async (req, res) => {
+        const { path, startLine, endLine, message } = req.body;
+        try {
+            const result = await ExecutorService.deleteFileLines(path, startLine, endLine, message);
+            res.status(200).send(result);
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+router.post(
+    '/validate_file',
+    wrapAsync(async (req, res) => {
+        const { path } = req.body;
+        try {
+            const validationResult = await ExecutorService.validateFile(path);
+            res.status(200).send({ validationResult });
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            });
+        }
+    }),
+);
+
+
+router.post(
+  '/check_frontend_runtime_error',
+  wrapAsync(async (req, res) => {
+    try {
+      const result =  await ExecutorService.checkFrontendRuntimeLogs();
+      res.status(200).send(result);
+    } catch (error) {
+      res.status(500).send({ error: error });
+    }
+  }),
+);
+
+
+router.post(
+    '/replace_code_block',
+    wrapAsync(async (req, res) => {
+        const {path, oldCode, newCode, message} = req.body;
+        try {
+            const response = await ExecutorService.replaceCodeBlock(path, oldCode, newCode, message);
+            res.status(200).send(response);
+        } catch (error) {
+            res.status(500).send({
+                error: true,
+                message: error.message,
+                details: error.details || error.stack,
+                validation: error.validation
+            })
+        }
+    })
+)
+
+router.post('/update_project_files_from_scheme',
+    upload.single('file'), // 'file' - name of the field in the form
+    async (req, res) => {
+        console.log('Request received');
+        console.log('Headers:', req.headers);
+        if (!req.file) {
+            return res.status(400).json({ error: 'No file uploaded' });
+        }
+
+        console.log('File info:', {
+            originalname: req.file.originalname,
+            path: req.file.path,
+            size: req.file.size,
+            mimetype: req.file.mimetype
+        });
+
+        try {
+            console.log('Starting update process...');
+            const result = await ExecutorService.updateProjectFilesFromScheme(req.file.path);
+            console.log('Update completed, result:', result);
+
+            console.log('Removing temp file...');
+            fs.unlinkSync(req.file.path);
+            console.log('Temp file removed');
+
+            console.log('Sending response...');
+            return res.json(result);
+        } catch (error) {
+            console.error('Error in route handler:', error);
+            if (req.file) {
+                try {
+                    fs.unlinkSync(req.file.path);
+                    console.log('Temp file removed after error');
+                } catch (unlinkError) {
+                    console.error('Error removing temp file:', unlinkError);
+                }
+            }
+            console.error('Update project files error:', error);
+            return res.status(500).json({
+                error: error.message,
+                stack: process.env.NODE_ENV === 'development' ? error.stack : undefined
+            });
+        }
+    }
+);
+
+router.post(
+    '/get_db_schema',
+    wrapAsync(async (req, res) => {
+        try {
+
+            const jsonSchema = await ExecutorService.getDBSchema();
+            res.status(200).send({ jsonSchema });
+        } catch (error) {
+            res.status(500).send({ error: error });
+        }
+    }),
+);
+
+router.post(
+    '/execute_sql',
+    wrapAsync(async (req, res) => {
+        try {
+            const { query } = req.body;
+            const result =  await ExecutorService.executeSQL(query);
+            res.status(200).send(result);
+        } catch (error) {
+            res.status(500).send({ error: error });
+        }
+    }),
+);
+
+router.post(
+    '/search_files',
+    wrapAsync(async (req, res) => {
+        try {
+            const { searchStrings } = req.body;
+
+            if (
+                typeof searchStrings !== 'string' &&
+                !(
+                    Array.isArray(searchStrings) &&
+                    searchStrings.every(item => typeof item === 'string')
+                )
+            ) {
+                return res.status(400).send({ error: 'searchStrings must be a string or an array of strings' });
+            }
+
+            const result = await ExecutorService.searchFiles(searchStrings);
+            res.status(200).send(result);
+        } catch (error) {
+            res.status(500).send({ error: error.message });
+        }
+    }),
+);
+
+router.use('/', require('../helpers').commonErrorHandler);
+
+module.exports = router;

app-shell/src/routes/vcs.js

@@ -0,0 +1,40 @@
+const express = require('express');
+const wrapAsync = require('../helpers').wrapAsync; // Ваша обёртка для обработки асинхронных маршрутов
+const VSC = require('../services/vcs');
+const router = express.Router();
+
+router.post('/init', wrapAsync(async (req, res) => {
+    const result = await VSC.initRepo();
+    res.status(200).send(result);
+}));
+
+router.post('/commit', wrapAsync(async (req, res) => {
+    const { message, files, dev_schema } = req.body;
+    const result = await VSC.commitChanges(message, files, dev_schema);
+    res.status(200).send(result);
+}));
+
+router.post('/log', wrapAsync(async (req, res) => {
+    const result = await VSC.getLog();
+    res.status(200).send(result);
+}));
+
+router.post('/rollback', wrapAsync(async (req, res) => {
+    const { ref } = req.body;
+    // const result = await VSC.checkout(ref);
+    const result = await VSC.revert(ref);
+    res.status(200).send(result);
+}));
+
+router.post('/sync-to-stable', wrapAsync(async (req, res) => {
+    const result = await VSC.mergeDevIntoMaster();
+    res.status(200).send(result);
+}));
+
+router.post('/reset-dev', wrapAsync(async (req, res) => {
+    const result = await VSC.resetDevBranch();
+    res.status(200).send(result);
+}));
+
+router.use('/', require('../helpers').commonErrorHandler);
+module.exports = router;

app-shell/src/services/database.js

@@ -0,0 +1,88 @@
+// Database.js
+const { Client } = require('pg');
+const config = require('../../../backend/src/db/db.config');
+
+const env = process.env.NODE_ENV || 'development';
+const dbConfig = config[env];
+
+class Database {
+    constructor() {
+        this.client = new Client({
+            user: dbConfig.username,
+            password: dbConfig.password,
+            database: dbConfig.database,
+            host: dbConfig.host,
+            port: dbConfig.port
+        });
+
+        // Connect once, reuse the client
+        this.client.connect().catch(err => {
+            console.error('Error connecting to the database:', err);
+            throw err;
+        });
+    }
+
+    async executeSQL(query) {
+        try {
+            const result = await this.client.query(query);
+            return {
+                success: true,
+                rows: result.rows
+            };
+        } catch (error) {
+            console.error('Error executing query:', error);
+            throw error;
+        }
+    }
+
+    // Method to fetch simple table/column info from 'information_schema'
+    // (You can expand this to handle constraints, indexes, etc.)
+    async getDBSchema(schemaName = 'public') {
+        try {
+            const tableQuery = `
+                SELECT table_name
+                FROM information_schema.tables
+                WHERE table_schema = $1
+                  AND table_type = 'BASE TABLE'
+                ORDER BY table_name
+              `;
+
+            const columnQuery = `
+                SELECT table_name, column_name, data_type, is_nullable
+                FROM information_schema.columns
+                WHERE table_schema = $1
+                ORDER BY table_name, ordinal_position
+              `;
+
+            const [tablesResult, columnsResult] = await Promise.all([
+                this.client.query(tableQuery, [schemaName]),
+                this.client.query(columnQuery, [schemaName]),
+            ]);
+
+            // Build a simple schema object:
+            const tables = tablesResult.rows.map(row => row.table_name);
+            const columnsByTable = {};
+
+            columnsResult.rows.forEach(row => {
+                const { table_name, column_name, data_type, is_nullable } = row;
+                if (!columnsByTable[table_name]) columnsByTable[table_name] = [];
+                columnsByTable[table_name].push({ column_name, data_type, is_nullable });
+            });
+
+            // Combine tables with their columns
+            return tables.map(table => ({
+                table,
+                columns: columnsByTable[table] || [],
+            }));
+        } catch (error) {
+            console.error('Error fetching schema:', error);
+            throw error;
+        }
+    }
+
+    async close() {
+        await this.client.end();
+    }
+}
+
+module.exports = new Database();

app-shell/src/services/notifications/errors/forbidden.js

@@ -0,0 +1,16 @@
+const { getNotification, isNotification } = require('../helpers');
+
+module.exports = class ForbiddenError extends Error {
+  constructor(messageCode) {
+    let message;
+
+    if (messageCode && isNotification(messageCode)) {
+      message = getNotification(messageCode);
+    }
+
+    message = message || getNotification('errors.forbidden.message');
+
+    super(message);
+    this.code = 403;
+  }
+};

app-shell/src/services/notifications/errors/validation.js

@@ -0,0 +1,16 @@
+const { getNotification, isNotification } = require('../helpers');
+
+module.exports = class ValidationError extends Error {
+  constructor(messageCode) {
+    let message;
+
+    if (messageCode && isNotification(messageCode)) {
+      message = getNotification(messageCode);
+    }
+
+    message = message || getNotification('errors.validation.message');
+
+    super(message);
+    this.code = 400;
+  }
+};

app-shell/src/services/notifications/helpers.js

@@ -0,0 +1,30 @@
+const _get = require('lodash/get');
+const errors = require('./list');
+
+function format(message, args) {
+  if (!message) {
+    return null;
+  }
+
+  return message.replace(/{(\d+)}/g, function (match, number) {
+    return typeof args[number] != 'undefined' ? args[number] : match;
+  });
+}
+
+const isNotification = (key) => {
+  const message = _get(errors, key);
+  return !!message;
+};
+
+const getNotification = (key, ...args) => {
+  const message = _get(errors, key);
+
+  if (!message) {
+    return key;
+  }
+
+  return format(message, args);
+};
+
+exports.getNotification = getNotification;
+exports.isNotification = isNotification;

app-shell/src/services/notifications/list.js

@@ -0,0 +1,100 @@
+const errors = {
+  app: {
+    title: 'test',
+  },
+
+  auth: {
+    userDisabled: 'Your account is disabled',
+    forbidden: 'Forbidden',
+    unauthorized: 'Unauthorized',
+    userNotFound: `Sorry, we don't recognize your credentials`,
+    wrongPassword: `Sorry, we don't recognize your credentials`,
+    weakPassword: 'This password is too weak',
+    emailAlreadyInUse: 'Email is already in use',
+    invalidEmail: 'Please provide a valid email',
+    passwordReset: {
+      invalidToken: 'Password reset link is invalid or has expired',
+      error: `Email not recognized`,
+    },
+    passwordUpdate: {
+      samePassword: `You can't use the same password. Please create new password`,
+    },
+    userNotVerified: `Sorry, your email has not been verified yet`,
+    emailAddressVerificationEmail: {
+      invalidToken: 'Email verification link is invalid or has expired',
+      error: `Email not recognized`,
+    },
+  },
+
+  iam: {
+    errors: {
+      userAlreadyExists: 'User with this email already exists',
+      userNotFound: 'User not found',
+      disablingHimself: `You can't disable yourself`,
+      revokingOwnPermission: `You can't revoke your own owner permission`,
+      deletingHimself: `You can't delete yourself`,
+      emailRequired: 'Email is required',
+    },
+  },
+
+  importer: {
+    errors: {
+      invalidFileEmpty: 'The file is empty',
+      invalidFileExcel: 'Only excel (.xlsx) files are allowed',
+      invalidFileUpload:
+        'Invalid file. Make sure you are using the last version of the template.',
+      importHashRequired: 'Import hash is required',
+      importHashExistent: 'Data has already been imported',
+      userEmailMissing: 'Some items in the CSV do not have an email',
+    },
+  },
+
+  errors: {
+    forbidden: {
+      message: 'Forbidden',
+    },
+    validation: {
+      message: 'An error occurred',
+    },
+    searchQueryRequired: {
+      message: 'Search query is required',
+    },
+  },
+
+  emails: {
+    invitation: {
+      subject: `You've been invited to {0}`,
+      body: `    
+        <p>Hello,</p>
+        <p>You've been invited to {0} set password for your {1} account.</p>
+        <p><a href='{2}'>{2}</a></p>
+        <p>Thanks,</p>
+        <p>Your {0} team</p>
+      `,
+    },
+    emailAddressVerification: {
+      subject: `Verify your email for {0}`,
+      body: `
+        <p>Hello,</p>
+        <p>Follow this link to verify your email address.</p>
+        <p><a href='{0}'>{0}</a></p>
+        <p>If you didn't ask to verify this address, you can ignore this email.</p>
+        <p>Thanks,</p>
+        <p>Your {1} team</p>
+      `,
+    },
+    passwordReset: {
+      subject: `Reset your password for {0}`,
+      body: `
+        <p>Hello,</p>
+        <p>Follow this link to reset your {0} password for your {1} account.</p>
+        <p><a href='{2}'>{2}</a></p>
+        <p>If you didn't ask to reset your password, you can ignore this email.</p>
+        <p>Thanks,</p>
+        <p>Your {0} team</p>
+      `,
+    },
+  },
+};
+
+module.exports = errors;

app-shell/src/services/project-events.js

@@ -0,0 +1,67 @@
+const axios = require('axios');
+const config = require('../config.js');
+
+class ProjectEventsService {
+    /**
+     * Sends a project event to the Rails backend
+     *
+     * @param {string} eventType - Type of the event
+     * @param {object} payload - Event payload data
+     * @param {object} options - Additional options
+     * @param {string} [options.conversationId] - Optional conversation ID
+     * @param {boolean} [options.isError=false] - Whether this is an error event
+     * @returns {Promise<object>} - Response from the webhook
+     */
+    static async sendEvent(eventType, payload = {}, options = {}) {
+        try {
+            console.log(`[DEBUG] Sending project event: ${eventType}`);
+
+            const webhookUrl = `https://flatlogic.com/projects/events_webhook`;
+
+            // Prepare the event data
+            const eventData = {
+                project_uuid: config.project_uuid,
+                event_type: eventType,
+                payload: {
+                    ...payload,
+                    message: `[APP] ${payload.message}`,
+                    is_error: options.isError || false,
+                    system_message: true,
+                    is_command_info: true
+                }
+            };
+
+            // Add conversation ID if provided
+            if (options.conversationId) {
+                eventData.conversation_id = options.conversationId;
+            }
+
+            const headers = {
+                'Content-Type': 'application/json',
+                'x-project-uuid': config.project_uuid
+            };
+
+            console.log(`[DEBUG] Event data: ${JSON.stringify(eventData)}`);
+
+            const response = await axios.post(webhookUrl, eventData, { headers });
+
+            console.log(`[DEBUG] Event sent successfully, status: ${response.status}`);
+            return response.data;
+        } catch (error) {
+            console.error(`[ERROR] Failed to send project event: ${error.message}`);
+            if (error.response) {
+                console.error(`[ERROR] Response status: ${error.response.status}`);
+                console.error(`[ERROR] Response data: ${JSON.stringify(error.response.data)}`);
+            }
+
+            // Don't throw the error, just return a failed status
+            // This prevents errors in the event service from breaking app functionality
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+}
+
+module.exports = ProjectEventsService;

backend/.prettierrc

@@ -0,0 +1,11 @@
+{
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 80,
+  "trailingComma": "all",
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": true,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always"
+}

backend/.sequelizerc

@@ -0,0 +1,7 @@
+const path = require('path');
+module.exports = {
+  "config": path.resolve("src", "db", "db.config.js"),
+  "models-path": path.resolve("src", "db", "models"),
+  "seeders-path": path.resolve("src", "db", "seeders"),
+  "migrations-path": path.resolve("src", "db", "migrations")
+};

backend/Dockerfile

@@ -0,0 +1,23 @@
+FROM node:20.15.1-alpine
+
+RUN apk update && apk add bash
+# Create app directory
+WORKDIR /usr/src/app
+
+# Install app dependencies
+# A wildcard is used to ensure both package.json AND package-lock.json are copied
+# where available (npm@5+)
+COPY package*.json ./
+
+RUN yarn install
+# If you are building your code for production
+# RUN npm ci --only=production
+
+
+# Bundle app source
+COPY . .
+
+
+EXPOSE 8080
+
+CMD [ "yarn", "start" ]

backend/README.md

@@ -0,0 +1,67 @@
+#Nexus school management - template backend,
+
+#### Run App on local machine:
+
+##### Install local dependencies:
+
+- `yarn install`
+
+---
+
+##### Adjust local db:
+
+###### 1. Install postgres:
+
+- MacOS:
+
+  - `brew install postgres`
+
+- Ubuntu:
+  - `sudo apt update`
+  - `sudo apt install postgresql postgresql-contrib`
+
+###### 2. Create db and admin user:
+
+- Before run and test connection, make sure you have created a database as described in the above configuration. You can use the `psql` command to create a user and database.
+
+  - `psql postgres --u postgres`
+
+- Next, type this command for creating a new user with password then give access for creating the database.
+
+  - `postgres-# CREATE ROLE admin WITH LOGIN PASSWORD 'admin_pass';`
+  - `postgres-# ALTER ROLE admin CREATEDB;`
+
+- Quit `psql` then log in again using the new user that previously created.
+
+  - `postgres-# \q`
+  - `psql postgres -U admin`
+
+- Type this command to creating a new database.
+
+  - `postgres=> CREATE DATABASE db_nexus_school_management;`
+
+- Then give that new user privileges to the new database then quit the `psql`.
+  - `postgres=> GRANT ALL PRIVILEGES ON DATABASE db_nexus_school_management TO admin;`
+  - `postgres=> \q`
+
+---
+
+#### Api Documentation (Swagger)
+
+http://localhost:8080/api-docs (local host)
+
+http://host_name/api-docs
+
+---
+
+##### Setup database tables or update after schema change
+
+- `yarn db:migrate`
+
+##### Seed the initial data (admin accounts, relevant for the first setup):
+
+- `yarn db:seed`
+
+##### Start build:
+
+- `yarn start`

backend/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "nexusschoolmanagement",
+  "description": "Nexus school management - template backend",
+  "scripts": {
+    "start": "npm run db:migrate && npm run db:seed && npm run watch",
+    "db:migrate": "sequelize-cli db:migrate",
+    "db:seed": "sequelize-cli db:seed:all",
+    "db:drop": "sequelize-cli db:drop",
+    "db:create": "sequelize-cli db:create",
+    "watch": "node watcher.js"
+  },
+  "dependencies": {
+    "@google-cloud/storage": "^5.18.2",
+    "axios": "^1.6.7",
+    "bcrypt": "5.1.1",
+    "chokidar": "^4.0.3",
+    "cors": "2.8.5",
+    "csv-parser": "^3.0.0",
+    "express": "4.18.2",
+    "formidable": "1.2.2",
+    "helmet": "4.1.1",
+    "json2csv": "^5.0.7",
+    "jsonwebtoken": "8.5.1",
+    "lodash": "4.17.21",
+    "moment": "2.30.1",
+    "multer": "^1.4.4",
+    "mysql2": "2.2.5",
+    "nodemailer": "6.9.9",
+    "passport": "^0.7.0",
+    "passport-google-oauth2": "^0.2.0",
+    "passport-jwt": "^4.0.1",
+    "passport-microsoft": "^0.1.0",
+    "pg": "8.4.1",
+    "pg-hstore": "2.3.4",
+    "sequelize": "6.35.2",
+    "sequelize-json-schema": "^2.1.1",
+    "sqlite": "4.0.15",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.0",
+    "tedious": "^18.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "private": true,
+  "devDependencies": {
+    "cross-env": "7.0.3",
+    "mocha": "8.1.3",
+    "node-mocks-http": "1.9.0",
+    "nodemon": "2.0.5",
+    "sequelize-cli": "6.6.2"
+  }
+}

backend/src/auth/auth.js

@@ -0,0 +1,79 @@
+const config = require('../config');
+const providers = config.providers;
+const helpers = require('../helpers');
+const db = require('../db/models');
+
+const passport = require('passport');
+const JWTstrategy = require('passport-jwt').Strategy;
+const ExtractJWT = require('passport-jwt').ExtractJwt;
+const GoogleStrategy = require('passport-google-oauth2').Strategy;
+const MicrosoftStrategy = require('passport-microsoft').Strategy;
+const UsersDBApi = require('../db/api/users');
+
+passport.use(
+  new JWTstrategy(
+    {
+      passReqToCallback: true,
+      secretOrKey: config.secret_key,
+      jwtFromRequest: ExtractJWT.fromAuthHeaderAsBearerToken(),
+    },
+    async (req, token, done) => {
+      try {
+        const user = await UsersDBApi.findBy({ email: token.user.email });
+
+        if (user && user.disabled) {
+          return done(new Error(`User '${user.email}' is disabled`));
+        }
+
+        req.currentUser = user;
+
+        return done(null, user);
+      } catch (error) {
+        done(error);
+      }
+    },
+  ),
+);
+
+passport.use(
+  new GoogleStrategy(
+    {
+      clientID: config.google.clientId,
+      clientSecret: config.google.clientSecret,
+      callbackURL: config.apiUrl + '/auth/signin/google/callback',
+      passReqToCallback: true,
+    },
+    function (request, accessToken, refreshToken, profile, done) {
+      socialStrategy(profile.email, profile, providers.GOOGLE, done);
+    },
+  ),
+);
+
+passport.use(
+  new MicrosoftStrategy(
+    {
+      clientID: config.microsoft.clientId,
+      clientSecret: config.microsoft.clientSecret,
+      callbackURL: config.apiUrl + '/auth/signin/microsoft/callback',
+      passReqToCallback: true,
+    },
+    function (request, accessToken, refreshToken, profile, done) {
+      const email = profile._json.mail || profile._json.userPrincipalName;
+      socialStrategy(email, profile, providers.MICROSOFT, done);
+    },
+  ),
+);
+
+function socialStrategy(email, profile, provider, done) {
+  db.users
+    .findOrCreate({ where: { email, provider } })
+    .then(([user, created]) => {
+      const body = {
+        id: user.id,
+        email: user.email,
+        name: profile.displayName,
+      };
+      const token = helpers.jwtSign({ user: body });
+      return done(null, { token });
+    });
+}

backend/src/config.js

@@ -0,0 +1,75 @@
+const os = require('os');
+
+const config = {
+  gcloud: {
+    bucket: 'fldemo-files',
+    hash: '1d825218e913e151ac90d01b5a303f95',
+  },
+  bcrypt: {
+    saltRounds: 12,
+  },
+  admin_pass: '7c55a83d',
+  user_pass: 'fe8f9431a242',
+  admin_email: 'admin@flatlogic.com',
+  providers: {
+    LOCAL: 'local',
+    GOOGLE: 'google',
+    MICROSOFT: 'microsoft',
+  },
+  secret_key: process.env.SECRET_KEY || '',
+  remote: '',
+  port: process.env.NODE_ENV === 'production' ? '' : '8080',
+  hostUI: process.env.NODE_ENV === 'production' ? '' : 'http://localhost',
+  portUI: process.env.NODE_ENV === 'production' ? '' : '3000',
+
+  portUIProd: process.env.NODE_ENV === 'production' ? '' : ':3000',
+
+  swaggerUI: process.env.NODE_ENV === 'production' ? '' : 'http://localhost',
+  swaggerPort: process.env.NODE_ENV === 'production' ? '' : ':8080',
+  google: {
+    clientId: process.env.GOOGLE_CLIENT_ID || '',
+    clientSecret: process.env.GOOGLE_CLIENT_SECRET || '',
+  },
+  microsoft: {
+    clientId: process.env.MS_CLIENT_ID || '',
+    clientSecret: process.env.MS_CLIENT_SECRET || '',
+  },
+  uploadDir: os.tmpdir(),
+  email: {
+    from: 'Nexus school management <app@flatlogic.app>',
+    host: 'email-smtp.us-east-1.amazonaws.com',
+    port: 587,
+    auth: {
+      user: process.env.EMAIL_USER || '',
+      pass: process.env.EMAIL_PASS,
+    },
+    tls: {
+      rejectUnauthorized: false,
+    },
+  },
+  roles: {
+    super_admin: 'Super Administrator',
+
+    admin: 'Administrator',
+
+    user: 'Guardian',
+  },
+
+  project_uuid: '7c55a83d-5acf-40d5-8b78-fe8f9431a242',
+  flHost:
+    process.env.NODE_ENV === 'production' ||
+    process.env.NODE_ENV === 'dev_stage'
+      ? 'https://flatlogic.com/projects'
+      : 'http://localhost:3000/projects',
+};
+
+config.pexelsKey = process.env.PEXELS_KEY || '';
+config.pexelsQuery = 'Abstract school network concept';
+config.host =
+  process.env.NODE_ENV === 'production' ? config.remote : 'http://localhost';
+config.apiUrl = `${config.host}${config.port ? `:${config.port}` : ``}/api`;
+config.swaggerUrl = `${config.swaggerUI}${config.swaggerPort}`;
+config.uiUrl = `${config.hostUI}${config.portUI ? `:${config.portUI}` : ``}/#`;
+config.backUrl = `${config.hostUI}${config.portUI ? `:${config.portUI}` : ``}`;
+
+module.exports = config;

backend/src/db/api/activity_logs.js

@@ -0,0 +1,427 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Activity_logsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const activity_logs = await db.activity_logs.create(
+      {
+        id: data.id || undefined,
+
+        action: data.action || null,
+        entity_type: data.entity_type || null,
+        entity_id: data.entity_id || null,
+        timestamp: data.timestamp || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await activity_logs.setUser(data.user || null, {
+      transaction,
+    });
+
+    await activity_logs.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return activity_logs;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const activity_logsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      action: item.action || null,
+      entity_type: item.entity_type || null,
+      entity_id: item.entity_id || null,
+      timestamp: item.timestamp || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const activity_logs = await db.activity_logs.bulkCreate(activity_logsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return activity_logs;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const activity_logs = await db.activity_logs.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.action !== undefined) updatePayload.action = data.action;
+
+    if (data.entity_type !== undefined)
+      updatePayload.entity_type = data.entity_type;
+
+    if (data.entity_id !== undefined) updatePayload.entity_id = data.entity_id;
+
+    if (data.timestamp !== undefined) updatePayload.timestamp = data.timestamp;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await activity_logs.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await activity_logs.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await activity_logs.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return activity_logs;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const activity_logs = await db.activity_logs.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of activity_logs) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of activity_logs) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return activity_logs;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const activity_logs = await db.activity_logs.findByPk(id, options);
+
+    await activity_logs.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await activity_logs.destroy({
+      transaction,
+    });
+
+    return activity_logs;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const activity_logs = await db.activity_logs.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!activity_logs) {
+      return activity_logs;
+    }
+
+    const output = activity_logs.get({ plain: true });
+
+    output.user = await activity_logs.getUser({
+      transaction,
+    });
+
+    output.schools = await activity_logs.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.action) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('activity_logs', 'action', filter.action),
+        };
+      }
+
+      if (filter.entity_type) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'activity_logs',
+            'entity_type',
+            filter.entity_type,
+          ),
+        };
+      }
+
+      if (filter.entity_idRange) {
+        const [start, end] = filter.entity_idRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            entity_id: {
+              ...where.entity_id,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            entity_id: {
+              ...where.entity_id,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.timestampRange) {
+        const [start, end] = filter.timestampRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            timestamp: {
+              ...where.timestamp,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            timestamp: {
+              ...where.timestamp,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.activity_logs.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('activity_logs', 'action', query),
+        ],
+      };
+    }
+
+    const records = await db.activity_logs.findAll({
+      attributes: ['id', 'action'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['action', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.action,
+    }));
+  }
+};

backend/src/db/api/assignment_submissions.js

@@ -0,0 +1,477 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Assignment_submissionsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignment_submissions = await db.assignment_submissions.create(
+      {
+        id: data.id || undefined,
+
+        submission_date: data.submission_date || null,
+        content: data.content || null,
+        grade: data.grade || null,
+        feedback: data.feedback || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await assignment_submissions.setAssignment(data.assignment || null, {
+      transaction,
+    });
+
+    await assignment_submissions.setStudent(data.student || null, {
+      transaction,
+    });
+
+    await assignment_submissions.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return assignment_submissions;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const assignment_submissionsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      submission_date: item.submission_date || null,
+      content: item.content || null,
+      grade: item.grade || null,
+      feedback: item.feedback || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const assignment_submissions = await db.assignment_submissions.bulkCreate(
+      assignment_submissionsData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return assignment_submissions;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const assignment_submissions = await db.assignment_submissions.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.submission_date !== undefined)
+      updatePayload.submission_date = data.submission_date;
+
+    if (data.content !== undefined) updatePayload.content = data.content;
+
+    if (data.grade !== undefined) updatePayload.grade = data.grade;
+
+    if (data.feedback !== undefined) updatePayload.feedback = data.feedback;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await assignment_submissions.update(updatePayload, { transaction });
+
+    if (data.assignment !== undefined) {
+      await assignment_submissions.setAssignment(
+        data.assignment,
+
+        { transaction },
+      );
+    }
+
+    if (data.student !== undefined) {
+      await assignment_submissions.setStudent(
+        data.student,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await assignment_submissions.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return assignment_submissions;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignment_submissions = await db.assignment_submissions.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of assignment_submissions) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of assignment_submissions) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return assignment_submissions;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignment_submissions = await db.assignment_submissions.findByPk(
+      id,
+      options,
+    );
+
+    await assignment_submissions.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await assignment_submissions.destroy({
+      transaction,
+    });
+
+    return assignment_submissions;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignment_submissions = await db.assignment_submissions.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!assignment_submissions) {
+      return assignment_submissions;
+    }
+
+    const output = assignment_submissions.get({ plain: true });
+
+    output.assignment = await assignment_submissions.getAssignment({
+      transaction,
+    });
+
+    output.student = await assignment_submissions.getStudent({
+      transaction,
+    });
+
+    output.schools = await assignment_submissions.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.assignments,
+        as: 'assignment',
+
+        where: filter.assignment
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.assignment
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  title: {
+                    [Op.or]: filter.assignment
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.students,
+        as: 'student',
+
+        where: filter.student
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.student
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.student
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.content) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'assignment_submissions',
+            'content',
+            filter.content,
+          ),
+        };
+      }
+
+      if (filter.feedback) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'assignment_submissions',
+            'feedback',
+            filter.feedback,
+          ),
+        };
+      }
+
+      if (filter.submission_dateRange) {
+        const [start, end] = filter.submission_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            submission_date: {
+              ...where.submission_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            submission_date: {
+              ...where.submission_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.gradeRange) {
+        const [start, end] = filter.gradeRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            grade: {
+              ...where.grade,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            grade: {
+              ...where.grade,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.assignment_submissions.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('assignment_submissions', 'content', query),
+        ],
+      };
+    }
+
+    const records = await db.assignment_submissions.findAll({
+      attributes: ['id', 'content'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['content', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.content,
+    }));
+  }
+};

backend/src/db/api/assignments.js

@@ -0,0 +1,458 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class AssignmentsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignments = await db.assignments.create(
+      {
+        id: data.id || undefined,
+
+        title: data.title || null,
+        description: data.description || null,
+        due_date: data.due_date || null,
+        attachment_url: data.attachment_url || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await assignments.setTeacher(data.teacher || null, {
+      transaction,
+    });
+
+    await assignments.setSubject(data.subject || null, {
+      transaction,
+    });
+
+    await assignments.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return assignments;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const assignmentsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      title: item.title || null,
+      description: item.description || null,
+      due_date: item.due_date || null,
+      attachment_url: item.attachment_url || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const assignments = await db.assignments.bulkCreate(assignmentsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return assignments;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const assignments = await db.assignments.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.title !== undefined) updatePayload.title = data.title;
+
+    if (data.description !== undefined)
+      updatePayload.description = data.description;
+
+    if (data.due_date !== undefined) updatePayload.due_date = data.due_date;
+
+    if (data.attachment_url !== undefined)
+      updatePayload.attachment_url = data.attachment_url;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await assignments.update(updatePayload, { transaction });
+
+    if (data.teacher !== undefined) {
+      await assignments.setTeacher(
+        data.teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.subject !== undefined) {
+      await assignments.setSubject(
+        data.subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await assignments.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return assignments;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignments = await db.assignments.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of assignments) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of assignments) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return assignments;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignments = await db.assignments.findByPk(id, options);
+
+    await assignments.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await assignments.destroy({
+      transaction,
+    });
+
+    return assignments;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const assignments = await db.assignments.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!assignments) {
+      return assignments;
+    }
+
+    const output = assignments.get({ plain: true });
+
+    output.assignment_submissions_assignment =
+      await assignments.getAssignment_submissions_assignment({
+        transaction,
+      });
+
+    output.teacher = await assignments.getTeacher({
+      transaction,
+    });
+
+    output.subject = await assignments.getSubject({
+      transaction,
+    });
+
+    output.schools = await assignments.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.teachers,
+        as: 'teacher',
+
+        where: filter.teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.subjects,
+        as: 'subject',
+
+        where: filter.subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.title) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('assignments', 'title', filter.title),
+        };
+      }
+
+      if (filter.description) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'assignments',
+            'description',
+            filter.description,
+          ),
+        };
+      }
+
+      if (filter.attachment_url) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'assignments',
+            'attachment_url',
+            filter.attachment_url,
+          ),
+        };
+      }
+
+      if (filter.due_dateRange) {
+        const [start, end] = filter.due_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            due_date: {
+              ...where.due_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            due_date: {
+              ...where.due_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.assignments.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('assignments', 'title', query),
+        ],
+      };
+    }
+
+    const records = await db.assignments.findAll({
+      attributes: ['id', 'title'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['title', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.title,
+    }));
+  }
+};

backend/src/db/api/bills.js

@@ -0,0 +1,408 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class BillsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const bills = await db.bills.create(
+      {
+        id: data.id || undefined,
+
+        title: data.title || null,
+        amount: data.amount || null,
+        bill_month: data.bill_month || null,
+        category: data.category || null,
+        upload_url: data.upload_url || null,
+        status: data.status || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await bills.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await bills.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return bills;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const billsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      title: item.title || null,
+      amount: item.amount || null,
+      bill_month: item.bill_month || null,
+      category: item.category || null,
+      upload_url: item.upload_url || null,
+      status: item.status || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const bills = await db.bills.bulkCreate(billsData, { transaction });
+
+    // For each item created, replace relation files
+
+    return bills;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const bills = await db.bills.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.title !== undefined) updatePayload.title = data.title;
+
+    if (data.amount !== undefined) updatePayload.amount = data.amount;
+
+    if (data.bill_month !== undefined)
+      updatePayload.bill_month = data.bill_month;
+
+    if (data.category !== undefined) updatePayload.category = data.category;
+
+    if (data.upload_url !== undefined)
+      updatePayload.upload_url = data.upload_url;
+
+    if (data.status !== undefined) updatePayload.status = data.status;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await bills.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await bills.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await bills.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return bills;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const bills = await db.bills.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of bills) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of bills) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return bills;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const bills = await db.bills.findByPk(id, options);
+
+    await bills.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await bills.destroy({
+      transaction,
+    });
+
+    return bills;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const bills = await db.bills.findOne({ where }, { transaction });
+
+    if (!bills) {
+      return bills;
+    }
+
+    const output = bills.get({ plain: true });
+
+    output.school = await bills.getSchool({
+      transaction,
+    });
+
+    output.schools = await bills.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.title) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('bills', 'title', filter.title),
+        };
+      }
+
+      if (filter.bill_month) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('bills', 'bill_month', filter.bill_month),
+        };
+      }
+
+      if (filter.category) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('bills', 'category', filter.category),
+        };
+      }
+
+      if (filter.upload_url) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('bills', 'upload_url', filter.upload_url),
+        };
+      }
+
+      if (filter.amountRange) {
+        const [start, end] = filter.amountRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            amount: {
+              ...where.amount,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            amount: {
+              ...where.amount,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.status) {
+        where = {
+          ...where,
+          status: filter.status,
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.bills.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('bills', 'title', query),
+        ],
+      };
+    }
+
+    const records = await db.bills.findAll({
+      attributes: ['id', 'title'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['title', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.title,
+    }));
+  }
+};

backend/src/db/api/class_messages.js

@@ -0,0 +1,356 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Class_messagesDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_messages = await db.class_messages.create(
+      {
+        id: data.id || undefined,
+
+        content: data.content || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await class_messages.setSender(data.sender || null, {
+      transaction,
+    });
+
+    await class_messages.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return class_messages;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const class_messagesData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      content: item.content || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const class_messages = await db.class_messages.bulkCreate(
+      class_messagesData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return class_messages;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const class_messages = await db.class_messages.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.content !== undefined) updatePayload.content = data.content;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await class_messages.update(updatePayload, { transaction });
+
+    if (data.sender !== undefined) {
+      await class_messages.setSender(
+        data.sender,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await class_messages.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return class_messages;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_messages = await db.class_messages.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of class_messages) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of class_messages) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return class_messages;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_messages = await db.class_messages.findByPk(id, options);
+
+    await class_messages.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await class_messages.destroy({
+      transaction,
+    });
+
+    return class_messages;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_messages = await db.class_messages.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!class_messages) {
+      return class_messages;
+    }
+
+    const output = class_messages.get({ plain: true });
+
+    output.sender = await class_messages.getSender({
+      transaction,
+    });
+
+    output.schools = await class_messages.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'sender',
+
+        where: filter.sender
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.sender
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.sender
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.content) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('class_messages', 'content', filter.content),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.class_messages.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('class_messages', 'content', query),
+        ],
+      };
+    }
+
+    const records = await db.class_messages.findAll({
+      attributes: ['id', 'content'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['content', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.content,
+    }));
+  }
+};

backend/src/db/api/class_subjects.js

@@ -0,0 +1,387 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Class_subjectsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_subjects = await db.class_subjects.create(
+      {
+        id: data.id || undefined,
+
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await class_subjects.setSubject(data.subject || null, {
+      transaction,
+    });
+
+    await class_subjects.setTeacher(data.teacher || null, {
+      transaction,
+    });
+
+    await class_subjects.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return class_subjects;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const class_subjectsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const class_subjects = await db.class_subjects.bulkCreate(
+      class_subjectsData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return class_subjects;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const class_subjects = await db.class_subjects.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    updatePayload.updatedById = currentUser.id;
+
+    await class_subjects.update(updatePayload, { transaction });
+
+    if (data.subject !== undefined) {
+      await class_subjects.setSubject(
+        data.subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.teacher !== undefined) {
+      await class_subjects.setTeacher(
+        data.teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await class_subjects.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return class_subjects;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_subjects = await db.class_subjects.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of class_subjects) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of class_subjects) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return class_subjects;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_subjects = await db.class_subjects.findByPk(id, options);
+
+    await class_subjects.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await class_subjects.destroy({
+      transaction,
+    });
+
+    return class_subjects;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const class_subjects = await db.class_subjects.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!class_subjects) {
+      return class_subjects;
+    }
+
+    const output = class_subjects.get({ plain: true });
+
+    output.subject = await class_subjects.getSubject({
+      transaction,
+    });
+
+    output.teacher = await class_subjects.getTeacher({
+      transaction,
+    });
+
+    output.schools = await class_subjects.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.subjects,
+        as: 'subject',
+
+        where: filter.subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.teachers,
+        as: 'teacher',
+
+        where: filter.teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.class_subjects.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('class_subjects', 'id', query),
+        ],
+      };
+    }
+
+    const records = await db.class_subjects.findAll({
+      attributes: ['id', 'id'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['id', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.id,
+    }));
+  }
+};

backend/src/db/api/classes.js

@@ -0,0 +1,387 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class ClassesDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const classes = await db.classes.create(
+      {
+        id: data.id || undefined,
+
+        name: data.name || null,
+        section: data.section || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await classes.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await classes.setClass_teacher(data.class_teacher || null, {
+      transaction,
+    });
+
+    await classes.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return classes;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const classesData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      name: item.name || null,
+      section: item.section || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const classes = await db.classes.bulkCreate(classesData, { transaction });
+
+    // For each item created, replace relation files
+
+    return classes;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const classes = await db.classes.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.name !== undefined) updatePayload.name = data.name;
+
+    if (data.section !== undefined) updatePayload.section = data.section;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await classes.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await classes.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.class_teacher !== undefined) {
+      await classes.setClass_teacher(
+        data.class_teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await classes.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return classes;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const classes = await db.classes.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of classes) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of classes) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return classes;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const classes = await db.classes.findByPk(id, options);
+
+    await classes.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await classes.destroy({
+      transaction,
+    });
+
+    return classes;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const classes = await db.classes.findOne({ where }, { transaction });
+
+    if (!classes) {
+      return classes;
+    }
+
+    const output = classes.get({ plain: true });
+
+    output.school = await classes.getSchool({
+      transaction,
+    });
+
+    output.class_teacher = await classes.getClass_teacher({
+      transaction,
+    });
+
+    output.schools = await classes.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.teachers,
+        as: 'class_teacher',
+
+        where: filter.class_teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.class_teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.class_teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('classes', 'name', filter.name),
+        };
+      }
+
+      if (filter.section) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('classes', 'section', filter.section),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.classes.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('classes', 'name', query),
+        ],
+      };
+    }
+
+    const records = await db.classes.findAll({
+      attributes: ['id', 'name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.name,
+    }));
+  }
+};

backend/src/db/api/exam_subjects.js

@@ -0,0 +1,446 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Exam_subjectsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exam_subjects = await db.exam_subjects.create(
+      {
+        id: data.id || undefined,
+
+        exam_date: data.exam_date || null,
+        max_marks: data.max_marks || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await exam_subjects.setExam(data.exam || null, {
+      transaction,
+    });
+
+    await exam_subjects.setSubject(data.subject || null, {
+      transaction,
+    });
+
+    await exam_subjects.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return exam_subjects;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const exam_subjectsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      exam_date: item.exam_date || null,
+      max_marks: item.max_marks || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const exam_subjects = await db.exam_subjects.bulkCreate(exam_subjectsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return exam_subjects;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const exam_subjects = await db.exam_subjects.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.exam_date !== undefined) updatePayload.exam_date = data.exam_date;
+
+    if (data.max_marks !== undefined) updatePayload.max_marks = data.max_marks;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await exam_subjects.update(updatePayload, { transaction });
+
+    if (data.exam !== undefined) {
+      await exam_subjects.setExam(
+        data.exam,
+
+        { transaction },
+      );
+    }
+
+    if (data.subject !== undefined) {
+      await exam_subjects.setSubject(
+        data.subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await exam_subjects.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return exam_subjects;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exam_subjects = await db.exam_subjects.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of exam_subjects) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of exam_subjects) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return exam_subjects;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exam_subjects = await db.exam_subjects.findByPk(id, options);
+
+    await exam_subjects.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await exam_subjects.destroy({
+      transaction,
+    });
+
+    return exam_subjects;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const exam_subjects = await db.exam_subjects.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!exam_subjects) {
+      return exam_subjects;
+    }
+
+    const output = exam_subjects.get({ plain: true });
+
+    output.marks_exam_subject = await exam_subjects.getMarks_exam_subject({
+      transaction,
+    });
+
+    output.exam = await exam_subjects.getExam({
+      transaction,
+    });
+
+    output.subject = await exam_subjects.getSubject({
+      transaction,
+    });
+
+    output.schools = await exam_subjects.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.exams,
+        as: 'exam',
+
+        where: filter.exam
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.exam
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  title: {
+                    [Op.or]: filter.exam
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.subjects,
+        as: 'subject',
+
+        where: filter.subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.exam_dateRange) {
+        const [start, end] = filter.exam_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            exam_date: {
+              ...where.exam_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            exam_date: {
+              ...where.exam_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.max_marksRange) {
+        const [start, end] = filter.max_marksRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            max_marks: {
+              ...where.max_marks,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            max_marks: {
+              ...where.max_marks,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.exam_subjects.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('exam_subjects', 'subject', query),
+        ],
+      };
+    }
+
+    const records = await db.exam_subjects.findAll({
+      attributes: ['id', 'subject'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['subject', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.subject,
+    }));
+  }
+};

backend/src/db/api/exams.js

@@ -0,0 +1,424 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class ExamsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exams = await db.exams.create(
+      {
+        id: data.id || undefined,
+
+        title: data.title || null,
+        start_date: data.start_date || null,
+        end_date: data.end_date || null,
+        term: data.term || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await exams.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await exams.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return exams;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const examsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      title: item.title || null,
+      start_date: item.start_date || null,
+      end_date: item.end_date || null,
+      term: item.term || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const exams = await db.exams.bulkCreate(examsData, { transaction });
+
+    // For each item created, replace relation files
+
+    return exams;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const exams = await db.exams.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.title !== undefined) updatePayload.title = data.title;
+
+    if (data.start_date !== undefined)
+      updatePayload.start_date = data.start_date;
+
+    if (data.end_date !== undefined) updatePayload.end_date = data.end_date;
+
+    if (data.term !== undefined) updatePayload.term = data.term;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await exams.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await exams.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await exams.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return exams;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exams = await db.exams.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of exams) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of exams) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return exams;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const exams = await db.exams.findByPk(id, options);
+
+    await exams.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await exams.destroy({
+      transaction,
+    });
+
+    return exams;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const exams = await db.exams.findOne({ where }, { transaction });
+
+    if (!exams) {
+      return exams;
+    }
+
+    const output = exams.get({ plain: true });
+
+    output.exam_subjects_exam = await exams.getExam_subjects_exam({
+      transaction,
+    });
+
+    output.school = await exams.getSchool({
+      transaction,
+    });
+
+    output.schools = await exams.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.title) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('exams', 'title', filter.title),
+        };
+      }
+
+      if (filter.term) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('exams', 'term', filter.term),
+        };
+      }
+
+      if (filter.calendarStart && filter.calendarEnd) {
+        where = {
+          ...where,
+          [Op.or]: [
+            {
+              start_date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+            {
+              end_date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+          ],
+        };
+      }
+
+      if (filter.start_dateRange) {
+        const [start, end] = filter.start_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            start_date: {
+              ...where.start_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            start_date: {
+              ...where.start_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.end_dateRange) {
+        const [start, end] = filter.end_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            end_date: {
+              ...where.end_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            end_date: {
+              ...where.end_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.exams.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('exams', 'title', query),
+        ],
+      };
+    }
+
+    const records = await db.exams.findAll({
+      attributes: ['id', 'title'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['title', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.title,
+    }));
+  }
+};

backend/src/db/api/fee_payments.js

@@ -0,0 +1,440 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Fee_paymentsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_payments = await db.fee_payments.create(
+      {
+        id: data.id || undefined,
+
+        amount_paid: data.amount_paid || null,
+        payment_date: data.payment_date || null,
+        receipt_url: data.receipt_url || null,
+        term: data.term || null,
+        status: data.status || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await fee_payments.setStudent(data.student || null, {
+      transaction,
+    });
+
+    await fee_payments.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return fee_payments;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const fee_paymentsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      amount_paid: item.amount_paid || null,
+      payment_date: item.payment_date || null,
+      receipt_url: item.receipt_url || null,
+      term: item.term || null,
+      status: item.status || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const fee_payments = await db.fee_payments.bulkCreate(fee_paymentsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return fee_payments;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const fee_payments = await db.fee_payments.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.amount_paid !== undefined)
+      updatePayload.amount_paid = data.amount_paid;
+
+    if (data.payment_date !== undefined)
+      updatePayload.payment_date = data.payment_date;
+
+    if (data.receipt_url !== undefined)
+      updatePayload.receipt_url = data.receipt_url;
+
+    if (data.term !== undefined) updatePayload.term = data.term;
+
+    if (data.status !== undefined) updatePayload.status = data.status;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await fee_payments.update(updatePayload, { transaction });
+
+    if (data.student !== undefined) {
+      await fee_payments.setStudent(
+        data.student,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await fee_payments.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return fee_payments;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_payments = await db.fee_payments.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of fee_payments) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of fee_payments) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return fee_payments;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_payments = await db.fee_payments.findByPk(id, options);
+
+    await fee_payments.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await fee_payments.destroy({
+      transaction,
+    });
+
+    return fee_payments;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_payments = await db.fee_payments.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!fee_payments) {
+      return fee_payments;
+    }
+
+    const output = fee_payments.get({ plain: true });
+
+    output.student = await fee_payments.getStudent({
+      transaction,
+    });
+
+    output.schools = await fee_payments.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.students,
+        as: 'student',
+
+        where: filter.student
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.student
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.student
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.receipt_url) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'fee_payments',
+            'receipt_url',
+            filter.receipt_url,
+          ),
+        };
+      }
+
+      if (filter.term) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('fee_payments', 'term', filter.term),
+        };
+      }
+
+      if (filter.amount_paidRange) {
+        const [start, end] = filter.amount_paidRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            amount_paid: {
+              ...where.amount_paid,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            amount_paid: {
+              ...where.amount_paid,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.payment_dateRange) {
+        const [start, end] = filter.payment_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            payment_date: {
+              ...where.payment_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            payment_date: {
+              ...where.payment_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.status) {
+        where = {
+          ...where,
+          status: filter.status,
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.fee_payments.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('fee_payments', 'term', query),
+        ],
+      };
+    }
+
+    const records = await db.fee_payments.findAll({
+      attributes: ['id', 'term'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['term', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.term,
+    }));
+  }
+};

backend/src/db/api/fee_structures.js

@@ -0,0 +1,374 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Fee_structuresDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_structures = await db.fee_structures.create(
+      {
+        id: data.id || undefined,
+
+        term: data.term || null,
+        amount: data.amount || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await fee_structures.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await fee_structures.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return fee_structures;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const fee_structuresData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      term: item.term || null,
+      amount: item.amount || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const fee_structures = await db.fee_structures.bulkCreate(
+      fee_structuresData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return fee_structures;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const fee_structures = await db.fee_structures.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.term !== undefined) updatePayload.term = data.term;
+
+    if (data.amount !== undefined) updatePayload.amount = data.amount;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await fee_structures.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await fee_structures.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await fee_structures.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return fee_structures;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_structures = await db.fee_structures.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of fee_structures) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of fee_structures) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return fee_structures;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_structures = await db.fee_structures.findByPk(id, options);
+
+    await fee_structures.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await fee_structures.destroy({
+      transaction,
+    });
+
+    return fee_structures;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const fee_structures = await db.fee_structures.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!fee_structures) {
+      return fee_structures;
+    }
+
+    const output = fee_structures.get({ plain: true });
+
+    output.school = await fee_structures.getSchool({
+      transaction,
+    });
+
+    output.schools = await fee_structures.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.term) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('fee_structures', 'term', filter.term),
+        };
+      }
+
+      if (filter.amountRange) {
+        const [start, end] = filter.amountRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            amount: {
+              ...where.amount,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            amount: {
+              ...where.amount,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.fee_structures.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('fee_structures', 'term', query),
+        ],
+      };
+    }
+
+    const records = await db.fee_structures.findAll({
+      attributes: ['id', 'term'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['term', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.term,
+    }));
+  }
+};

backend/src/db/api/file.js

@@ -0,0 +1,73 @@
+const db = require('../models');
+const assert = require('assert');
+const services = require('../../services/file');
+
+module.exports = class FileDBApi {
+  static async replaceRelationFiles(relation, rawFiles, options) {
+    assert(relation.belongsTo, 'belongsTo is required');
+    assert(relation.belongsToColumn, 'belongsToColumn is required');
+    assert(relation.belongsToId, 'belongsToId is required');
+
+    let files = [];
+
+    if (Array.isArray(rawFiles)) {
+      files = rawFiles;
+    } else {
+      files = rawFiles ? [rawFiles] : [];
+    }
+
+    await this._removeLegacyFiles(relation, files, options);
+    await this._addFiles(relation, files, options);
+  }
+
+  static async _addFiles(relation, files, options) {
+    const transaction = (options && options.transaction) || undefined;
+    const currentUser = (options && options.currentUser) || { id: null };
+
+    const inexistentFiles = files.filter((file) => !!file.new);
+
+    for (const file of inexistentFiles) {
+      await db.file.create(
+        {
+          belongsTo: relation.belongsTo,
+          belongsToColumn: relation.belongsToColumn,
+          belongsToId: relation.belongsToId,
+          name: file.name,
+          sizeInBytes: file.sizeInBytes,
+          privateUrl: file.privateUrl,
+          publicUrl: file.publicUrl,
+          createdById: currentUser.id,
+          updatedById: currentUser.id,
+        },
+        {
+          transaction,
+        },
+      );
+    }
+  }
+
+  static async _removeLegacyFiles(relation, files, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const filesToDelete = await db.file.findAll({
+      where: {
+        belongsTo: relation.belongsTo,
+        belongsToId: relation.belongsToId,
+        belongsToColumn: relation.belongsToColumn,
+        id: {
+          [db.Sequelize.Op.notIn]: files
+            .filter((file) => !file.new)
+            .map((file) => file.id),
+        },
+      },
+      transaction,
+    });
+
+    for (let file of filesToDelete) {
+      await services.deleteGCloud(file.privateUrl);
+      await file.destroy({
+        transaction,
+      });
+    }
+  }
+};

backend/src/db/api/lesson_plans.js

@@ -0,0 +1,442 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Lesson_plansDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const lesson_plans = await db.lesson_plans.create(
+      {
+        id: data.id || undefined,
+
+        week_start_date: data.week_start_date || null,
+        plan_content: data.plan_content || null,
+        status: data.status || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await lesson_plans.setTeacher(data.teacher || null, {
+      transaction,
+    });
+
+    await lesson_plans.setSubject(data.subject || null, {
+      transaction,
+    });
+
+    await lesson_plans.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return lesson_plans;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const lesson_plansData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      week_start_date: item.week_start_date || null,
+      plan_content: item.plan_content || null,
+      status: item.status || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const lesson_plans = await db.lesson_plans.bulkCreate(lesson_plansData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return lesson_plans;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const lesson_plans = await db.lesson_plans.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.week_start_date !== undefined)
+      updatePayload.week_start_date = data.week_start_date;
+
+    if (data.plan_content !== undefined)
+      updatePayload.plan_content = data.plan_content;
+
+    if (data.status !== undefined) updatePayload.status = data.status;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await lesson_plans.update(updatePayload, { transaction });
+
+    if (data.teacher !== undefined) {
+      await lesson_plans.setTeacher(
+        data.teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.subject !== undefined) {
+      await lesson_plans.setSubject(
+        data.subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await lesson_plans.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return lesson_plans;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const lesson_plans = await db.lesson_plans.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of lesson_plans) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of lesson_plans) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return lesson_plans;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const lesson_plans = await db.lesson_plans.findByPk(id, options);
+
+    await lesson_plans.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await lesson_plans.destroy({
+      transaction,
+    });
+
+    return lesson_plans;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const lesson_plans = await db.lesson_plans.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!lesson_plans) {
+      return lesson_plans;
+    }
+
+    const output = lesson_plans.get({ plain: true });
+
+    output.teacher = await lesson_plans.getTeacher({
+      transaction,
+    });
+
+    output.subject = await lesson_plans.getSubject({
+      transaction,
+    });
+
+    output.schools = await lesson_plans.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.teachers,
+        as: 'teacher',
+
+        where: filter.teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.subjects,
+        as: 'subject',
+
+        where: filter.subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.plan_content) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'lesson_plans',
+            'plan_content',
+            filter.plan_content,
+          ),
+        };
+      }
+
+      if (filter.week_start_dateRange) {
+        const [start, end] = filter.week_start_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            week_start_date: {
+              ...where.week_start_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            week_start_date: {
+              ...where.week_start_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.status) {
+        where = {
+          ...where,
+          status: filter.status,
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.lesson_plans.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('lesson_plans', 'plan_content', query),
+        ],
+      };
+    }
+
+    const records = await db.lesson_plans.findAll({
+      attributes: ['id', 'plan_content'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['plan_content', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.plan_content,
+    }));
+  }
+};

backend/src/db/api/login_logs.js

@@ -0,0 +1,392 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Login_logsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const login_logs = await db.login_logs.create(
+      {
+        id: data.id || undefined,
+
+        login_time: data.login_time || null,
+        ip_address: data.ip_address || null,
+        device_info: data.device_info || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await login_logs.setUser(data.user || null, {
+      transaction,
+    });
+
+    await login_logs.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return login_logs;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const login_logsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      login_time: item.login_time || null,
+      ip_address: item.ip_address || null,
+      device_info: item.device_info || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const login_logs = await db.login_logs.bulkCreate(login_logsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return login_logs;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const login_logs = await db.login_logs.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.login_time !== undefined)
+      updatePayload.login_time = data.login_time;
+
+    if (data.ip_address !== undefined)
+      updatePayload.ip_address = data.ip_address;
+
+    if (data.device_info !== undefined)
+      updatePayload.device_info = data.device_info;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await login_logs.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await login_logs.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await login_logs.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return login_logs;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const login_logs = await db.login_logs.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of login_logs) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of login_logs) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return login_logs;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const login_logs = await db.login_logs.findByPk(id, options);
+
+    await login_logs.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await login_logs.destroy({
+      transaction,
+    });
+
+    return login_logs;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const login_logs = await db.login_logs.findOne({ where }, { transaction });
+
+    if (!login_logs) {
+      return login_logs;
+    }
+
+    const output = login_logs.get({ plain: true });
+
+    output.user = await login_logs.getUser({
+      transaction,
+    });
+
+    output.schools = await login_logs.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.ip_address) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('login_logs', 'ip_address', filter.ip_address),
+        };
+      }
+
+      if (filter.device_info) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'login_logs',
+            'device_info',
+            filter.device_info,
+          ),
+        };
+      }
+
+      if (filter.login_timeRange) {
+        const [start, end] = filter.login_timeRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            login_time: {
+              ...where.login_time,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            login_time: {
+              ...where.login_time,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.login_logs.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('login_logs', 'ip_address', query),
+        ],
+      };
+    }
+
+    const records = await db.login_logs.findAll({
+      attributes: ['id', 'ip_address'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['ip_address', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.ip_address,
+    }));
+  }
+};

backend/src/db/api/marks.js

@@ -0,0 +1,404 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class MarksDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const marks = await db.marks.create(
+      {
+        id: data.id || undefined,
+
+        marks_obtained: data.marks_obtained || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await marks.setStudent(data.student || null, {
+      transaction,
+    });
+
+    await marks.setExam_subject(data.exam_subject || null, {
+      transaction,
+    });
+
+    await marks.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return marks;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const marksData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      marks_obtained: item.marks_obtained || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const marks = await db.marks.bulkCreate(marksData, { transaction });
+
+    // For each item created, replace relation files
+
+    return marks;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const marks = await db.marks.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.marks_obtained !== undefined)
+      updatePayload.marks_obtained = data.marks_obtained;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await marks.update(updatePayload, { transaction });
+
+    if (data.student !== undefined) {
+      await marks.setStudent(
+        data.student,
+
+        { transaction },
+      );
+    }
+
+    if (data.exam_subject !== undefined) {
+      await marks.setExam_subject(
+        data.exam_subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await marks.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return marks;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const marks = await db.marks.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of marks) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of marks) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return marks;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const marks = await db.marks.findByPk(id, options);
+
+    await marks.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await marks.destroy({
+      transaction,
+    });
+
+    return marks;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const marks = await db.marks.findOne({ where }, { transaction });
+
+    if (!marks) {
+      return marks;
+    }
+
+    const output = marks.get({ plain: true });
+
+    output.student = await marks.getStudent({
+      transaction,
+    });
+
+    output.exam_subject = await marks.getExam_subject({
+      transaction,
+    });
+
+    output.schools = await marks.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.students,
+        as: 'student',
+
+        where: filter.student
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.student
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.student
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.exam_subjects,
+        as: 'exam_subject',
+
+        where: filter.exam_subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.exam_subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  subject: {
+                    [Op.or]: filter.exam_subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.marks_obtainedRange) {
+        const [start, end] = filter.marks_obtainedRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            marks_obtained: {
+              ...where.marks_obtained,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            marks_obtained: {
+              ...where.marks_obtained,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.marks.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('marks', 'marks_obtained', query),
+        ],
+      };
+    }
+
+    const records = await db.marks.findAll({
+      attributes: ['id', 'marks_obtained'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['marks_obtained', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.marks_obtained,
+    }));
+  }
+};

backend/src/db/api/messages.js

@@ -0,0 +1,444 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class MessagesDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const messages = await db.messages.create(
+      {
+        id: data.id || undefined,
+
+        receiver_role: data.receiver_role || null,
+        message_type: data.message_type || null,
+        content: data.content || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await messages.setSender(data.sender || null, {
+      transaction,
+    });
+
+    await messages.setReceiver(data.receiver || null, {
+      transaction,
+    });
+
+    await messages.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await messages.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return messages;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const messagesData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      receiver_role: item.receiver_role || null,
+      message_type: item.message_type || null,
+      content: item.content || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const messages = await db.messages.bulkCreate(messagesData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return messages;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const messages = await db.messages.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.receiver_role !== undefined)
+      updatePayload.receiver_role = data.receiver_role;
+
+    if (data.message_type !== undefined)
+      updatePayload.message_type = data.message_type;
+
+    if (data.content !== undefined) updatePayload.content = data.content;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await messages.update(updatePayload, { transaction });
+
+    if (data.sender !== undefined) {
+      await messages.setSender(
+        data.sender,
+
+        { transaction },
+      );
+    }
+
+    if (data.receiver !== undefined) {
+      await messages.setReceiver(
+        data.receiver,
+
+        { transaction },
+      );
+    }
+
+    if (data.school !== undefined) {
+      await messages.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await messages.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return messages;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const messages = await db.messages.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of messages) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of messages) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return messages;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const messages = await db.messages.findByPk(id, options);
+
+    await messages.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await messages.destroy({
+      transaction,
+    });
+
+    return messages;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const messages = await db.messages.findOne({ where }, { transaction });
+
+    if (!messages) {
+      return messages;
+    }
+
+    const output = messages.get({ plain: true });
+
+    output.sender = await messages.getSender({
+      transaction,
+    });
+
+    output.receiver = await messages.getReceiver({
+      transaction,
+    });
+
+    output.school = await messages.getSchool({
+      transaction,
+    });
+
+    output.schools = await messages.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'sender',
+
+        where: filter.sender
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.sender
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.sender
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.users,
+        as: 'receiver',
+
+        where: filter.receiver
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.receiver
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.receiver
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.content) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('messages', 'content', filter.content),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.receiver_role) {
+        where = {
+          ...where,
+          receiver_role: filter.receiver_role,
+        };
+      }
+
+      if (filter.message_type) {
+        where = {
+          ...where,
+          message_type: filter.message_type,
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.messages.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('messages', 'content', query),
+        ],
+      };
+    }
+
+    const records = await db.messages.findAll({
+      attributes: ['id', 'content'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['content', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.content,
+    }));
+  }
+};

backend/src/db/api/parents.js

@@ -0,0 +1,371 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class ParentsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const parents = await db.parents.create(
+      {
+        id: data.id || undefined,
+
+        full_name: data.full_name || null,
+        phone_number: data.phone_number || null,
+        address: data.address || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await parents.setUser(data.user || null, {
+      transaction,
+    });
+
+    await parents.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return parents;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const parentsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      full_name: item.full_name || null,
+      phone_number: item.phone_number || null,
+      address: item.address || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const parents = await db.parents.bulkCreate(parentsData, { transaction });
+
+    // For each item created, replace relation files
+
+    return parents;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const parents = await db.parents.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.full_name !== undefined) updatePayload.full_name = data.full_name;
+
+    if (data.phone_number !== undefined)
+      updatePayload.phone_number = data.phone_number;
+
+    if (data.address !== undefined) updatePayload.address = data.address;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await parents.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await parents.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await parents.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return parents;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const parents = await db.parents.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of parents) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of parents) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return parents;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const parents = await db.parents.findByPk(id, options);
+
+    await parents.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await parents.destroy({
+      transaction,
+    });
+
+    return parents;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const parents = await db.parents.findOne({ where }, { transaction });
+
+    if (!parents) {
+      return parents;
+    }
+
+    const output = parents.get({ plain: true });
+
+    output.students_parent = await parents.getStudents_parent({
+      transaction,
+    });
+
+    output.user = await parents.getUser({
+      transaction,
+    });
+
+    output.schools = await parents.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.full_name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('parents', 'full_name', filter.full_name),
+        };
+      }
+
+      if (filter.phone_number) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('parents', 'phone_number', filter.phone_number),
+        };
+      }
+
+      if (filter.address) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('parents', 'address', filter.address),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.parents.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('parents', 'full_name', query),
+        ],
+      };
+    }
+
+    const records = await db.parents.findAll({
+      attributes: ['id', 'full_name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['full_name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.full_name,
+    }));
+  }
+};

backend/src/db/api/period_settings.js

@@ -0,0 +1,393 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Period_settingsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const period_settings = await db.period_settings.create(
+      {
+        id: data.id || undefined,
+
+        total_periods_per_day: data.total_periods_per_day || null,
+        period_duration: data.period_duration || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await period_settings.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await period_settings.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return period_settings;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const period_settingsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      total_periods_per_day: item.total_periods_per_day || null,
+      period_duration: item.period_duration || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const period_settings = await db.period_settings.bulkCreate(
+      period_settingsData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return period_settings;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const period_settings = await db.period_settings.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.total_periods_per_day !== undefined)
+      updatePayload.total_periods_per_day = data.total_periods_per_day;
+
+    if (data.period_duration !== undefined)
+      updatePayload.period_duration = data.period_duration;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await period_settings.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await period_settings.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await period_settings.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return period_settings;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const period_settings = await db.period_settings.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of period_settings) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of period_settings) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return period_settings;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const period_settings = await db.period_settings.findByPk(id, options);
+
+    await period_settings.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await period_settings.destroy({
+      transaction,
+    });
+
+    return period_settings;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const period_settings = await db.period_settings.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!period_settings) {
+      return period_settings;
+    }
+
+    const output = period_settings.get({ plain: true });
+
+    output.school = await period_settings.getSchool({
+      transaction,
+    });
+
+    output.schools = await period_settings.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.total_periods_per_dayRange) {
+        const [start, end] = filter.total_periods_per_dayRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            total_periods_per_day: {
+              ...where.total_periods_per_day,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            total_periods_per_day: {
+              ...where.total_periods_per_day,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.period_durationRange) {
+        const [start, end] = filter.period_durationRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            period_duration: {
+              ...where.period_duration,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            period_duration: {
+              ...where.period_duration,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.period_settings.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('period_settings', 'school', query),
+        ],
+      };
+    }
+
+    const records = await db.period_settings.findAll({
+      attributes: ['id', 'school'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['school', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.school,
+    }));
+  }
+};

backend/src/db/api/permissions.js

@@ -0,0 +1,257 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class PermissionsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const permissions = await db.permissions.create(
+      {
+        id: data.id || undefined,
+
+        name: data.name || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    return permissions;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const permissionsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      name: item.name || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const permissions = await db.permissions.bulkCreate(permissionsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return permissions;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const permissions = await db.permissions.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.name !== undefined) updatePayload.name = data.name;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await permissions.update(updatePayload, { transaction });
+
+    return permissions;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const permissions = await db.permissions.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of permissions) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of permissions) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return permissions;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const permissions = await db.permissions.findByPk(id, options);
+
+    await permissions.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await permissions.destroy({
+      transaction,
+    });
+
+    return permissions;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const permissions = await db.permissions.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!permissions) {
+      return permissions;
+    }
+
+    const output = permissions.get({ plain: true });
+
+    return output;
+  }
+
+  static async findAll(filter, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('permissions', 'name', filter.name),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.permissions.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(query, limit, offset) {
+    let where = {};
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('permissions', 'name', query),
+        ],
+      };
+    }
+
+    const records = await db.permissions.findAll({
+      attributes: ['id', 'name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.name,
+    }));
+  }
+};

backend/src/db/api/roles.js

@@ -0,0 +1,344 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const config = require('../../config');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class RolesDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const roles = await db.roles.create(
+      {
+        id: data.id || undefined,
+
+        name: data.name || null,
+        role_customization: data.role_customization || null,
+        globalAccess: data.globalAccess || false,
+
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await roles.setPermissions(data.permissions || [], {
+      transaction,
+    });
+
+    return roles;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const rolesData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      name: item.name || null,
+      role_customization: item.role_customization || null,
+      globalAccess: item.globalAccess || false,
+
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const roles = await db.roles.bulkCreate(rolesData, { transaction });
+
+    // For each item created, replace relation files
+
+    return roles;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const roles = await db.roles.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.name !== undefined) updatePayload.name = data.name;
+
+    if (data.role_customization !== undefined)
+      updatePayload.role_customization = data.role_customization;
+
+    if (data.globalAccess !== undefined)
+      updatePayload.globalAccess = data.globalAccess;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await roles.update(updatePayload, { transaction });
+
+    if (data.permissions !== undefined) {
+      await roles.setPermissions(data.permissions, { transaction });
+    }
+
+    return roles;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const roles = await db.roles.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of roles) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of roles) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return roles;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const roles = await db.roles.findByPk(id, options);
+
+    await roles.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await roles.destroy({
+      transaction,
+    });
+
+    return roles;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const roles = await db.roles.findOne({ where }, { transaction });
+
+    if (!roles) {
+      return roles;
+    }
+
+    const output = roles.get({ plain: true });
+
+    output.users_app_role = await roles.getUsers_app_role({
+      transaction,
+    });
+
+    output.permissions = await roles.getPermissions({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.permissions,
+        as: 'permissions',
+        required: false,
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('roles', 'name', filter.name),
+        };
+      }
+
+      if (filter.role_customization) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'roles',
+            'role_customization',
+            filter.role_customization,
+          ),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.globalAccess) {
+        where = {
+          ...where,
+          globalAccess: filter.globalAccess,
+        };
+      }
+
+      if (filter.permissions) {
+        const searchTerms = filter.permissions.split('|');
+
+        include = [
+          {
+            model: db.permissions,
+            as: 'permissions_filter',
+            required: searchTerms.length > 0,
+            where:
+              searchTerms.length > 0
+                ? {
+                    [Op.or]: [
+                      {
+                        id: {
+                          [Op.in]: searchTerms.map((term) => Utils.uuid(term)),
+                        },
+                      },
+                      {
+                        name: {
+                          [Op.or]: searchTerms.map((term) => ({
+                            [Op.iLike]: `%${term}%`,
+                          })),
+                        },
+                      },
+                    ],
+                  }
+                : undefined,
+          },
+          ...include,
+        ];
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (!globalAccess) {
+      where = { name: { [Op.ne]: config.roles.super_admin } };
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.roles.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(query, limit, offset, globalAccess) {
+    let where = {};
+
+    if (!globalAccess) {
+      where = { name: { [Op.ne]: config.roles.super_admin } };
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('roles', 'name', query),
+        ],
+      };
+    }
+
+    const records = await db.roles.findAll({
+      attributes: ['id', 'name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.name,
+    }));
+  }
+};

backend/src/db/api/school_admins.js

@@ -0,0 +1,403 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class School_adminsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const school_admins = await db.school_admins.create(
+      {
+        id: data.id || undefined,
+
+        full_name: data.full_name || null,
+        phone_number: data.phone_number || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await school_admins.setUser(data.user || null, {
+      transaction,
+    });
+
+    await school_admins.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await school_admins.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return school_admins;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const school_adminsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      full_name: item.full_name || null,
+      phone_number: item.phone_number || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const school_admins = await db.school_admins.bulkCreate(school_adminsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return school_admins;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const school_admins = await db.school_admins.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.full_name !== undefined) updatePayload.full_name = data.full_name;
+
+    if (data.phone_number !== undefined)
+      updatePayload.phone_number = data.phone_number;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await school_admins.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await school_admins.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.school !== undefined) {
+      await school_admins.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await school_admins.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return school_admins;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const school_admins = await db.school_admins.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of school_admins) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of school_admins) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return school_admins;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const school_admins = await db.school_admins.findByPk(id, options);
+
+    await school_admins.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await school_admins.destroy({
+      transaction,
+    });
+
+    return school_admins;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const school_admins = await db.school_admins.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!school_admins) {
+      return school_admins;
+    }
+
+    const output = school_admins.get({ plain: true });
+
+    output.user = await school_admins.getUser({
+      transaction,
+    });
+
+    output.school = await school_admins.getSchool({
+      transaction,
+    });
+
+    output.schools = await school_admins.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.full_name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('school_admins', 'full_name', filter.full_name),
+        };
+      }
+
+      if (filter.phone_number) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'school_admins',
+            'phone_number',
+            filter.phone_number,
+          ),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.school_admins.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('school_admins', 'full_name', query),
+        ],
+      };
+    }
+
+    const records = await db.school_admins.findAll({
+      attributes: ['id', 'full_name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['full_name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.full_name,
+    }));
+  }
+};

backend/src/db/api/schools.js

@@ -0,0 +1,418 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class SchoolsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const schools = await db.schools.create(
+      {
+        id: data.id || undefined,
+
+        name: data.name || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    return schools;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const schoolsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      name: item.name || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const schools = await db.schools.bulkCreate(schoolsData, { transaction });
+
+    // For each item created, replace relation files
+
+    return schools;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const schools = await db.schools.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.name !== undefined) updatePayload.name = data.name;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await schools.update(updatePayload, { transaction });
+
+    return schools;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const schools = await db.schools.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of schools) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of schools) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return schools;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const schools = await db.schools.findByPk(id, options);
+
+    await schools.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await schools.destroy({
+      transaction,
+    });
+
+    return schools;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const schools = await db.schools.findOne({ where }, { transaction });
+
+    if (!schools) {
+      return schools;
+    }
+
+    const output = schools.get({ plain: true });
+
+    output.users_schools = await schools.getUsers_schools({
+      transaction,
+    });
+
+    output.activity_logs_schools = await schools.getActivity_logs_schools({
+      transaction,
+    });
+
+    output.assignment_submissions_schools =
+      await schools.getAssignment_submissions_schools({
+        transaction,
+      });
+
+    output.assignments_schools = await schools.getAssignments_schools({
+      transaction,
+    });
+
+    output.bills_school = await schools.getBills_school({
+      transaction,
+    });
+
+    output.bills_schools = await schools.getBills_schools({
+      transaction,
+    });
+
+    output.class_messages_schools = await schools.getClass_messages_schools({
+      transaction,
+    });
+
+    output.class_subjects_schools = await schools.getClass_subjects_schools({
+      transaction,
+    });
+
+    output.classes_school = await schools.getClasses_school({
+      transaction,
+    });
+
+    output.classes_schools = await schools.getClasses_schools({
+      transaction,
+    });
+
+    output.exam_subjects_schools = await schools.getExam_subjects_schools({
+      transaction,
+    });
+
+    output.exams_school = await schools.getExams_school({
+      transaction,
+    });
+
+    output.exams_schools = await schools.getExams_schools({
+      transaction,
+    });
+
+    output.fee_payments_schools = await schools.getFee_payments_schools({
+      transaction,
+    });
+
+    output.fee_structures_school = await schools.getFee_structures_school({
+      transaction,
+    });
+
+    output.fee_structures_schools = await schools.getFee_structures_schools({
+      transaction,
+    });
+
+    output.lesson_plans_schools = await schools.getLesson_plans_schools({
+      transaction,
+    });
+
+    output.login_logs_schools = await schools.getLogin_logs_schools({
+      transaction,
+    });
+
+    output.marks_schools = await schools.getMarks_schools({
+      transaction,
+    });
+
+    output.messages_school = await schools.getMessages_school({
+      transaction,
+    });
+
+    output.messages_schools = await schools.getMessages_schools({
+      transaction,
+    });
+
+    output.parents_schools = await schools.getParents_schools({
+      transaction,
+    });
+
+    output.period_settings_school = await schools.getPeriod_settings_school({
+      transaction,
+    });
+
+    output.period_settings_schools = await schools.getPeriod_settings_schools({
+      transaction,
+    });
+
+    output.school_admins_school = await schools.getSchool_admins_school({
+      transaction,
+    });
+
+    output.school_admins_schools = await schools.getSchool_admins_schools({
+      transaction,
+    });
+
+    output.student_attendance_schools =
+      await schools.getStudent_attendance_schools({
+        transaction,
+      });
+
+    output.students_school = await schools.getStudents_school({
+      transaction,
+    });
+
+    output.students_schools = await schools.getStudents_schools({
+      transaction,
+    });
+
+    output.subjects_school = await schools.getSubjects_school({
+      transaction,
+    });
+
+    output.subjects_schools = await schools.getSubjects_schools({
+      transaction,
+    });
+
+    output.teacher_attendance_school =
+      await schools.getTeacher_attendance_school({
+        transaction,
+      });
+
+    output.teacher_attendance_schools =
+      await schools.getTeacher_attendance_schools({
+        transaction,
+      });
+
+    output.teachers_school = await schools.getTeachers_school({
+      transaction,
+    });
+
+    output.teachers_schools = await schools.getTeachers_schools({
+      transaction,
+    });
+
+    output.timetables_schools = await schools.getTimetables_schools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('schools', 'name', filter.name),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.schools.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('schools', 'name', query),
+        ],
+      };
+    }
+
+    const records = await db.schools.findAll({
+      attributes: ['id', 'name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.name,
+    }));
+  }
+};

backend/src/db/api/student_attendance.js

@@ -0,0 +1,447 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Student_attendanceDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const student_attendance = await db.student_attendance.create(
+      {
+        id: data.id || undefined,
+
+        date: data.date || null,
+        status: data.status || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await student_attendance.setStudent(data.student || null, {
+      transaction,
+    });
+
+    await student_attendance.setMarked_by(data.marked_by || null, {
+      transaction,
+    });
+
+    await student_attendance.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return student_attendance;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const student_attendanceData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      date: item.date || null,
+      status: item.status || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const student_attendance = await db.student_attendance.bulkCreate(
+      student_attendanceData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return student_attendance;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const student_attendance = await db.student_attendance.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.date !== undefined) updatePayload.date = data.date;
+
+    if (data.status !== undefined) updatePayload.status = data.status;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await student_attendance.update(updatePayload, { transaction });
+
+    if (data.student !== undefined) {
+      await student_attendance.setStudent(
+        data.student,
+
+        { transaction },
+      );
+    }
+
+    if (data.marked_by !== undefined) {
+      await student_attendance.setMarked_by(
+        data.marked_by,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await student_attendance.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return student_attendance;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const student_attendance = await db.student_attendance.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of student_attendance) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of student_attendance) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return student_attendance;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const student_attendance = await db.student_attendance.findByPk(
+      id,
+      options,
+    );
+
+    await student_attendance.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await student_attendance.destroy({
+      transaction,
+    });
+
+    return student_attendance;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const student_attendance = await db.student_attendance.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!student_attendance) {
+      return student_attendance;
+    }
+
+    const output = student_attendance.get({ plain: true });
+
+    output.student = await student_attendance.getStudent({
+      transaction,
+    });
+
+    output.marked_by = await student_attendance.getMarked_by({
+      transaction,
+    });
+
+    output.schools = await student_attendance.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.students,
+        as: 'student',
+
+        where: filter.student
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.student
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.student
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.teachers,
+        as: 'marked_by',
+
+        where: filter.marked_by
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.marked_by
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.marked_by
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.calendarStart && filter.calendarEnd) {
+        where = {
+          ...where,
+          [Op.or]: [
+            {
+              date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+            {
+              date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+          ],
+        };
+      }
+
+      if (filter.dateRange) {
+        const [start, end] = filter.dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            date: {
+              ...where.date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            date: {
+              ...where.date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.status) {
+        where = {
+          ...where,
+          status: filter.status,
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.student_attendance.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('student_attendance', 'student', query),
+        ],
+      };
+    }
+
+    const records = await db.student_attendance.findAll({
+      attributes: ['id', 'student'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['student', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.student,
+    }));
+  }
+};

backend/src/db/api/students.js

@@ -0,0 +1,506 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class StudentsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const students = await db.students.create(
+      {
+        id: data.id || undefined,
+
+        full_name: data.full_name || null,
+        dob: data.dob || null,
+        gender: data.gender || null,
+        admission_date: data.admission_date || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await students.setUser(data.user || null, {
+      transaction,
+    });
+
+    await students.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await students.setParent(data.parent || null, {
+      transaction,
+    });
+
+    await students.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return students;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const studentsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      full_name: item.full_name || null,
+      dob: item.dob || null,
+      gender: item.gender || null,
+      admission_date: item.admission_date || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const students = await db.students.bulkCreate(studentsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return students;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const students = await db.students.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.full_name !== undefined) updatePayload.full_name = data.full_name;
+
+    if (data.dob !== undefined) updatePayload.dob = data.dob;
+
+    if (data.gender !== undefined) updatePayload.gender = data.gender;
+
+    if (data.admission_date !== undefined)
+      updatePayload.admission_date = data.admission_date;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await students.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await students.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.school !== undefined) {
+      await students.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.parent !== undefined) {
+      await students.setParent(
+        data.parent,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await students.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return students;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const students = await db.students.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of students) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of students) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return students;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const students = await db.students.findByPk(id, options);
+
+    await students.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await students.destroy({
+      transaction,
+    });
+
+    return students;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const students = await db.students.findOne({ where }, { transaction });
+
+    if (!students) {
+      return students;
+    }
+
+    const output = students.get({ plain: true });
+
+    output.assignment_submissions_student =
+      await students.getAssignment_submissions_student({
+        transaction,
+      });
+
+    output.fee_payments_student = await students.getFee_payments_student({
+      transaction,
+    });
+
+    output.marks_student = await students.getMarks_student({
+      transaction,
+    });
+
+    output.student_attendance_student =
+      await students.getStudent_attendance_student({
+        transaction,
+      });
+
+    output.user = await students.getUser({
+      transaction,
+    });
+
+    output.school = await students.getSchool({
+      transaction,
+    });
+
+    output.parent = await students.getParent({
+      transaction,
+    });
+
+    output.schools = await students.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.parents,
+        as: 'parent',
+
+        where: filter.parent
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.parent
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.parent
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.full_name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('students', 'full_name', filter.full_name),
+        };
+      }
+
+      if (filter.dobRange) {
+        const [start, end] = filter.dobRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            dob: {
+              ...where.dob,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            dob: {
+              ...where.dob,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.admission_dateRange) {
+        const [start, end] = filter.admission_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            admission_date: {
+              ...where.admission_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            admission_date: {
+              ...where.admission_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.gender) {
+        where = {
+          ...where,
+          gender: filter.gender,
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.students.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('students', 'full_name', query),
+        ],
+      };
+    }
+
+    const records = await db.students.findAll({
+      attributes: ['id', 'full_name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['full_name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.full_name,
+    }));
+  }
+};

backend/src/db/api/subjects.js

@@ -0,0 +1,356 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class SubjectsDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const subjects = await db.subjects.create(
+      {
+        id: data.id || undefined,
+
+        name: data.name || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await subjects.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await subjects.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return subjects;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const subjectsData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      name: item.name || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const subjects = await db.subjects.bulkCreate(subjectsData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return subjects;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const subjects = await db.subjects.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.name !== undefined) updatePayload.name = data.name;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await subjects.update(updatePayload, { transaction });
+
+    if (data.school !== undefined) {
+      await subjects.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await subjects.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return subjects;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const subjects = await db.subjects.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of subjects) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of subjects) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return subjects;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const subjects = await db.subjects.findByPk(id, options);
+
+    await subjects.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await subjects.destroy({
+      transaction,
+    });
+
+    return subjects;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const subjects = await db.subjects.findOne({ where }, { transaction });
+
+    if (!subjects) {
+      return subjects;
+    }
+
+    const output = subjects.get({ plain: true });
+
+    output.assignments_subject = await subjects.getAssignments_subject({
+      transaction,
+    });
+
+    output.class_subjects_subject = await subjects.getClass_subjects_subject({
+      transaction,
+    });
+
+    output.exam_subjects_subject = await subjects.getExam_subjects_subject({
+      transaction,
+    });
+
+    output.lesson_plans_subject = await subjects.getLesson_plans_subject({
+      transaction,
+    });
+
+    output.timetables_subject = await subjects.getTimetables_subject({
+      transaction,
+    });
+
+    output.school = await subjects.getSchool({
+      transaction,
+    });
+
+    output.schools = await subjects.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('subjects', 'name', filter.name),
+        };
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.subjects.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('subjects', 'name', query),
+        ],
+      };
+    }
+
+    const records = await db.subjects.findAll({
+      attributes: ['id', 'name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.name,
+    }));
+  }
+};

backend/src/db/api/teacher_attendance.js

@@ -0,0 +1,437 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class Teacher_attendanceDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teacher_attendance = await db.teacher_attendance.create(
+      {
+        id: data.id || undefined,
+
+        date: data.date || null,
+        status: data.status || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await teacher_attendance.setTeacher(data.teacher || null, {
+      transaction,
+    });
+
+    await teacher_attendance.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await teacher_attendance.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return teacher_attendance;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const teacher_attendanceData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      date: item.date || null,
+      status: item.status || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const teacher_attendance = await db.teacher_attendance.bulkCreate(
+      teacher_attendanceData,
+      { transaction },
+    );
+
+    // For each item created, replace relation files
+
+    return teacher_attendance;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const teacher_attendance = await db.teacher_attendance.findByPk(
+      id,
+      {},
+      { transaction },
+    );
+
+    const updatePayload = {};
+
+    if (data.date !== undefined) updatePayload.date = data.date;
+
+    if (data.status !== undefined) updatePayload.status = data.status;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await teacher_attendance.update(updatePayload, { transaction });
+
+    if (data.teacher !== undefined) {
+      await teacher_attendance.setTeacher(
+        data.teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.school !== undefined) {
+      await teacher_attendance.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await teacher_attendance.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return teacher_attendance;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teacher_attendance = await db.teacher_attendance.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of teacher_attendance) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of teacher_attendance) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return teacher_attendance;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teacher_attendance = await db.teacher_attendance.findByPk(
+      id,
+      options,
+    );
+
+    await teacher_attendance.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await teacher_attendance.destroy({
+      transaction,
+    });
+
+    return teacher_attendance;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const teacher_attendance = await db.teacher_attendance.findOne(
+      { where },
+      { transaction },
+    );
+
+    if (!teacher_attendance) {
+      return teacher_attendance;
+    }
+
+    const output = teacher_attendance.get({ plain: true });
+
+    output.teacher = await teacher_attendance.getTeacher({
+      transaction,
+    });
+
+    output.school = await teacher_attendance.getSchool({
+      transaction,
+    });
+
+    output.schools = await teacher_attendance.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.teachers,
+        as: 'teacher',
+
+        where: filter.teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.calendarStart && filter.calendarEnd) {
+        where = {
+          ...where,
+          [Op.or]: [
+            {
+              date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+            {
+              date: {
+                [Op.between]: [filter.calendarStart, filter.calendarEnd],
+              },
+            },
+          ],
+        };
+      }
+
+      if (filter.dateRange) {
+        const [start, end] = filter.dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            date: {
+              ...where.date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            date: {
+              ...where.date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.status) {
+        where = {
+          ...where,
+          status: filter.status,
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.teacher_attendance.findAndCountAll(
+        queryOptions,
+      );
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('teacher_attendance', 'teacher', query),
+        ],
+      };
+    }
+
+    const records = await db.teacher_attendance.findAll({
+      attributes: ['id', 'teacher'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['teacher', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.teacher,
+    }));
+  }
+};

backend/src/db/api/teachers.js

@@ -0,0 +1,469 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class TeachersDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teachers = await db.teachers.create(
+      {
+        id: data.id || undefined,
+
+        full_name: data.full_name || null,
+        subject_specialization: data.subject_specialization || null,
+        phone_number: data.phone_number || null,
+        joining_date: data.joining_date || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await teachers.setUser(data.user || null, {
+      transaction,
+    });
+
+    await teachers.setSchool(data.school || null, {
+      transaction,
+    });
+
+    await teachers.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return teachers;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const teachersData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      full_name: item.full_name || null,
+      subject_specialization: item.subject_specialization || null,
+      phone_number: item.phone_number || null,
+      joining_date: item.joining_date || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const teachers = await db.teachers.bulkCreate(teachersData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return teachers;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const teachers = await db.teachers.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.full_name !== undefined) updatePayload.full_name = data.full_name;
+
+    if (data.subject_specialization !== undefined)
+      updatePayload.subject_specialization = data.subject_specialization;
+
+    if (data.phone_number !== undefined)
+      updatePayload.phone_number = data.phone_number;
+
+    if (data.joining_date !== undefined)
+      updatePayload.joining_date = data.joining_date;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await teachers.update(updatePayload, { transaction });
+
+    if (data.user !== undefined) {
+      await teachers.setUser(
+        data.user,
+
+        { transaction },
+      );
+    }
+
+    if (data.school !== undefined) {
+      await teachers.setSchool(
+        data.school,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await teachers.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return teachers;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teachers = await db.teachers.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of teachers) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of teachers) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return teachers;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const teachers = await db.teachers.findByPk(id, options);
+
+    await teachers.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await teachers.destroy({
+      transaction,
+    });
+
+    return teachers;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const teachers = await db.teachers.findOne({ where }, { transaction });
+
+    if (!teachers) {
+      return teachers;
+    }
+
+    const output = teachers.get({ plain: true });
+
+    output.assignments_teacher = await teachers.getAssignments_teacher({
+      transaction,
+    });
+
+    output.class_subjects_teacher = await teachers.getClass_subjects_teacher({
+      transaction,
+    });
+
+    output.classes_class_teacher = await teachers.getClasses_class_teacher({
+      transaction,
+    });
+
+    output.lesson_plans_teacher = await teachers.getLesson_plans_teacher({
+      transaction,
+    });
+
+    output.student_attendance_marked_by =
+      await teachers.getStudent_attendance_marked_by({
+        transaction,
+      });
+
+    output.teacher_attendance_teacher =
+      await teachers.getTeacher_attendance_teacher({
+        transaction,
+      });
+
+    output.timetables_teacher = await teachers.getTimetables_teacher({
+      transaction,
+    });
+
+    output.user = await teachers.getUser({
+      transaction,
+    });
+
+    output.school = await teachers.getSchool({
+      transaction,
+    });
+
+    output.schools = await teachers.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.users,
+        as: 'user',
+
+        where: filter.user
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.user
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  firstName: {
+                    [Op.or]: filter.user
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'school',
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.full_name) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('teachers', 'full_name', filter.full_name),
+        };
+      }
+
+      if (filter.subject_specialization) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'teachers',
+            'subject_specialization',
+            filter.subject_specialization,
+          ),
+        };
+      }
+
+      if (filter.phone_number) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'teachers',
+            'phone_number',
+            filter.phone_number,
+          ),
+        };
+      }
+
+      if (filter.joining_dateRange) {
+        const [start, end] = filter.joining_dateRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            joining_date: {
+              ...where.joining_date,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            joining_date: {
+              ...where.joining_date,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.school) {
+        const listItems = filter.school.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.teachers.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('teachers', 'full_name', query),
+        ],
+      };
+    }
+
+    const records = await db.teachers.findAll({
+      attributes: ['id', 'full_name'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['full_name', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.full_name,
+    }));
+  }
+};

backend/src/db/api/timetables.js

@@ -0,0 +1,418 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class TimetablesDBApi {
+  static async create(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const timetables = await db.timetables.create(
+      {
+        id: data.id || undefined,
+
+        day_of_week: data.day_of_week || null,
+        period_number: data.period_number || null,
+        importHash: data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    await timetables.setSubject(data.subject || null, {
+      transaction,
+    });
+
+    await timetables.setTeacher(data.teacher || null, {
+      transaction,
+    });
+
+    await timetables.setSchools(data.schools || null, {
+      transaction,
+    });
+
+    return timetables;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const timetablesData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      day_of_week: item.day_of_week || null,
+      period_number: item.period_number || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const timetables = await db.timetables.bulkCreate(timetablesData, {
+      transaction,
+    });
+
+    // For each item created, replace relation files
+
+    return timetables;
+  }
+
+  static async update(id, data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const globalAccess = currentUser.app_role?.globalAccess;
+
+    const timetables = await db.timetables.findByPk(id, {}, { transaction });
+
+    const updatePayload = {};
+
+    if (data.day_of_week !== undefined)
+      updatePayload.day_of_week = data.day_of_week;
+
+    if (data.period_number !== undefined)
+      updatePayload.period_number = data.period_number;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await timetables.update(updatePayload, { transaction });
+
+    if (data.subject !== undefined) {
+      await timetables.setSubject(
+        data.subject,
+
+        { transaction },
+      );
+    }
+
+    if (data.teacher !== undefined) {
+      await timetables.setTeacher(
+        data.teacher,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await timetables.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    return timetables;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const timetables = await db.timetables.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of timetables) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of timetables) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return timetables;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const timetables = await db.timetables.findByPk(id, options);
+
+    await timetables.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await timetables.destroy({
+      transaction,
+    });
+
+    return timetables;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const timetables = await db.timetables.findOne({ where }, { transaction });
+
+    if (!timetables) {
+      return timetables;
+    }
+
+    const output = timetables.get({ plain: true });
+
+    output.subject = await timetables.getSubject({
+      transaction,
+    });
+
+    output.teacher = await timetables.getTeacher({
+      transaction,
+    });
+
+    output.schools = await timetables.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.subjects,
+        as: 'subject',
+
+        where: filter.subject
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.subject
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.subject
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.teachers,
+        as: 'teacher',
+
+        where: filter.teacher
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.teacher
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  full_name: {
+                    [Op.or]: filter.teacher
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.period_numberRange) {
+        const [start, end] = filter.period_numberRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            period_number: {
+              ...where.period_number,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            period_number: {
+              ...where.period_number,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.day_of_week) {
+        where = {
+          ...where,
+          day_of_week: filter.day_of_week,
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.timetables.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('timetables', 'id', query),
+        ],
+      };
+    }
+
+    const records = await db.timetables.findAll({
+      attributes: ['id', 'id'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['id', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.id,
+    }));
+  }
+};

backend/src/db/api/users.js

@@ -0,0 +1,836 @@
+const db = require('../models');
+const FileDBApi = require('./file');
+const crypto = require('crypto');
+const Utils = require('../utils');
+
+const bcrypt = require('bcrypt');
+const config = require('../../config');
+
+const Sequelize = db.Sequelize;
+const Op = Sequelize.Op;
+
+module.exports = class UsersDBApi {
+  static async create(data, globalAccess, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.create(
+      {
+        id: data.data.id || undefined,
+
+        firstName: data.data.firstName || null,
+        lastName: data.data.lastName || null,
+        phoneNumber: data.data.phoneNumber || null,
+        email: data.data.email || null,
+        disabled: data.data.disabled || false,
+
+        password: data.data.password || null,
+        emailVerified: data.data.emailVerified || true,
+
+        emailVerificationToken: data.data.emailVerificationToken || null,
+        emailVerificationTokenExpiresAt:
+          data.data.emailVerificationTokenExpiresAt || null,
+        passwordResetToken: data.data.passwordResetToken || null,
+        passwordResetTokenExpiresAt:
+          data.data.passwordResetTokenExpiresAt || null,
+        provider: data.data.provider || null,
+        importHash: data.data.importHash || null,
+        createdById: currentUser.id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    if (!data.data.app_role) {
+      const role = await db.roles.findOne({
+        where: { name: 'User' },
+      });
+      if (role) {
+        await users.setApp_role(role, {
+          transaction,
+        });
+      }
+    } else {
+      await users.setApp_role(data.data.app_role || null, {
+        transaction,
+      });
+    }
+
+    await users.setSchools(data.data.schools || null, {
+      transaction,
+    });
+
+    await users.setCustom_permissions(data.data.custom_permissions || [], {
+      transaction,
+    });
+
+    await FileDBApi.replaceRelationFiles(
+      {
+        belongsTo: db.users.getTableName(),
+        belongsToColumn: 'avatar',
+        belongsToId: users.id,
+      },
+      data.data.avatar,
+      options,
+    );
+
+    return users;
+  }
+
+  static async bulkImport(data, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    // Prepare data - wrapping individual data transformations in a map() method
+    const usersData = data.map((item, index) => ({
+      id: item.id || undefined,
+
+      firstName: item.firstName || null,
+      lastName: item.lastName || null,
+      phoneNumber: item.phoneNumber || null,
+      email: item.email || null,
+      disabled: item.disabled || false,
+
+      password: item.password || null,
+      emailVerified: item.emailVerified || false,
+
+      emailVerificationToken: item.emailVerificationToken || null,
+      emailVerificationTokenExpiresAt:
+        item.emailVerificationTokenExpiresAt || null,
+      passwordResetToken: item.passwordResetToken || null,
+      passwordResetTokenExpiresAt: item.passwordResetTokenExpiresAt || null,
+      provider: item.provider || null,
+      importHash: item.importHash || null,
+      createdById: currentUser.id,
+      updatedById: currentUser.id,
+      createdAt: new Date(Date.now() + index * 1000),
+    }));
+
+    // Bulk create items
+    const users = await db.users.bulkCreate(usersData, { transaction });
+
+    // For each item created, replace relation files
+
+    for (let i = 0; i < users.length; i++) {
+      await FileDBApi.replaceRelationFiles(
+        {
+          belongsTo: db.users.getTableName(),
+          belongsToColumn: 'avatar',
+          belongsToId: users[i].id,
+        },
+        data[i].avatar,
+        options,
+      );
+    }
+
+    return users;
+  }
+
+  static async update(id, data, globalAccess, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findByPk(id, {}, { transaction });
+
+    if (!data?.app_role) {
+      data.app_role = users?.app_role?.id;
+    }
+    if (!data?.custom_permissions) {
+      data.custom_permissions = users?.custom_permissions?.map(
+        (item) => item.id,
+      );
+    }
+
+    if (data.password) {
+      data.password = bcrypt.hashSync(data.password, config.bcrypt.saltRounds);
+    } else {
+      data.password = users.password;
+    }
+
+    const updatePayload = {};
+
+    if (data.firstName !== undefined) updatePayload.firstName = data.firstName;
+
+    if (data.lastName !== undefined) updatePayload.lastName = data.lastName;
+
+    if (data.phoneNumber !== undefined)
+      updatePayload.phoneNumber = data.phoneNumber;
+
+    if (data.email !== undefined) updatePayload.email = data.email;
+
+    if (data.disabled !== undefined) updatePayload.disabled = data.disabled;
+
+    if (data.password !== undefined) updatePayload.password = data.password;
+
+    if (data.emailVerified !== undefined)
+      updatePayload.emailVerified = data.emailVerified;
+    else updatePayload.emailVerified = true;
+
+    if (data.emailVerificationToken !== undefined)
+      updatePayload.emailVerificationToken = data.emailVerificationToken;
+
+    if (data.emailVerificationTokenExpiresAt !== undefined)
+      updatePayload.emailVerificationTokenExpiresAt =
+        data.emailVerificationTokenExpiresAt;
+
+    if (data.passwordResetToken !== undefined)
+      updatePayload.passwordResetToken = data.passwordResetToken;
+
+    if (data.passwordResetTokenExpiresAt !== undefined)
+      updatePayload.passwordResetTokenExpiresAt =
+        data.passwordResetTokenExpiresAt;
+
+    if (data.provider !== undefined) updatePayload.provider = data.provider;
+
+    updatePayload.updatedById = currentUser.id;
+
+    await users.update(updatePayload, { transaction });
+
+    if (data.app_role !== undefined) {
+      await users.setApp_role(
+        data.app_role,
+
+        { transaction },
+      );
+    }
+
+    if (data.schools !== undefined) {
+      await users.setSchools(
+        data.schools,
+
+        { transaction },
+      );
+    }
+
+    if (data.custom_permissions !== undefined) {
+      await users.setCustom_permissions(data.custom_permissions, {
+        transaction,
+      });
+    }
+
+    await FileDBApi.replaceRelationFiles(
+      {
+        belongsTo: db.users.getTableName(),
+        belongsToColumn: 'avatar',
+        belongsToId: users.id,
+      },
+      data.avatar,
+      options,
+    );
+
+    return users;
+  }
+
+  static async deleteByIds(ids, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findAll({
+      where: {
+        id: {
+          [Op.in]: ids,
+        },
+      },
+      transaction,
+    });
+
+    await db.sequelize.transaction(async (transaction) => {
+      for (const record of users) {
+        await record.update({ deletedBy: currentUser.id }, { transaction });
+      }
+      for (const record of users) {
+        await record.destroy({ transaction });
+      }
+    });
+
+    return users;
+  }
+
+  static async remove(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findByPk(id, options);
+
+    await users.update(
+      {
+        deletedBy: currentUser.id,
+      },
+      {
+        transaction,
+      },
+    );
+
+    await users.destroy({
+      transaction,
+    });
+
+    return users;
+  }
+
+  static async findBy(where, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findOne({ where }, { transaction });
+
+    if (!users) {
+      return users;
+    }
+
+    const output = users.get({ plain: true });
+
+    output.activity_logs_user = await users.getActivity_logs_user({
+      transaction,
+    });
+
+    output.class_messages_sender = await users.getClass_messages_sender({
+      transaction,
+    });
+
+    output.login_logs_user = await users.getLogin_logs_user({
+      transaction,
+    });
+
+    output.messages_sender = await users.getMessages_sender({
+      transaction,
+    });
+
+    output.messages_receiver = await users.getMessages_receiver({
+      transaction,
+    });
+
+    output.parents_user = await users.getParents_user({
+      transaction,
+    });
+
+    output.school_admins_user = await users.getSchool_admins_user({
+      transaction,
+    });
+
+    output.students_user = await users.getStudents_user({
+      transaction,
+    });
+
+    output.teachers_user = await users.getTeachers_user({
+      transaction,
+    });
+
+    output.avatar = await users.getAvatar({
+      transaction,
+    });
+
+    output.app_role = await users.getApp_role({
+      transaction,
+    });
+
+    if (output.app_role) {
+      output.app_role_permissions = await output.app_role.getPermissions({
+        transaction,
+      });
+    }
+
+    output.custom_permissions = await users.getCustom_permissions({
+      transaction,
+    });
+
+    output.schools = await users.getSchools({
+      transaction,
+    });
+
+    return output;
+  }
+
+  static async findAll(filter, globalAccess, options) {
+    const limit = filter.limit || 0;
+    let offset = 0;
+    let where = {};
+    const currentPage = +filter.page;
+
+    const user = (options && options.currentUser) || null;
+    const userSchools = (user && user.schools?.id) || null;
+
+    if (userSchools) {
+      if (options?.currentUser?.schoolsId) {
+        where.schoolsId = options.currentUser.schoolsId;
+      }
+    }
+
+    offset = currentPage * limit;
+
+    const orderBy = null;
+
+    const transaction = (options && options.transaction) || undefined;
+
+    let include = [
+      {
+        model: db.roles,
+        as: 'app_role',
+
+        where: filter.app_role
+          ? {
+              [Op.or]: [
+                {
+                  id: {
+                    [Op.in]: filter.app_role
+                      .split('|')
+                      .map((term) => Utils.uuid(term)),
+                  },
+                },
+                {
+                  name: {
+                    [Op.or]: filter.app_role
+                      .split('|')
+                      .map((term) => ({ [Op.iLike]: `%${term}%` })),
+                  },
+                },
+              ],
+            }
+          : {},
+      },
+
+      {
+        model: db.schools,
+        as: 'schools',
+      },
+
+      {
+        model: db.permissions,
+        as: 'custom_permissions',
+        required: false,
+      },
+
+      {
+        model: db.file,
+        as: 'avatar',
+      },
+    ];
+
+    if (filter) {
+      if (filter.id) {
+        where = {
+          ...where,
+          ['id']: Utils.uuid(filter.id),
+        };
+      }
+
+      if (filter.firstName) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'firstName', filter.firstName),
+        };
+      }
+
+      if (filter.lastName) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'lastName', filter.lastName),
+        };
+      }
+
+      if (filter.phoneNumber) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'phoneNumber', filter.phoneNumber),
+        };
+      }
+
+      if (filter.email) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'email', filter.email),
+        };
+      }
+
+      if (filter.password) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'password', filter.password),
+        };
+      }
+
+      if (filter.emailVerificationToken) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'users',
+            'emailVerificationToken',
+            filter.emailVerificationToken,
+          ),
+        };
+      }
+
+      if (filter.passwordResetToken) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike(
+            'users',
+            'passwordResetToken',
+            filter.passwordResetToken,
+          ),
+        };
+      }
+
+      if (filter.provider) {
+        where = {
+          ...where,
+          [Op.and]: Utils.ilike('users', 'provider', filter.provider),
+        };
+      }
+
+      if (filter.emailVerificationTokenExpiresAtRange) {
+        const [start, end] = filter.emailVerificationTokenExpiresAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            emailVerificationTokenExpiresAt: {
+              ...where.emailVerificationTokenExpiresAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            emailVerificationTokenExpiresAt: {
+              ...where.emailVerificationTokenExpiresAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.passwordResetTokenExpiresAtRange) {
+        const [start, end] = filter.passwordResetTokenExpiresAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            passwordResetTokenExpiresAt: {
+              ...where.passwordResetTokenExpiresAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            passwordResetTokenExpiresAt: {
+              ...where.passwordResetTokenExpiresAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+
+      if (filter.active !== undefined) {
+        where = {
+          ...where,
+          active: filter.active === true || filter.active === 'true',
+        };
+      }
+
+      if (filter.disabled) {
+        where = {
+          ...where,
+          disabled: filter.disabled,
+        };
+      }
+
+      if (filter.emailVerified) {
+        where = {
+          ...where,
+          emailVerified: filter.emailVerified,
+        };
+      }
+
+      if (filter.schools) {
+        const listItems = filter.schools.split('|').map((item) => {
+          return Utils.uuid(item);
+        });
+
+        where = {
+          ...where,
+          schoolsId: { [Op.or]: listItems },
+        };
+      }
+
+      if (filter.custom_permissions) {
+        const searchTerms = filter.custom_permissions.split('|');
+
+        include = [
+          {
+            model: db.permissions,
+            as: 'custom_permissions_filter',
+            required: searchTerms.length > 0,
+            where:
+              searchTerms.length > 0
+                ? {
+                    [Op.or]: [
+                      {
+                        id: {
+                          [Op.in]: searchTerms.map((term) => Utils.uuid(term)),
+                        },
+                      },
+                      {
+                        name: {
+                          [Op.or]: searchTerms.map((term) => ({
+                            [Op.iLike]: `%${term}%`,
+                          })),
+                        },
+                      },
+                    ],
+                  }
+                : undefined,
+          },
+          ...include,
+        ];
+      }
+
+      if (filter.createdAtRange) {
+        const [start, end] = filter.createdAtRange;
+
+        if (start !== undefined && start !== null && start !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.gte]: start,
+            },
+          };
+        }
+
+        if (end !== undefined && end !== null && end !== '') {
+          where = {
+            ...where,
+            ['createdAt']: {
+              ...where.createdAt,
+              [Op.lte]: end,
+            },
+          };
+        }
+      }
+    }
+
+    if (globalAccess) {
+      delete where.schoolsId;
+    }
+
+    const queryOptions = {
+      where,
+      include,
+      distinct: true,
+      order:
+        filter.field && filter.sort
+          ? [[filter.field, filter.sort]]
+          : [['createdAt', 'desc']],
+      transaction: options?.transaction,
+      logging: console.log,
+    };
+
+    if (!options?.countOnly) {
+      queryOptions.limit = limit ? Number(limit) : undefined;
+      queryOptions.offset = offset ? Number(offset) : undefined;
+    }
+
+    try {
+      const { rows, count } = await db.users.findAndCountAll(queryOptions);
+
+      return {
+        rows: options?.countOnly ? [] : rows,
+        count: count,
+      };
+    } catch (error) {
+      console.error('Error executing query:', error);
+      throw error;
+    }
+  }
+
+  static async findAllAutocomplete(
+    query,
+    limit,
+    offset,
+    globalAccess,
+    organizationId,
+  ) {
+    let where = {};
+
+    if (!globalAccess && organizationId) {
+      where.organizationId = organizationId;
+    }
+
+    if (query) {
+      where = {
+        [Op.or]: [
+          { ['id']: Utils.uuid(query) },
+          Utils.ilike('users', 'firstName', query),
+        ],
+      };
+    }
+
+    const records = await db.users.findAll({
+      attributes: ['id', 'firstName'],
+      where,
+      limit: limit ? Number(limit) : undefined,
+      offset: offset ? Number(offset) : undefined,
+      orderBy: [['firstName', 'ASC']],
+    });
+
+    return records.map((record) => ({
+      id: record.id,
+      label: record.firstName,
+    }));
+  }
+
+  static async createFromAuth(data, options) {
+    const transaction = (options && options.transaction) || undefined;
+    const users = await db.users.create(
+      {
+        email: data.email,
+        firstName: data.firstName,
+        authenticationUid: data.authenticationUid,
+        password: data.password,
+
+        organizationId: data.organizationId,
+      },
+      { transaction },
+    );
+
+    const app_role = await db.roles.findOne({
+      where: { name: config.roles?.user || 'User' },
+    });
+    if (app_role?.id) {
+      await users.setApp_role(app_role?.id || null, {
+        transaction,
+      });
+    }
+
+    await users.update(
+      {
+        authenticationUid: users.id,
+      },
+      { transaction },
+    );
+
+    delete users.password;
+    return users;
+  }
+
+  static async updatePassword(id, password, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findByPk(id, {
+      transaction,
+    });
+
+    await users.update(
+      {
+        password,
+        authenticationUid: id,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    return users;
+  }
+
+  static async generateEmailVerificationToken(email, options) {
+    return this._generateToken(
+      ['emailVerificationToken', 'emailVerificationTokenExpiresAt'],
+      email,
+      options,
+    );
+  }
+
+  static async generatePasswordResetToken(email, options) {
+    return this._generateToken(
+      ['passwordResetToken', 'passwordResetTokenExpiresAt'],
+      email,
+      options,
+    );
+  }
+
+  static async findByPasswordResetToken(token, options) {
+    const transaction = (options && options.transaction) || undefined;
+
+    return db.users.findOne(
+      {
+        where: {
+          passwordResetToken: token,
+          passwordResetTokenExpiresAt: {
+            [db.Sequelize.Op.gt]: Date.now(),
+          },
+        },
+      },
+      { transaction },
+    );
+  }
+
+  static async findByEmailVerificationToken(token, options) {
+    const transaction = (options && options.transaction) || undefined;
+    return db.users.findOne(
+      {
+        where: {
+          emailVerificationToken: token,
+          emailVerificationTokenExpiresAt: {
+            [db.Sequelize.Op.gt]: Date.now(),
+          },
+        },
+      },
+      { transaction },
+    );
+  }
+
+  static async markEmailVerified(id, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+
+    const users = await db.users.findByPk(id, {
+      transaction,
+    });
+
+    await users.update(
+      {
+        emailVerified: true,
+        updatedById: currentUser.id,
+      },
+      { transaction },
+    );
+
+    return true;
+  }
+
+  static async _generateToken(keyNames, email, options) {
+    const currentUser = (options && options.currentUser) || { id: null };
+    const transaction = (options && options.transaction) || undefined;
+    const users = await db.users.findOne(
+      {
+        where: { email: email.toLowerCase() },
+      },
+      {
+        transaction,
+      },
+    );
+
+    const token = crypto.randomBytes(20).toString('hex');
+    const tokenExpiresAt = Date.now() + 360000;
+
+    if (users) {
+      await users.update(
+        {
+          [keyNames[0]]: token,
+          [keyNames[1]]: tokenExpiresAt,
+          updatedById: currentUser.id,
+        },
+        { transaction },
+      );
+    }
+
+    return token;
+  }
+};

backend/src/db/db.config.js

@@ -0,0 +1,31 @@
+module.exports = {
+  production: {
+    dialect: 'postgres',
+    username: process.env.DB_USER,
+    password: process.env.DB_PASS,
+    database: process.env.DB_NAME,
+    host: process.env.DB_HOST,
+    port: process.env.DB_PORT,
+    logging: console.log,
+    seederStorage: 'sequelize',
+  },
+  development: {
+    username: 'postgres',
+    dialect: 'postgres',
+    password: '',
+    database: 'db_nexus_school_management',
+    host: process.env.DB_HOST || 'localhost',
+    logging: console.log,
+    seederStorage: 'sequelize',
+  },
+  dev_stage: {
+    dialect: 'postgres',
+    username: process.env.DB_USER,
+    password: process.env.DB_PASS,
+    database: process.env.DB_NAME,
+    host: process.env.DB_HOST,
+    port: process.env.DB_PORT,
+    logging: console.log,
+    seederStorage: 'sequelize',
+  },
+};

backend/src/db/models/activity_logs.js

@@ -0,0 +1,77 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const activity_logs = sequelize.define(
+    'activity_logs',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      action: {
+        type: DataTypes.TEXT,
+      },
+
+      entity_type: {
+        type: DataTypes.TEXT,
+      },
+
+      entity_id: {
+        type: DataTypes.INTEGER,
+      },
+
+      timestamp: {
+        type: DataTypes.DATE,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  activity_logs.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.activity_logs.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.activity_logs.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.activity_logs.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.activity_logs.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return activity_logs;
+};

backend/src/db/models/assignment_submissions.js

@@ -0,0 +1,85 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const assignment_submissions = sequelize.define(
+    'assignment_submissions',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      submission_date: {
+        type: DataTypes.DATE,
+      },
+
+      content: {
+        type: DataTypes.TEXT,
+      },
+
+      grade: {
+        type: DataTypes.DECIMAL,
+      },
+
+      feedback: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  assignment_submissions.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.assignment_submissions.belongsTo(db.assignments, {
+      as: 'assignment',
+      foreignKey: {
+        name: 'assignmentId',
+      },
+      constraints: false,
+    });
+
+    db.assignment_submissions.belongsTo(db.students, {
+      as: 'student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.assignment_submissions.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.assignment_submissions.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.assignment_submissions.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return assignment_submissions;
+};

backend/src/db/models/assignments.js

@@ -0,0 +1,93 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const assignments = sequelize.define(
+    'assignments',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      title: {
+        type: DataTypes.TEXT,
+      },
+
+      description: {
+        type: DataTypes.TEXT,
+      },
+
+      due_date: {
+        type: DataTypes.DATE,
+      },
+
+      attachment_url: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  assignments.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.assignments.hasMany(db.assignment_submissions, {
+      as: 'assignment_submissions_assignment',
+      foreignKey: {
+        name: 'assignmentId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.assignments.belongsTo(db.teachers, {
+      as: 'teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.assignments.belongsTo(db.subjects, {
+      as: 'subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.assignments.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.assignments.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.assignments.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return assignments;
+};

backend/src/db/models/bills.js

@@ -0,0 +1,87 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const bills = sequelize.define(
+    'bills',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      title: {
+        type: DataTypes.TEXT,
+      },
+
+      amount: {
+        type: DataTypes.DECIMAL,
+      },
+
+      bill_month: {
+        type: DataTypes.TEXT,
+      },
+
+      category: {
+        type: DataTypes.TEXT,
+      },
+
+      upload_url: {
+        type: DataTypes.TEXT,
+      },
+
+      status: {
+        type: DataTypes.ENUM,
+
+        values: ['pending', 'paid', 'overdue'],
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  bills.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.bills.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.bills.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.bills.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.bills.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return bills;
+};

backend/src/db/models/class_messages.js

@@ -0,0 +1,65 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const class_messages = sequelize.define(
+    'class_messages',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      content: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  class_messages.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.class_messages.belongsTo(db.users, {
+      as: 'sender',
+      foreignKey: {
+        name: 'senderId',
+      },
+      constraints: false,
+    });
+
+    db.class_messages.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.class_messages.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.class_messages.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return class_messages;
+};

backend/src/db/models/class_subjects.js

@@ -0,0 +1,69 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const class_subjects = sequelize.define(
+    'class_subjects',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  class_subjects.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.class_subjects.belongsTo(db.subjects, {
+      as: 'subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.class_subjects.belongsTo(db.teachers, {
+      as: 'teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.class_subjects.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.class_subjects.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.class_subjects.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return class_subjects;
+};

backend/src/db/models/classes.js

@@ -0,0 +1,77 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const classes = sequelize.define(
+    'classes',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      name: {
+        type: DataTypes.TEXT,
+      },
+
+      section: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  classes.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.classes.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.classes.belongsTo(db.teachers, {
+      as: 'class_teacher',
+      foreignKey: {
+        name: 'class_teacherId',
+      },
+      constraints: false,
+    });
+
+    db.classes.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.classes.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.classes.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return classes;
+};

backend/src/db/models/exam_subjects.js

@@ -0,0 +1,85 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const exam_subjects = sequelize.define(
+    'exam_subjects',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      exam_date: {
+        type: DataTypes.DATE,
+      },
+
+      max_marks: {
+        type: DataTypes.DECIMAL,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  exam_subjects.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.exam_subjects.hasMany(db.marks, {
+      as: 'marks_exam_subject',
+      foreignKey: {
+        name: 'exam_subjectId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.exam_subjects.belongsTo(db.exams, {
+      as: 'exam',
+      foreignKey: {
+        name: 'examId',
+      },
+      constraints: false,
+    });
+
+    db.exam_subjects.belongsTo(db.subjects, {
+      as: 'subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.exam_subjects.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.exam_subjects.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.exam_subjects.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return exam_subjects;
+};

backend/src/db/models/exams.js

@@ -0,0 +1,85 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const exams = sequelize.define(
+    'exams',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      title: {
+        type: DataTypes.TEXT,
+      },
+
+      start_date: {
+        type: DataTypes.DATE,
+      },
+
+      end_date: {
+        type: DataTypes.DATE,
+      },
+
+      term: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  exams.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.exams.hasMany(db.exam_subjects, {
+      as: 'exam_subjects_exam',
+      foreignKey: {
+        name: 'examId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.exams.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.exams.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.exams.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.exams.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return exams;
+};

backend/src/db/models/fee_payments.js

@@ -0,0 +1,83 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const fee_payments = sequelize.define(
+    'fee_payments',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      amount_paid: {
+        type: DataTypes.DECIMAL,
+      },
+
+      payment_date: {
+        type: DataTypes.DATE,
+      },
+
+      receipt_url: {
+        type: DataTypes.TEXT,
+      },
+
+      term: {
+        type: DataTypes.TEXT,
+      },
+
+      status: {
+        type: DataTypes.ENUM,
+
+        values: ['pending', 'completed', 'failed'],
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  fee_payments.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.fee_payments.belongsTo(db.students, {
+      as: 'student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.fee_payments.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.fee_payments.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.fee_payments.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return fee_payments;
+};

backend/src/db/models/fee_structures.js

@@ -0,0 +1,69 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const fee_structures = sequelize.define(
+    'fee_structures',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      term: {
+        type: DataTypes.TEXT,
+      },
+
+      amount: {
+        type: DataTypes.DECIMAL,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  fee_structures.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.fee_structures.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.fee_structures.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.fee_structures.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.fee_structures.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return fee_structures;
+};

backend/src/db/models/file.js

@@ -0,0 +1,53 @@
+module.exports = function (sequelize, DataTypes) {
+  const file = sequelize.define(
+    'file',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+      belongsTo: DataTypes.STRING(255),
+      belongsToId: DataTypes.UUID,
+      belongsToColumn: DataTypes.STRING(255),
+      name: {
+        type: DataTypes.STRING(2083),
+        allowNull: false,
+        validate: {
+          notEmpty: true,
+        },
+      },
+      sizeInBytes: {
+        type: DataTypes.INTEGER,
+        allowNull: true,
+      },
+      privateUrl: {
+        type: DataTypes.STRING(2083),
+        allowNull: true,
+      },
+      publicUrl: {
+        type: DataTypes.STRING(2083),
+        allowNull: false,
+        validate: {
+          notEmpty: true,
+        },
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+    },
+  );
+
+  file.associate = (db) => {
+    db.file.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.file.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return file;
+};

backend/src/db/models/index.js

@@ -0,0 +1,47 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const Sequelize = require('sequelize');
+const basename = path.basename(__filename);
+const env = process.env.NODE_ENV || 'development';
+const config = require('../db.config')[env];
+const db = {};
+
+let sequelize;
+console.log(env);
+if (config.use_env_variable) {
+  sequelize = new Sequelize(process.env[config.use_env_variable], config);
+} else {
+  sequelize = new Sequelize(
+    config.database,
+    config.username,
+    config.password,
+    config,
+  );
+}
+
+fs.readdirSync(__dirname)
+  .filter((file) => {
+    return (
+      file.indexOf('.') !== 0 && file !== basename && file.slice(-3) === '.js'
+    );
+  })
+  .forEach((file) => {
+    const model = require(path.join(__dirname, file))(
+      sequelize,
+      Sequelize.DataTypes,
+    );
+    db[model.name] = model;
+  });
+
+Object.keys(db).forEach((modelName) => {
+  if (db[modelName].associate) {
+    db[modelName].associate(db);
+  }
+});
+
+db.sequelize = sequelize;
+db.Sequelize = Sequelize;
+
+module.exports = db;

backend/src/db/models/lesson_plans.js

@@ -0,0 +1,83 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const lesson_plans = sequelize.define(
+    'lesson_plans',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      week_start_date: {
+        type: DataTypes.DATE,
+      },
+
+      plan_content: {
+        type: DataTypes.TEXT,
+      },
+
+      status: {
+        type: DataTypes.ENUM,
+
+        values: ['draft', 'submitted', 'approved'],
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  lesson_plans.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.lesson_plans.belongsTo(db.teachers, {
+      as: 'teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.lesson_plans.belongsTo(db.subjects, {
+      as: 'subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.lesson_plans.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.lesson_plans.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.lesson_plans.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return lesson_plans;
+};

backend/src/db/models/login_logs.js

@@ -0,0 +1,73 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const login_logs = sequelize.define(
+    'login_logs',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      login_time: {
+        type: DataTypes.DATE,
+      },
+
+      ip_address: {
+        type: DataTypes.TEXT,
+      },
+
+      device_info: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  login_logs.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.login_logs.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.login_logs.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.login_logs.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.login_logs.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return login_logs;
+};

backend/src/db/models/marks.js

@@ -0,0 +1,73 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const marks = sequelize.define(
+    'marks',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      marks_obtained: {
+        type: DataTypes.DECIMAL,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  marks.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.marks.belongsTo(db.students, {
+      as: 'student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.marks.belongsTo(db.exam_subjects, {
+      as: 'exam_subject',
+      foreignKey: {
+        name: 'exam_subjectId',
+      },
+      constraints: false,
+    });
+
+    db.marks.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.marks.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.marks.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return marks;
+};

backend/src/db/models/messages.js

@@ -0,0 +1,93 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const messages = sequelize.define(
+    'messages',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      receiver_role: {
+        type: DataTypes.ENUM,
+
+        values: ['super_admin', 'school_admin', 'teacher', 'student', 'parent'],
+      },
+
+      message_type: {
+        type: DataTypes.ENUM,
+
+        values: ['text', 'announcement', 'alert'],
+      },
+
+      content: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  messages.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.messages.belongsTo(db.users, {
+      as: 'sender',
+      foreignKey: {
+        name: 'senderId',
+      },
+      constraints: false,
+    });
+
+    db.messages.belongsTo(db.users, {
+      as: 'receiver',
+      foreignKey: {
+        name: 'receiverId',
+      },
+      constraints: false,
+    });
+
+    db.messages.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.messages.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.messages.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.messages.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return messages;
+};

backend/src/db/models/parents.js

@@ -0,0 +1,81 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const parents = sequelize.define(
+    'parents',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      full_name: {
+        type: DataTypes.TEXT,
+      },
+
+      phone_number: {
+        type: DataTypes.TEXT,
+      },
+
+      address: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  parents.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.parents.hasMany(db.students, {
+      as: 'students_parent',
+      foreignKey: {
+        name: 'parentId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.parents.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.parents.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.parents.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.parents.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return parents;
+};

backend/src/db/models/period_settings.js

@@ -0,0 +1,69 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const period_settings = sequelize.define(
+    'period_settings',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      total_periods_per_day: {
+        type: DataTypes.INTEGER,
+      },
+
+      period_duration: {
+        type: DataTypes.INTEGER,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  period_settings.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.period_settings.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.period_settings.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.period_settings.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.period_settings.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return period_settings;
+};

backend/src/db/models/permissions.js

@@ -0,0 +1,49 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const permissions = sequelize.define(
+    'permissions',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      name: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  permissions.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.permissions.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.permissions.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return permissions;
+};

backend/src/db/models/roles.js

@@ -0,0 +1,86 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const roles = sequelize.define(
+    'roles',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      name: {
+        type: DataTypes.TEXT,
+      },
+
+      role_customization: {
+        type: DataTypes.TEXT,
+      },
+
+      globalAccess: {
+        type: DataTypes.BOOLEAN,
+
+        allowNull: false,
+        defaultValue: false,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  roles.associate = (db) => {
+    db.roles.belongsToMany(db.permissions, {
+      as: 'permissions',
+      foreignKey: {
+        name: 'roles_permissionsId',
+      },
+      constraints: false,
+      through: 'rolesPermissionsPermissions',
+    });
+
+    db.roles.belongsToMany(db.permissions, {
+      as: 'permissions_filter',
+      foreignKey: {
+        name: 'roles_permissionsId',
+      },
+      constraints: false,
+      through: 'rolesPermissionsPermissions',
+    });
+
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.roles.hasMany(db.users, {
+      as: 'users_app_role',
+      foreignKey: {
+        name: 'app_roleId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.roles.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.roles.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return roles;
+};

backend/src/db/models/school_admins.js

@@ -0,0 +1,77 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const school_admins = sequelize.define(
+    'school_admins',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      full_name: {
+        type: DataTypes.TEXT,
+      },
+
+      phone_number: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  school_admins.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.school_admins.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.school_admins.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.school_admins.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.school_admins.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.school_admins.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return school_admins;
+};

backend/src/db/models/schools.js

@@ -0,0 +1,337 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const schools = sequelize.define(
+    'schools',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      name: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  schools.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.schools.hasMany(db.users, {
+      as: 'users_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.activity_logs, {
+      as: 'activity_logs_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.assignment_submissions, {
+      as: 'assignment_submissions_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.assignments, {
+      as: 'assignments_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.bills, {
+      as: 'bills_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.bills, {
+      as: 'bills_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.class_messages, {
+      as: 'class_messages_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.class_subjects, {
+      as: 'class_subjects_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.classes, {
+      as: 'classes_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.classes, {
+      as: 'classes_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.exam_subjects, {
+      as: 'exam_subjects_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.exams, {
+      as: 'exams_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.exams, {
+      as: 'exams_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.fee_payments, {
+      as: 'fee_payments_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.fee_structures, {
+      as: 'fee_structures_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.fee_structures, {
+      as: 'fee_structures_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.lesson_plans, {
+      as: 'lesson_plans_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.login_logs, {
+      as: 'login_logs_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.marks, {
+      as: 'marks_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.messages, {
+      as: 'messages_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.messages, {
+      as: 'messages_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.parents, {
+      as: 'parents_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.period_settings, {
+      as: 'period_settings_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.period_settings, {
+      as: 'period_settings_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.school_admins, {
+      as: 'school_admins_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.school_admins, {
+      as: 'school_admins_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.student_attendance, {
+      as: 'student_attendance_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.students, {
+      as: 'students_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.students, {
+      as: 'students_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.subjects, {
+      as: 'subjects_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.subjects, {
+      as: 'subjects_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.teacher_attendance, {
+      as: 'teacher_attendance_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.teacher_attendance, {
+      as: 'teacher_attendance_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.teachers, {
+      as: 'teachers_school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.teachers, {
+      as: 'teachers_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.schools.hasMany(db.timetables, {
+      as: 'timetables_schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.schools.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.schools.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return schools;
+};

backend/src/db/models/student_attendance.js

@@ -0,0 +1,79 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const student_attendance = sequelize.define(
+    'student_attendance',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      date: {
+        type: DataTypes.DATE,
+      },
+
+      status: {
+        type: DataTypes.ENUM,
+
+        values: ['present', 'absent', 'late'],
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  student_attendance.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.student_attendance.belongsTo(db.students, {
+      as: 'student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.student_attendance.belongsTo(db.teachers, {
+      as: 'marked_by',
+      foreignKey: {
+        name: 'marked_byId',
+      },
+      constraints: false,
+    });
+
+    db.student_attendance.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.student_attendance.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.student_attendance.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return student_attendance;
+};

backend/src/db/models/students.js

@@ -0,0 +1,127 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const students = sequelize.define(
+    'students',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      full_name: {
+        type: DataTypes.TEXT,
+      },
+
+      dob: {
+        type: DataTypes.DATE,
+      },
+
+      gender: {
+        type: DataTypes.ENUM,
+
+        values: ['male', 'female', 'other'],
+      },
+
+      admission_date: {
+        type: DataTypes.DATE,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  students.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.students.hasMany(db.assignment_submissions, {
+      as: 'assignment_submissions_student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.students.hasMany(db.fee_payments, {
+      as: 'fee_payments_student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.students.hasMany(db.marks, {
+      as: 'marks_student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    db.students.hasMany(db.student_attendance, {
+      as: 'student_attendance_student',
+      foreignKey: {
+        name: 'studentId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.students.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.students.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.students.belongsTo(db.parents, {
+      as: 'parent',
+      foreignKey: {
+        name: 'parentId',
+      },
+      constraints: false,
+    });
+
+    db.students.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.students.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.students.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return students;
+};

backend/src/db/models/subjects.js

@@ -0,0 +1,105 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const subjects = sequelize.define(
+    'subjects',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      name: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  subjects.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.subjects.hasMany(db.assignments, {
+      as: 'assignments_subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.hasMany(db.class_subjects, {
+      as: 'class_subjects_subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.hasMany(db.exam_subjects, {
+      as: 'exam_subjects_subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.hasMany(db.lesson_plans, {
+      as: 'lesson_plans_subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.hasMany(db.timetables, {
+      as: 'timetables_subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.subjects.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.subjects.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.subjects.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return subjects;
+};

backend/src/db/models/teacher_attendance.js

@@ -0,0 +1,79 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const teacher_attendance = sequelize.define(
+    'teacher_attendance',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      date: {
+        type: DataTypes.DATE,
+      },
+
+      status: {
+        type: DataTypes.ENUM,
+
+        values: ['present', 'absent', 'late'],
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  teacher_attendance.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.teacher_attendance.belongsTo(db.teachers, {
+      as: 'teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teacher_attendance.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.teacher_attendance.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.teacher_attendance.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.teacher_attendance.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return teacher_attendance;
+};

backend/src/db/models/teachers.js

@@ -0,0 +1,141 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const teachers = sequelize.define(
+    'teachers',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      full_name: {
+        type: DataTypes.TEXT,
+      },
+
+      subject_specialization: {
+        type: DataTypes.TEXT,
+      },
+
+      phone_number: {
+        type: DataTypes.TEXT,
+      },
+
+      joining_date: {
+        type: DataTypes.DATE,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  teachers.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.teachers.hasMany(db.assignments, {
+      as: 'assignments_teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.class_subjects, {
+      as: 'class_subjects_teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.classes, {
+      as: 'classes_class_teacher',
+      foreignKey: {
+        name: 'class_teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.lesson_plans, {
+      as: 'lesson_plans_teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.student_attendance, {
+      as: 'student_attendance_marked_by',
+      foreignKey: {
+        name: 'marked_byId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.teacher_attendance, {
+      as: 'teacher_attendance_teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.hasMany(db.timetables, {
+      as: 'timetables_teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.teachers.belongsTo(db.users, {
+      as: 'user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.belongsTo(db.schools, {
+      as: 'school',
+      foreignKey: {
+        name: 'schoolId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.teachers.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.teachers.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return teachers;
+};

backend/src/db/models/timetables.js

@@ -0,0 +1,93 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const timetables = sequelize.define(
+    'timetables',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      day_of_week: {
+        type: DataTypes.ENUM,
+
+        values: [
+          'Monday',
+
+          'Tuesday',
+
+          'Wednesday',
+
+          'Thursday',
+
+          'Friday',
+
+          'Saturday',
+
+          'Sunday',
+        ],
+      },
+
+      period_number: {
+        type: DataTypes.INTEGER,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  timetables.associate = (db) => {
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    //end loop
+
+    db.timetables.belongsTo(db.subjects, {
+      as: 'subject',
+      foreignKey: {
+        name: 'subjectId',
+      },
+      constraints: false,
+    });
+
+    db.timetables.belongsTo(db.teachers, {
+      as: 'teacher',
+      foreignKey: {
+        name: 'teacherId',
+      },
+      constraints: false,
+    });
+
+    db.timetables.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.timetables.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.timetables.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  return timetables;
+};

backend/src/db/models/users.js

@@ -0,0 +1,251 @@
+const config = require('../../config');
+const providers = config.providers;
+const crypto = require('crypto');
+const bcrypt = require('bcrypt');
+const moment = require('moment');
+
+module.exports = function (sequelize, DataTypes) {
+  const users = sequelize.define(
+    'users',
+    {
+      id: {
+        type: DataTypes.UUID,
+        defaultValue: DataTypes.UUIDV4,
+        primaryKey: true,
+      },
+
+      firstName: {
+        type: DataTypes.TEXT,
+      },
+
+      lastName: {
+        type: DataTypes.TEXT,
+      },
+
+      phoneNumber: {
+        type: DataTypes.TEXT,
+      },
+
+      email: {
+        type: DataTypes.TEXT,
+      },
+
+      disabled: {
+        type: DataTypes.BOOLEAN,
+
+        allowNull: false,
+        defaultValue: false,
+      },
+
+      password: {
+        type: DataTypes.TEXT,
+      },
+
+      emailVerified: {
+        type: DataTypes.BOOLEAN,
+
+        allowNull: false,
+        defaultValue: false,
+      },
+
+      emailVerificationToken: {
+        type: DataTypes.TEXT,
+      },
+
+      emailVerificationTokenExpiresAt: {
+        type: DataTypes.DATE,
+      },
+
+      passwordResetToken: {
+        type: DataTypes.TEXT,
+      },
+
+      passwordResetTokenExpiresAt: {
+        type: DataTypes.DATE,
+      },
+
+      provider: {
+        type: DataTypes.TEXT,
+      },
+
+      importHash: {
+        type: DataTypes.STRING(255),
+        allowNull: true,
+        unique: true,
+      },
+    },
+    {
+      timestamps: true,
+      paranoid: true,
+      freezeTableName: true,
+    },
+  );
+
+  users.associate = (db) => {
+    db.users.belongsToMany(db.permissions, {
+      as: 'custom_permissions',
+      foreignKey: {
+        name: 'users_custom_permissionsId',
+      },
+      constraints: false,
+      through: 'usersCustom_permissionsPermissions',
+    });
+
+    db.users.belongsToMany(db.permissions, {
+      as: 'custom_permissions_filter',
+      foreignKey: {
+        name: 'users_custom_permissionsId',
+      },
+      constraints: false,
+      through: 'usersCustom_permissionsPermissions',
+    });
+
+    /// loop through entities and it's fields, and if ref === current e[name] and create relation has many on parent entity
+
+    db.users.hasMany(db.activity_logs, {
+      as: 'activity_logs_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.class_messages, {
+      as: 'class_messages_sender',
+      foreignKey: {
+        name: 'senderId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.login_logs, {
+      as: 'login_logs_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.messages, {
+      as: 'messages_sender',
+      foreignKey: {
+        name: 'senderId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.messages, {
+      as: 'messages_receiver',
+      foreignKey: {
+        name: 'receiverId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.parents, {
+      as: 'parents_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.school_admins, {
+      as: 'school_admins_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.students, {
+      as: 'students_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.teachers, {
+      as: 'teachers_user',
+      foreignKey: {
+        name: 'userId',
+      },
+      constraints: false,
+    });
+
+    //end loop
+
+    db.users.belongsTo(db.roles, {
+      as: 'app_role',
+      foreignKey: {
+        name: 'app_roleId',
+      },
+      constraints: false,
+    });
+
+    db.users.belongsTo(db.schools, {
+      as: 'schools',
+      foreignKey: {
+        name: 'schoolsId',
+      },
+      constraints: false,
+    });
+
+    db.users.hasMany(db.file, {
+      as: 'avatar',
+      foreignKey: 'belongsToId',
+      constraints: false,
+      scope: {
+        belongsTo: db.users.getTableName(),
+        belongsToColumn: 'avatar',
+      },
+    });
+
+    db.users.belongsTo(db.users, {
+      as: 'createdBy',
+    });
+
+    db.users.belongsTo(db.users, {
+      as: 'updatedBy',
+    });
+  };
+
+  users.beforeCreate((users, options) => {
+    users = trimStringFields(users);
+
+    if (
+      users.provider !== providers.LOCAL &&
+      Object.values(providers).indexOf(users.provider) > -1
+    ) {
+      users.emailVerified = true;
+
+      if (!users.password) {
+        const password = crypto.randomBytes(20).toString('hex');
+
+        const hashedPassword = bcrypt.hashSync(
+          password,
+          config.bcrypt.saltRounds,
+        );
+
+        users.password = hashedPassword;
+      }
+    }
+  });
+
+  users.beforeUpdate((users, options) => {
+    users = trimStringFields(users);
+  });
+
+  return users;
+};
+
+function trimStringFields(users) {
+  users.email = users.email.trim();
+
+  users.firstName = users.firstName ? users.firstName.trim() : null;
+
+  users.lastName = users.lastName ? users.lastName.trim() : null;
+
+  return users;
+}

backend/src/db/reset.js

@@ -0,0 +1,16 @@
+const db = require('./models');
+const { execSync } = require('child_process');
+
+console.log('Resetting Database');
+
+db.sequelize
+  .sync({ force: true })
+  .then(() => {
+    execSync('sequelize db:seed:all');
+    console.log('OK');
+    process.exit();
+  })
+  .catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });