# adityakumar1223/acadzone_frontend architecture

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

- Interactive diagram: https://gitdiagram.com/adityakumar1223/acadzone_frontend
- Repository: https://github.com/adityakumar1223/acadzone_frontend

## Overview

##### Project type and purpose
- This is a full-stack web application’s frontend built with Angular CLI (v20.1.0).
- It implements a single-page application (SPA) for an educational portal (“Acadzone”) with distinct user roles: Admin, Teacher, Student, plus authentication and shared UI.

##### File structure
- Top-level Angular configuration:
– angular.json, tsconfig*.json, package.json, README.md
– src/index.html, src/main.ts bootstraps the AppModule
- src/app: feature-module layout
– auth/ (login, registration components + auth.service, auth.routes.ts)
– admin/ (dashboard, manage-students, manage-teachers + admin.service, admin.routes.ts)
– teacher/ (dashboard, manage-attendance, books, exams + teacher.service, teacher.routes.ts)
– student/ (dashboard, view-attendance, books, exams + student.service, student.routes.ts)
– shared/ (header, footer, 404 component, models, api.service)
– app.ts (root component), app.routes.ts (root routing), app.config.ts (constants)
- Build/test tooling:
– Karma specs (.spec.ts), ng serve, ng build, ng test, ng e2e

##### README for additional insights
- Confirms use of Angular CLI, local dev on http://localhost:4200
- No backend code here; services call external REST APIs

a. Browser / User Interface
– Angular SPA running in user’s browser
– Root module (AppComponent) loads Feature Modules via Router
b. Feature Modules (inside SPA)
– AuthModule (login/register)
– AdminModule (admin dashboard, student & teacher management)
– TeacherModule (attendance, books, exam management)
– StudentModule (view attendance, books, exams)
– SharedModule (common header/footer, models, ApiService)
c. Services & Data Layer
– Each feature module injects its own Service (e.g., AdminService)
– Shared ApiService wraps HttpClient for REST calls
– auth.service handles JWT tokens and authorization headers
d. External Systems
– Backend REST API (CRUD endpoints for users, attendance, exams, books)
– Authentication server (issue/verify JWT tokens)
– Database (persist users, attendance, exam, book records)

##### Relationships and interactions
- SPA → ApiService: all HTTP requests pass through ApiService to backend
- FeatureService → ApiService: role-specific services enrich endpoints (e.g., /api/admin/)
- AuthService intercepts requests to attach JWT, redirects to login on 401
- Router navigates between feature modules based on user role guards

##### Architectural patterns and principles
- Modular design – each user role isolated in its Angular module
- Separation of concerns – UI components vs data services vs shared utilities
- Dependency injection – Angular’s DI for services & interceptors
- Observable-based data flow – RxJS streams for async HTTP calls
- Lazy loading – feature modules loaded on demand via routes (improves performance)

## Diagram (Mermaid)

