# eonevsg/ita-5-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/eonevsg/ita-5-frontend
- Repository: https://github.com/eonevsg/ita-5-frontend

## Overview

This is an Angular admissions application: applicants submit personal details and answers, while staff authenticate, review submissions, and update evaluations or application status. The runtime is organized around routed pages, shared HTTP services, and typed application models. The form service communicates with an external backend for questions, schools, submissions, and review data; authentication supplies a token to requests. Source excerpts establish the main calls, while some page and integration details are represented only by the module routes or service API.

Main entry points: [`src/app/app.module.ts`](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/app.module.ts) (Route configuration), [`src/app/form-page/form-page.component.ts`](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/form-page/form-page.component.ts) (Application form), [`src/app/answer-details/answer-details.component.ts`](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/answer-details/answer-details.component.ts) (Answer details), [`src/app/services/application-form-service/form.service.ts`](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/application-form-service/form.service.ts) (Application API service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_bootstrap["Angular bootstrap<br/>[main.ts]"]
  node_app["Root application<br/>[app.component.ts]"]
  node_routing["Route configuration<br/>[app.module.ts]"]
  node_header["Header navigation"]
  node_home["Home page"]
  node_footer["Footer"]
end

subgraph group_applicant["Applicant intake"]
  node_form["Application form"]
end

subgraph group_review["Staff review"]
  node_login["Login page"]
  node_answerlist["Answer list"]
  node_details["Answer details"]
  node_filter["List filtering<br/>[list-filter.ts]"]
end

subgraph group_shared["Services and models"]
  node_formservice["Application API service<br/>[form.service.ts]"]
  node_auth["Authentication service<br/>[auth.service.ts]"]
  node_interceptor["Auth HTTP interceptor"]
  node_person["Applicant model<br/>[person.ts]"]
  node_answer["Question answer model<br/>[answer.ts]"]
  node_answerperson["Submission model<br/>[answer-person.ts]"]
  node_answerview["Review view model<br/>[answerView.ts]"]
  node_user["User model<br/>[user.ts]"]
end

node_browser(("Browser user"))
node_backend[("Admissions backend")]

node_browser -->|"uses"| node_app
node_bootstrap -->|"bootstraps"| node_routing
node_routing -->|"bootstraps"| node_app
node_routing -->|"routes"| node_home
node_routing -->|"routes"| node_form
node_routing -->|"routes"| node_login
node_routing -->|"routes"| node_answerlist
node_routing -->|"routes"| node_details
node_routing -->|"registers"| node_filter
node_form -->|"loads and submits"| node_formservice
node_form -->|"builds submission"| node_answerperson
node_form -->|"builds answers"| node_answer
node_form -->|"builds applicant"| node_person
node_formservice -->|"requests API data"| node_backend
node_login -->|"authenticates"| node_auth
node_login -->|"submits credentials"| node_user
node_auth -->|"posts login"| node_backend
node_interceptor -->|"reads token"| node_auth
node_answerlist -->|"loads answers"| node_formservice
node_answerlist -->|"reads applicants"| node_person
node_details -->|"loads and updates"| node_formservice
node_details -->|"reads applicant"| node_person
node_details -->|"reads questions"| node_answer
node_details -->|"displays response"| node_answerview
node_header -->|"uses authentication"| node_auth

click node_bootstrap "https://github.com/eonevsg/ita-5-frontend/blob/master/src/main.ts"
click node_app "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/app.component.ts"
click node_routing "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/app.module.ts"
click node_header "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/header/header.component.ts"
click node_home "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/home-page/home-page.component.ts"
click node_footer "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/footer/footer.component.ts"
click node_form "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/form-page/form-page.component.ts"
click node_login "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/login-page/login-page.component.ts"
click node_answerlist "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/answer-list/answer-list.component.ts"
click node_details "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/answer-details/answer-details.component.ts"
click node_filter "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/filter/list-filter.ts"
click node_formservice "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/application-form-service/form.service.ts"
click node_auth "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/auth/auth.service.ts"
click node_interceptor "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/auth/auth-http-interceptor.ts"
click node_person "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/person.ts"
click node_answer "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answer.ts"
click node_answerperson "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answer-person.ts"
click node_answerview "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answerView.ts"
click node_user "https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/user.ts"

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_bootstrap,node_app,node_routing,node_header,node_home,node_footer,node_browser toneBlue
class node_form,node_backend toneAmber
class node_login,node_answerlist,node_details,node_filter toneMint
class node_formservice,node_auth,node_interceptor,node_person,node_answer,node_answerperson,node_answerview,node_user toneRose
```

## Components

### Application runtime

- [Angular bootstrap](https://github.com/eonevsg/ita-5-frontend/blob/master/src/main.ts): `src/main.ts`
- [Root application](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/app.component.ts): `src/app/app.component.ts`
- [Route configuration](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/app.module.ts): `src/app/app.module.ts`
- [Header navigation](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/header/header.component.ts): `src/app/header/header.component.ts`
- [Home page](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/home-page/home-page.component.ts): `src/app/home-page/home-page.component.ts`
- [Footer](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/footer/footer.component.ts): `src/app/footer/footer.component.ts`

### Applicant intake

- [Application form](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/form-page/form-page.component.ts): `src/app/form-page/form-page.component.ts`

### Staff review

- [Login page](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/login-page/login-page.component.ts): `src/app/login-page/login-page.component.ts`
- [Answer list](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/answer-list/answer-list.component.ts): `src/app/answer-list/answer-list.component.ts`
- [Answer details](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/answer-details/answer-details.component.ts): `src/app/answer-details/answer-details.component.ts`
- [List filtering](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/filter/list-filter.ts): `src/app/filter/list-filter.ts`

### Services and models

- [Application API service](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/application-form-service/form.service.ts): `src/app/services/application-form-service/form.service.ts`
- [Authentication service](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/auth/auth.service.ts): `src/app/services/auth/auth.service.ts`
- [Auth HTTP interceptor](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/services/auth/auth-http-interceptor.ts): `src/app/services/auth/auth-http-interceptor.ts`
- [Applicant model](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/person.ts): `src/app/models/person.ts`
- [Question answer model](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answer.ts): `src/app/models/answer.ts`
- [Submission model](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answer-person.ts): `src/app/models/answer-person.ts`
- [Review view model](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/answerView.ts): `src/app/models/answerView.ts`
- [User model](https://github.com/eonevsg/ita-5-frontend/blob/master/src/app/models/user.ts): `src/app/models/user.ts`

### Other components

- **Browser user**
- **Admissions backend**

## Connections

- Browser user → Root application: uses (evidence: `src/app/app.component.ts`)
- Angular bootstrap → Route configuration: bootstraps (evidence: `src/main.ts`)
- Route configuration → Root application: bootstraps (evidence: `src/app/app.module.ts`)
- Route configuration → Home page: routes (evidence: `src/app/app.module.ts`)
- Route configuration → Application form: routes (evidence: `src/app/app.module.ts`)
- Route configuration → Login page: routes (evidence: `src/app/app.module.ts`)
- Route configuration → Answer list: routes (evidence: `src/app/app.module.ts`)
- Route configuration → Answer details: routes (evidence: `src/app/app.module.ts`)
- Route configuration → List filtering: registers (evidence: `src/app/app.module.ts`)
- Application form → Application API service: loads and submits (evidence: `src/app/form-page/form-page.component.ts`)
- Application form → Submission model: builds submission (evidence: `src/app/form-page/form-page.component.ts`)
- Application form → Question answer model: builds answers (evidence: `src/app/form-page/form-page.component.ts`)
- Application form → Applicant model: builds applicant (evidence: `src/app/form-page/form-page.component.ts`)
- Application API service → Admissions backend: requests API data (evidence: `src/app/services/application-form-service/form.service.ts`)
- Login page → Authentication service: authenticates (evidence: `src/app/login-page/login-page.component.ts`)
- Login page → User model: submits credentials (evidence: `src/app/login-page/login-page.component.ts`)
- Authentication service → Admissions backend: posts login (evidence: `src/app/services/auth/auth.service.ts`)
- Auth HTTP interceptor → Authentication service: reads token (evidence: `src/app/services/auth/auth-http-interceptor.ts`)
- Answer list → Application API service: loads answers (evidence: `src/app/answer-list/answer-list.component.ts`)
- Answer list → Applicant model: reads applicants (evidence: `src/app/answer-list/answer-list.component.ts`)
- Answer details → Application API service: loads and updates (evidence: `src/app/answer-details/answer-details.component.ts`)
- Answer details → Applicant model: reads applicant (evidence: `src/app/answer-details/answer-details.component.ts`)
- Answer details → Question answer model: reads questions (evidence: `src/app/answer-details/answer-details.component.ts`)
- Answer details → Review view model: displays response (evidence: `src/app/answer-details/answer-details.component.ts`)
- Header navigation → Authentication service: uses authentication (evidence: `src/app/header/header.component.ts`)
