# yagmurduman/manage-it architecture

> Architecture diagram of the GitHub repository yagmurduman/manage-it, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yagmurduman/manage-it
- Repository: https://github.com/yagmurduman/manage-it

## Overview

##### Project type and purpose
- Manage-IT is a full-stack, cloud-based project management platform consisting of:
- A React/Redux/Tailwind front-end (“frontend-main”)
- A Node.js/Express back-end REST API (“backend-main”)
- A database layer (implied by models/schemas.js)
- External services (e.g., payment processing, email notifications, Swagger for API docs)

##### File structure
- Top-level directories:
- backend-main/
– server.js (entry point)
– api/controllers (Express controllers by entity)
– api/routes/routes.js (API routing)
– api/middlewares (authentication, authorisation, Swagger)
– api/models/schemas.js (data schemas; likely MongoDB/Mongoose)
– api/ssl (certificates for HTTPS)
– swagger.json (API spec)
- frontend-main/
– public/ (static HTML, CSS, images)
– src/ (React app)
· components/ (UI components grouped by feature)
· redux/ (store, feature slices)
· services/ (API service wrappers: HttpService, PaymentService, etc.)
· views/ (page‐level components)
– tailwind.config.js, postcss.config.js (CSS build)

##### Key insights from README
- Provides task tracking, scheduling, reporting, project analysis
- Allows booking sessions with business analysts
- Screenshots and user workflows are documented on the GitHub page

##### Main components
a. Front-end SPA
– React application
– Redux store (application state)
– UI components, routing (React Router implied)
b. Back-end API
– Express server
– Middlewares (auth, authorization, Swagger docs)
– Controllers (action items, backlog, checkout, company, consultants, project, user)
– Models (data schemas)
c. Database
– MongoDB (or another document‐store; indicated by schemas.js)
d. External services
– Payment gateway (Stripe/PayPal via PaymentService)
– Email/SMS notifications (if applicable)
– Swagger UI (for API documentation)
e. Infrastructure/DevOps
– SSL termination (certificates in api/ssl)
– Environment variables (.env files)

##### Relationships and interactions
- Front-end ↔ Back-end
- HTTP(S) calls via HttpService → endpoints in backend-main/api/routes
- JWT or session token flows through authentication middleware
- Back-end ↔ Database
- Controllers call models → perform CRUD on data store
- Back-end ↔ External services
- CheckoutController uses PaymentService for subscription/payments
- Notification services after booking or account events
- Swagger middleware exposes swagger.json → Swagger UI endpoint

##### Architectural patterns and design principles
- Monolithic API server organized by feature‐based modules
- MVC-style layering (routes → controllers → models)
- Separation of concerns: authentication and authorization as middleware
- Redux for centralized client-side state management
- PSR-like service wrappers in front‐end/services for API abstraction

##### Essential details to capture
- All seven controllers as subcomponents of the back-end
- Authentication and authorization middleware on the request pipeline
- The Swagger docs endpoint and SSL certificate layer
- Redux store slices for each entity mirrored by backend controllers/models
- Service layer in front-end that decouples UI from API endpoints

## Diagram (Mermaid)

```mermaid
graph TB
  subgraph "Browser / Client"
    direction TB
    A2["index.js"]:::frontend
    A1["App.js"]:::frontend
    Store["store.js"]:::frontend
    S1["backlogSlice.js"]:::frontend
    S2["companySlice.js"]:::frontend
    S3["consultantsSlice.js"]:::frontend
    S4["projectSlice.js"]:::frontend
    S5["userSlice.js"]:::frontend
    Components["components/"]:::frontend
    Views["views/"]:::frontend
    Http["HttpService.js"]:::frontend
    PaymentSvc["PaymentService.js"]:::frontend
  end

  subgraph "Application Server"
    direction TB
    Server["server.js"]:::backend
    SSL["ssl/"]:::backend
    AuthMW["authentication.js"]:::backend
    AuthZMW["authorisation.js"]:::backend
    SwaggerMW["swagger.js"]:::backend
    Routes["routes.js"]:::backend
    subgraph Controllers
      direction TB
      C1["actionitemController.js"]:::backend
      C2["authController.js"]:::backend
      C3["backlogController.js"]:::backend
      C4["checkoutController.js"]:::backend
      C5["companyController.js"]:::backend
      C6["consultantsController.js"]:::backend
      C7["projectController.js"]:::backend
      C8["userController.js"]:::backend
    end
    Models["schemas.js"]:::backend
  end

  subgraph "Data Layer"
    DB["MongoDB"]:::database
  end

  subgraph "External Services"
    PayExt["Payment Gateway"]:::services
    Notify["Email/SMS"]:::services
    SwaggerUI["Swagger UI"]:::services
  end

  A2 --> A1
  A1 --> Http
  A1 --> PaymentSvc
  A1 --> Store
  A1 --> Components
  A1 --> Views
  Store --> S1
  Store --> S2
  Store --> S3
  Store --> S4
  Store --> S5
  Http --> Routes
  Server --> SSL
  Server --> Routes
  Server --> AuthMW
  Server --> AuthZMW
  Server --> SwaggerMW
  Routes --> AuthMW
  Routes --> AuthZMW
  Routes --> SwaggerMW
  Routes --> Controllers
  AuthMW --> Controllers
  AuthZMW --> Controllers
  SwaggerMW --> SwaggerUI
  Controllers --> Models
  Models --> DB
  C4 --> PayExt
  Controllers --> Notify

  click A1 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/App.js"
  click A2 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/index.js"
  click Store "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/store.js"
  click S1 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/features/backlogSlice.js"
  click S2 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/features/companySlice.js"
  click S3 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/features/consultantsSlice.js"
  click S4 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/features/projectSlice.js"
  click S5 "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/redux/features/userSlice.js"
  click Components "https://github.com/yagmurduman/manage-it/tree/main/frontend-main/src/components/"
  click Views "https://github.com/yagmurduman/manage-it/tree/main/frontend-main/src/views/"
  click Http "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/services/HttpService.js"
  click PaymentSvc "https://github.com/yagmurduman/manage-it/blob/main/frontend-main/src/services/PaymentService.js"
  click Server "https://github.com/yagmurduman/manage-it/blob/main/backend-main/server.js"
  click Routes "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/routes/routes.js"
  click C1 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/actionitemController.js"
  click C2 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/authController.js"
  click C3 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/backlogController.js"
  click C4 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/checkoutController.js"
  click C5 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/companyController.js"
  click C6 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/consultantsController.js"
  click C7 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/projectController.js"
  click C8 "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/controllers/userController.js"
  click AuthMW "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/middlewares/authentication.js"
  click AuthZMW "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/middlewares/authorisation.js"
  click SwaggerMW "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/middlewares/swagger.js"
  click Models "https://github.com/yagmurduman/manage-it/blob/main/backend-main/api/models/schemas.js"
  click SSL "https://github.com/yagmurduman/manage-it/tree/main/backend-main/api/ssl/"

  classDef frontend fill:#cce5ff,stroke:#2a9df4;
  classDef backend fill:#d4edda,stroke:#28a745;
  classDef database fill:#fff3cd,stroke:#e0a800;
  classDef services fill:#e2e3e5,stroke:#6c757d;
```