```mermaid
graph TD
  %% Browser and SPA
  subgraph "Browser / Angular SPA" 
    direction TB
    App["AppModule"]:::module
    subgraph "Feature Modules"
      direction TB
      subgraph "AuthModule"
        direction TB
        Login["Login Component"]:::ui
        Register["Register Component"]:::ui
        AuthService["AuthService"]:::service
      end
      subgraph "AdminModule"
        direction TB
        AdminDash["Admin Dashboard"]:::ui
        ManageStudents["Manage Students"]:::ui
        ManageTeachers["Manage Teachers"]:::ui
        AdminService["AdminService"]:::service
      end
      subgraph "TeacherModule"
        direction TB
        TeacherDash["Teacher Dashboard"]:::ui
        ManageAttendance["Manage Attendance"]:::ui
        ManageBooks["Manage Books"]:::ui
        ManageExams["Manage Exams"]:::ui
        TeacherService["TeacherService"]:::service
      end
      subgraph "StudentModule"
        direction TB
        StudentDash["Student Dashboard"]:::ui
        ViewAttendance["View Attendance"]:::ui
        ViewBooks["View Books"]:::ui
        ViewExams["View Exams"]:::ui
        StudentService["StudentService"]:::service
      end
      subgraph "SharedModule"
        direction TB
        Header["Header"]:::ui
        Footer["Footer"]:::ui
        NotFound["404 Component"]:::ui
        ApiService["ApiService"]:::service
      end
    end
  end

  %% External systems
  AuthServer["Auth Server"]:::external
  BackendAPI["Backend REST API"]:::external
  Database[(Database)]:::database

  %% Routing and flows
  App -->|"router"| Login
  App -->|"router"| Register
  App -->|"router"| AdminDash
  App -->|"router"| TeacherDash
  App -->|"router"| StudentDash

  %% Auth flow
  Login -->|"login()"| AuthService
  Register -->|"register()"| AuthService
  AuthService -->|"verify credentials"| AuthServer
  AuthServer -->|"JWT token"| AuthService
  AuthService -->|"attach JWT"| ApiService

  %% Feature services to API
  AdminService -->|"HTTP calls"| ApiService
  TeacherService -->|"HTTP calls"| ApiService
  StudentService -->|"HTTP calls"| ApiService

  %% Shared UI components (no service)
  Header -->|renders| App
  Footer -->|renders| App

  %% API to backend and DB
  ApiService -->|"REST calls"| BackendAPI
  BackendAPI -->|"queries"| Database
  Database -->|"data"| BackendAPI
  BackendAPI -->|"responses"| ApiService

  %% Click Events
  click App "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/app.ts"
  click App "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/app.routes.ts"
  click App "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/app.config.ts"
  click AuthService "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/auth/services/auth.service.ts"
  click Login "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/auth/components/login/login.ts"
  click Register "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/auth/components/register/register.ts"
  click AdminService "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/admin/services/admin.service.ts"
  click AdminDash "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/admin/components/admin-dashboard/admin-dashboard.ts"
  click ManageStudents "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/admin/components/manage-students/manage-students.ts"
  click ManageTeachers "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/admin/components/manage-teachers/manage-teachers.ts"
  click TeacherService "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/teacher/services/teacher.service.ts"
  click TeacherDash "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/teacher/components/teacher-dashboard/teacher-dashboard.ts"
  click ManageAttendance "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/teacher/components/manage-attendance/manage-attendance.ts"
  click ManageBooks "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/teacher/components/manage-books/manage-books.ts"
  click ManageExams "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/teacher/components/manage-exams/manage-exams.ts"
  click StudentService "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/student/services/student.service.ts"
  click StudentDash "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/student/components/student-dashboard/student-dashboard.ts"
  click ViewAttendance "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/student/components/view-attendance/view-attendance.ts"
  click ViewBooks "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/student/components/view-books/view-books.ts"
  click ViewExams "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/student/components/view-exams/view-exams.ts"
  click ApiService "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/shared/services/api.service.ts"
  click Header "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/shared/components/header/header.ts"
  click Footer "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/shared/components/footer/footer.ts"
  click NotFound "https://github.com/adityakumar1223/acadzone_frontend/blob/main/src/app/shared/components/not-found/not-found.ts"
  click AuthModule "https://github.com/adityakumar1223/acadzone_frontend/tree/main/src/app/auth"
  click AdminModule "https://github.com/adityakumar1223/acadzone_frontend/tree/main/src/app/admin"
  click TeacherModule "https://github.com/adityakumar1223/acadzone_frontend/tree/main/src/app/teacher"
  click StudentModule "https://github.com/adityakumar1223/acadzone_frontend/tree/main/src/app/student"
  click SharedModule "https://github.com/adityakumar1223/acadzone_frontend/tree/main/src/app/shared"

  %% Styles
  classDef module fill:#d5f5e3,stroke:#1e8449,stroke-width:2px
  classDef ui fill:#aed6f1,stroke:#1f618d,stroke-width:1px
  classDef service fill:#abebc6,stroke:#196f3d,stroke-width:1px,shape:cylinder
  classDef external fill:#d5d8dc,stroke:#85929e,stroke-width:1px
  classDef database fill:#f9e79f,stroke:#b7950b,stroke-width:1px,shape:csyl
  classDef frontend fill:#e8f8f5,stroke:#117864,stroke-width:2px
```
