# vishwabhat19/instructor architecture

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

- Interactive diagram: https://gitdiagram.com/vishwabhat19/instructor
- Repository: https://github.com/vishwabhat19/instructor

## Overview

Instructor is a small Spring Boot customer-management application. A web user enters through the application, and the customer controller handles listing, creating, updating, and deleting records through a Spring Data repository; controller responses select JSP views. The customer entity defines the persisted data shape. The excerpts establish repository operations but do not reveal database configuration or the JSP rendering setup, so those internals are not expanded here.

Main entry points: [`src/main/java/com/instructor/controller/CustomerController.java`](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/controller/CustomerController.java) (Customer controller), [`src/main/java/com/instructor/CustomerApplication.java`](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/CustomerApplication.java) (Spring Boot app), [`src/main/java/com/instructor/repository/CustomerRepository.java`](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/repository/CustomerRepository.java) (Customer repository), [`src/main/java/com/instructor/entity/Customer.java`](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/entity/Customer.java) (Customer entity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Web runtime"]
  node_app["Spring Boot app"]
  node_controller["Customer controller"]
end

subgraph group_data["Customer data"]
  node_customer["Customer entity<br/>[Customer.java]"]
  node_repository["Customer repository"]
end

subgraph group_views["JSP views"]
  node_list["Customer list JSP<br/>[list-customers.jsp]"]
  node_form["Customer form JSP"]
end

node_user(("Web user"))

node_user -.->|"starts web app"| node_app
node_app -.->|"serves requests"| node_controller
node_controller -->|"queries and mutates"| node_repository
node_controller -->|"creates and binds"| node_customer
node_repository -->|"manages records"| node_customer
node_controller -->|"returns list view"| node_list
node_controller -->|"returns form view"| node_form

click node_app "https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/CustomerApplication.java"
click node_controller "https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/controller/CustomerController.java"
click node_customer "https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/entity/Customer.java"
click node_repository "https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/repository/CustomerRepository.java"
click node_list "https://github.com/vishwabhat19/instructor/blob/master/src/main/webapp/WEB-INF/view/list-customers.jsp"
click node_form "https://github.com/vishwabhat19/instructor/blob/master/src/main/webapp/WEB-INF/view/add-customer-form.jsp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_controller,node_user toneBlue
class node_customer,node_repository toneAmber
class node_list,node_form toneMint
```

## Components

### Web runtime

- [Spring Boot app](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/CustomerApplication.java): `src/main/java/com/instructor/CustomerApplication.java`
- [Customer controller](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/controller/CustomerController.java): `src/main/java/com/instructor/controller/CustomerController.java`

### Customer data

- [Customer entity](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/entity/Customer.java): `src/main/java/com/instructor/entity/Customer.java`
- [Customer repository](https://github.com/vishwabhat19/instructor/blob/master/src/main/java/com/instructor/repository/CustomerRepository.java): `src/main/java/com/instructor/repository/CustomerRepository.java`

### JSP views

- [Customer list JSP](https://github.com/vishwabhat19/instructor/blob/master/src/main/webapp/WEB-INF/view/list-customers.jsp): `src/main/webapp/WEB-INF/view/list-customers.jsp`
- [Customer form JSP](https://github.com/vishwabhat19/instructor/blob/master/src/main/webapp/WEB-INF/view/add-customer-form.jsp): `src/main/webapp/WEB-INF/view/add-customer-form.jsp`

### Other components

- **Web user**

## Connections

- Web user → Spring Boot app: starts web app
- Spring Boot app → Customer controller: serves requests
- Customer controller → Customer repository: queries and mutates (evidence: `src/main/java/com/instructor/controller/CustomerController.java`)
- Customer controller → Customer entity: creates and binds (evidence: `src/main/java/com/instructor/controller/CustomerController.java`)
- Customer repository → Customer entity: manages records (evidence: `src/main/java/com/instructor/repository/CustomerRepository.java`)
- Customer controller → Customer list JSP: returns list view (evidence: `src/main/java/com/instructor/controller/CustomerController.java`)
- Customer controller → Customer form JSP: returns form view (evidence: `src/main/java/com/instructor/controller/CustomerController.java`)
