# pauljusk/full-stack-app architecture

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

- Interactive diagram: https://gitdiagram.com/pauljusk/full-stack-app
- Repository: https://github.com/pauljusk/full-stack-app

## Overview

This is a Vue client and Express API for managing actors, quizzes, assignments, and quiz completion, with a dashboard and results-oriented pages. The main documented workflow spans actor and quiz management, assigning quizzes, and recording completion; sampled server code confirms the controller-to-service/model and database calls. The README documents authentication, validation, error handling, and API documentation, but those routes and client request flows were not fully sampled, so uncertain connections are omitted.

Main entry points: [`client/src/router/index.ts`](https://github.com/pauljusk/full-stack-app/blob/main/client/src/router/index.ts) (Client router), [`server/src/modules/dev/dev.service.ts`](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.service.ts) (Development service), [`server/src/modules/quiz/quiz.service.ts`](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/quiz/quiz.service.ts) (Quiz service), [`server/src/routes/api.route.ts`](https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/api.route.ts) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Vue client"]
  node_app["Vue application<br/>[App.vue]"]
  node_header["Navigation<br/>[Header.vue]"]
  node_dashboard["Dashboard<br/>[DashboardPage.vue]"]
  node_assignments["Assignments"]
  node_takequiz["Take quiz<br/>[TakeQuizPage.vue]"]
  node_results["Results<br/>[ResultsPage.vue]"]
  node_reports["Reports<br/>[ReportsPage.vue]"]
  node_router["Client router<br/>[index.ts]"]
  node_authstore["Authentication state<br/>[auth.store.ts]"]
end

subgraph group_actor["Actor domain"]
  node_actorui["Actor management<br/>[ActorPage.vue]"]
  node_actorquizzes["Actor quizzes<br/>[ActorQuizzes.vue]"]
  node_actorstore["Actor store<br/>[actor.store.ts]"]
  node_actorroute["Actor routes<br/>[actor.route.ts]"]
  node_actorcontroller["Actor controller"]
  node_actorservice["Actor service<br/>[actor.service.ts]"]
end

subgraph group_quiz["Quiz domain"]
  node_quizui["Quiz management<br/>[QuizesPage.vue]"]
  node_newquiz["Create quiz<br/>[NewQuizPage.vue]"]
  node_editquiz["Edit quiz<br/>[EditQuizPage.vue]"]
  node_quizroute["Quiz routes<br/>[quiz.route.ts]"]
  node_quizcontroller["Quiz controller<br/>[quiz.controller.ts]"]
  node_quizservice["Quiz service<br/>[quiz.service.ts]"]
end

subgraph group_server["API platform"]
  node_serverapp["Express app<br/>[app.ts]"]
  node_routes["Route assembly<br/>[index.ts]"]
  node_apiroutes["API routes<br/>[api.route.ts]"]
  node_webroutes["Web routes<br/>[web.route.ts]"]
  node_models["Data models"]
  node_database[("Database<br/>[db.ts]")]
  node_auth["Authentication<br/>[passport.ts]"]
  node_devroutes["Development routes<br/>[dev.route.ts]"]
  node_devcontroller["Development controller<br/>[dev.controller.ts]"]
  node_devservice["Development service<br/>[dev.service.ts]"]
  node_seeddata["Seed data<br/>[data-feed.ts]"]
  node_validation["Request validation<br/>[validate.ts]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_header
node_app -->|"hosts views"| node_router
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_assignments
node_router -->|"routes to"| node_takequiz
node_router -->|"routes to"| node_results
node_router -->|"routes to"| node_reports
node_actorcontroller -->|"calls"| node_actorservice
node_actorcontroller -->|"calls"| node_models
node_actorservice -->|"queries"| node_database
node_quizcontroller -->|"calls"| node_quizservice
node_quizcontroller -->|"calls"| node_models
node_quizservice -->|"queries"| node_database
node_quizservice -->|"uses"| node_models
node_serverapp -->|"mounts"| node_routes
node_serverapp -->|"configures"| node_auth
node_routes -->|"registers"| node_apiroutes
node_routes -->|"registers"| node_webroutes
node_devcontroller -->|"calls"| node_devservice
node_devcontroller -->|"calls"| node_models
node_devservice -->|"imports"| node_seeddata
node_devservice -->|"initializes"| node_database
node_devservice -->|"creates quizzes"| node_quizservice
node_actorui -.->|"uses routes"| node_actorroute
node_actorquizzes -.->|"uses"| node_actorstore
node_quizui -.->|"uses routes"| node_quizroute
node_newquiz -.->|"uses routes"| node_quizroute
node_editquiz -.->|"uses routes"| node_quizroute
node_apiroutes -.->|"dispatches"| node_actorcontroller
node_apiroutes -.->|"dispatches"| node_quizcontroller
node_devroutes -.->|"dispatches"| node_devcontroller
node_validation -.->|"validates requests"| node_apiroutes

click node_app "https://github.com/pauljusk/full-stack-app/blob/main/client/src/App.vue"
click node_header "https://github.com/pauljusk/full-stack-app/blob/main/client/src/components/Header.vue"
click node_dashboard "https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/DashboardPage.vue"
click node_assignments "https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/AssignmentsPage.vue"
click node_takequiz "https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/TakeQuizPage.vue"
click node_results "https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/ResultsPage.vue"
click node_reports "https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/ReportsPage.vue"
click node_actorui "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/pages/ActorPage.vue"
click node_actorquizzes "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/pages/components/ActorQuizzes.vue"
click node_actorstore "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/actor.store.ts"
click node_quizui "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/quizes/QuizesPage.vue"
click node_newquiz "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/new-quiz/NewQuizPage.vue"
click node_editquiz "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/edit-quiz/EditQuizPage.vue"
click node_quizroute "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/quiz.route.ts"
click node_actorroute "https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/actor.route.ts"
click node_router "https://github.com/pauljusk/full-stack-app/blob/main/client/src/router/index.ts"
click node_authstore "https://github.com/pauljusk/full-stack-app/blob/main/client/src/stores/auth.store.ts"
click node_serverapp "https://github.com/pauljusk/full-stack-app/blob/main/server/src/app.ts"
click node_routes "https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/index.ts"
click node_apiroutes "https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/api.route.ts"
click node_webroutes "https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/web.route.ts"
click node_actorcontroller "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/actor/actor.controller.ts"
click node_actorservice "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/actor/actor.service.ts"
click node_quizcontroller "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/quiz/quiz.controller.ts"
click node_quizservice "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/quiz/quiz.service.ts"
click node_models "https://github.com/pauljusk/full-stack-app/tree/main/server/src/models"
click node_database "https://github.com/pauljusk/full-stack-app/blob/main/server/src/config/db.ts"
click node_auth "https://github.com/pauljusk/full-stack-app/blob/main/server/src/config/passport.ts"
click node_devroutes "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.route.ts"
click node_devcontroller "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.controller.ts"
click node_devservice "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.service.ts"
click node_seeddata "https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/data-feed.ts"
click node_validation "https://github.com/pauljusk/full-stack-app/blob/main/server/src/middlewares/validate.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_app,node_header,node_dashboard,node_assignments,node_takequiz,node_results,node_reports,node_router,node_authstore,node_user toneBlue
class node_actorui,node_actorquizzes,node_actorstore,node_actorroute,node_actorcontroller,node_actorservice toneAmber
class node_quizui,node_newquiz,node_editquiz,node_quizroute,node_quizcontroller,node_quizservice toneMint
class node_serverapp,node_routes,node_apiroutes,node_webroutes,node_models,node_database,node_auth,node_devroutes,node_devcontroller,node_devservice,node_seeddata,node_validation toneRose
```

## Components

### Vue client

- [Vue application](https://github.com/pauljusk/full-stack-app/blob/main/client/src/App.vue): `client/src/App.vue`
- [Navigation](https://github.com/pauljusk/full-stack-app/blob/main/client/src/components/Header.vue): `client/src/components/Header.vue`
- [Dashboard](https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/DashboardPage.vue): `client/src/pages/DashboardPage.vue`
- [Assignments](https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/AssignmentsPage.vue): `client/src/pages/AssignmentsPage.vue`
- [Take quiz](https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/TakeQuizPage.vue): `client/src/pages/TakeQuizPage.vue`
- [Results](https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/ResultsPage.vue): `client/src/pages/ResultsPage.vue`
- [Reports](https://github.com/pauljusk/full-stack-app/blob/main/client/src/pages/ReportsPage.vue): `client/src/pages/ReportsPage.vue`
- [Client router](https://github.com/pauljusk/full-stack-app/blob/main/client/src/router/index.ts): `client/src/router/index.ts`
- [Authentication state](https://github.com/pauljusk/full-stack-app/blob/main/client/src/stores/auth.store.ts): `client/src/stores/auth.store.ts`

### Actor domain

- [Actor management](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/pages/ActorPage.vue): `client/src/modules/actor/pages/ActorPage.vue`
- [Actor quizzes](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/pages/components/ActorQuizzes.vue): `client/src/modules/actor/pages/components/ActorQuizzes.vue`
- [Actor store](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/actor.store.ts): `client/src/modules/actor/actor.store.ts`
- [Actor routes](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/actor/actor.route.ts): `client/src/modules/actor/actor.route.ts`
- [Actor controller](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/actor/actor.controller.ts): `server/src/modules/actor/actor.controller.ts`
- [Actor service](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/actor/actor.service.ts): `server/src/modules/actor/actor.service.ts`

### Quiz domain

- [Quiz management](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/quizes/QuizesPage.vue): `client/src/modules/quiz/pages/quizes/QuizesPage.vue`
- [Create quiz](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/new-quiz/NewQuizPage.vue): `client/src/modules/quiz/pages/new-quiz/NewQuizPage.vue`
- [Edit quiz](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/pages/edit-quiz/EditQuizPage.vue): `client/src/modules/quiz/pages/edit-quiz/EditQuizPage.vue`
- [Quiz routes](https://github.com/pauljusk/full-stack-app/blob/main/client/src/modules/quiz/quiz.route.ts): `client/src/modules/quiz/quiz.route.ts`
- [Quiz controller](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/quiz/quiz.controller.ts): `server/src/modules/quiz/quiz.controller.ts`
- [Quiz service](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/quiz/quiz.service.ts): `server/src/modules/quiz/quiz.service.ts`

### API platform

- [Express app](https://github.com/pauljusk/full-stack-app/blob/main/server/src/app.ts): `server/src/app.ts`
- [Route assembly](https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/index.ts): `server/src/routes/index.ts`
- [API routes](https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/api.route.ts): `server/src/routes/api.route.ts`
- [Web routes](https://github.com/pauljusk/full-stack-app/blob/main/server/src/routes/web.route.ts): `server/src/routes/web.route.ts`
- [Data models](https://github.com/pauljusk/full-stack-app/tree/main/server/src/models): `server/src/models`
- [Database](https://github.com/pauljusk/full-stack-app/blob/main/server/src/config/db.ts): `server/src/config/db.ts`
- [Authentication](https://github.com/pauljusk/full-stack-app/blob/main/server/src/config/passport.ts): `server/src/config/passport.ts`
- [Development routes](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.route.ts): `server/src/modules/dev/dev.route.ts`
- [Development controller](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.controller.ts): `server/src/modules/dev/dev.controller.ts`
- [Development service](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/dev.service.ts): `server/src/modules/dev/dev.service.ts`
- [Seed data](https://github.com/pauljusk/full-stack-app/blob/main/server/src/modules/dev/data-feed.ts): `server/src/modules/dev/data-feed.ts`
- [Request validation](https://github.com/pauljusk/full-stack-app/blob/main/server/src/middlewares/validate.ts): `server/src/middlewares/validate.ts`

### Other components

- **User**

## Connections

- User → Vue application: uses (evidence: `client/src/App.vue`)
- Vue application → Navigation: renders (evidence: `client/src/App.vue`)
- Vue application → Client router: hosts views (evidence: `client/src/main.ts`)
- Client router → Dashboard: routes to (evidence: `client/src/router/index.ts`)
- Client router → Assignments: routes to (evidence: `client/src/router/index.ts`)
- Client router → Take quiz: routes to (evidence: `client/src/router/index.ts`)
- Client router → Results: routes to (evidence: `client/src/router/index.ts`)
- Client router → Reports: routes to (evidence: `client/src/router/index.ts`)
- Actor controller → Actor service: calls (evidence: `server/src/modules/actor/actor.controller.ts`)
- Actor controller → Data models: calls (evidence: `server/src/modules/actor/actor.controller.ts`)
- Actor service → Database: queries (evidence: `server/src/modules/actor/actor.service.ts`)
- Quiz controller → Quiz service: calls (evidence: `server/src/modules/quiz/quiz.controller.ts`)
- Quiz controller → Data models: calls (evidence: `server/src/modules/quiz/quiz.controller.ts`)
- Quiz service → Database: queries (evidence: `server/src/modules/quiz/quiz.service.ts`)
- Quiz service → Data models: uses (evidence: `server/src/modules/quiz/quiz.service.ts`)
- Express app → Route assembly: mounts (evidence: `server/src/app.ts`)
- Express app → Authentication: configures (evidence: `server/src/app.ts`)
- Route assembly → API routes: registers (evidence: `server/src/routes/index.ts`)
- Route assembly → Web routes: registers (evidence: `server/src/routes/index.ts`)
- Development controller → Development service: calls (evidence: `server/src/modules/dev/dev.controller.ts`)
- Development controller → Data models: calls (evidence: `server/src/modules/dev/dev.controller.ts`)
- Development service → Seed data: imports (evidence: `server/src/modules/dev/dev.service.ts`)
- Development service → Database: initializes (evidence: `server/src/modules/dev/dev.service.ts`)
- Development service → Quiz service: creates quizzes (evidence: `server/src/modules/dev/dev.service.ts`)
- Actor management → Actor routes: uses routes
- Actor quizzes → Actor store: uses
- Quiz management → Quiz routes: uses routes
- Create quiz → Quiz routes: uses routes
- Edit quiz → Quiz routes: uses routes
- API routes → Actor controller: dispatches
- API routes → Quiz controller: dispatches
- Development routes → Development controller: dispatches
- Request validation → API routes: validates requests
