# martin-hayot/projet-dev-3 architecture

> Architecture diagram of the GitHub repository martin-hayot/projet-dev-3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martin-hayot/projet-dev-3
- Repository: https://github.com/martin-hayot/projet-dev-3

## Overview

Electric City is a client/server application for music-mastering orders, appointment scheduling, user accounts, and administration. Its principal domain workflow is order submission and management: the client exposes order and admin screens, while the Express API handles order records and uploaded audio. The sampled server code confirms route registration, database access, and authentication middleware. Client-to-API interactions and the full appointment/admin flows are not shown in sampled client source, so those links are omitted rather than inferred.

Main entry points: [`electric-city/server/server.js`](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/server.js) (Express API), [`electric-city/server/utils/db.server.ts`](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/utils/db.server.ts) (Prisma database client), [`electric-city/server/middleware/auth.js`](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/middleware/auth.js) (Token verification), [`electric-city/server/routes/auth.js`](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/auth.js) (Signup and login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["Nuxt application shell<br/>[app.vue]"]
  node_public_pages["Public pages<br/>[index.vue]"]
  node_signup_page["Signup page<br/>[signup.vue]"]
  node_user_orders["Customer orders<br/>[orders.vue]"]
  node_new_order["Submit order<br/>[new-order.vue]"]
  node_user_appointments["Customer appointments<br/>[appointments.vue]"]
  node_admin_orders["Admin orders<br/>[orders.vue]"]
  node_admin_appointments["Admin appointments<br/>[appointments.vue]"]
  node_admin_display["Admin display<br/>[display.vue]"]
end

subgraph group_account["Accounts and access"]
  node_auth_routes["Signup and login<br/>[auth.js]"]
  node_auth_middleware["Token verification<br/>[auth.js]"]
  node_profile_routes["Profile management<br/>[profile.js]"]
end

subgraph group_orders["Order management"]
  node_order_routes["Order records and files<br/>[orders.js]"]
end

subgraph group_appointments["Appointments"]
  node_agenda_routes["Appointment scheduling<br/>[agenda.js]"]
end

subgraph group_communications["Messages and email"]
  node_messages_routes["Contact messages<br/>[messages.js]"]
  node_admin_messages["Admin message listing<br/>[adminMessages.js]"]
  node_delete_messages["Message deletion<br/>[deleteMessages.js]"]
  node_mail_route["Order mail endpoint<br/>[mail.js]"]
  node_mail_template["Confirmation email template"]
end

subgraph group_data["Persistence"]
  node_api["Express API<br/>[server.js]"]
  node_database[("Prisma database client<br/>[db.server.ts]")]
end

node_browser(("Customer or admin"))

node_api -->|"routes to"| node_auth_routes
node_api -->|"routes to"| node_order_routes
node_api -->|"routes to"| node_profile_routes
node_api -->|"routes to"| node_agenda_routes
node_api -->|"routes to"| node_messages_routes
node_api -->|"routes to"| node_admin_messages
node_api -->|"routes to"| node_delete_messages
node_api -->|"routes to"| node_mail_route
node_auth_routes -->|"reads and writes"| node_database
node_auth_routes -->|"uses token functions"| node_auth_middleware
node_profile_routes -->|"reads and writes"| node_database
node_profile_routes -->|"uses token functions"| node_auth_middleware
node_order_routes -->|"reads and writes"| node_database
node_order_routes -->|"verifies tokens"| node_auth_middleware
node_agenda_routes -->|"reads and writes"| node_database
node_agenda_routes -->|"uses token functions"| node_auth_middleware
node_messages_routes -->|"writes messages"| node_database
node_admin_messages -->|"reads messages"| node_database
node_delete_messages -->|"deletes messages"| node_database
node_mail_route -->|"validates records"| node_database
node_mail_route -->|"imports template"| node_mail_template

click node_app "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/app.vue"
click node_public_pages "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/index.vue"
click node_signup_page "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/signup.vue"
click node_user_orders "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/orders.vue"
click node_new_order "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/new-order.vue"
click node_user_appointments "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/appointments.vue"
click node_admin_orders "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/orders.vue"
click node_admin_appointments "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/appointments.vue"
click node_admin_display "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/display.vue"
click node_api "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/server.js"
click node_auth_routes "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/auth.js"
click node_auth_middleware "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/middleware/auth.js"
click node_profile_routes "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/profile.js"
click node_order_routes "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/orders.js"
click node_agenda_routes "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/agenda.js"
click node_messages_routes "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/messages.js"
click node_admin_messages "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/adminMessages.js"
click node_delete_messages "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/deleteMessages.js"
click node_mail_route "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/mail.js"
click node_mail_template "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/utils/mailOrderConfirmation.js"
click node_database "https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/utils/db.server.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_public_pages,node_signup_page,node_user_orders,node_new_order,node_user_appointments,node_admin_orders,node_admin_appointments,node_admin_display toneBlue
class node_auth_routes,node_auth_middleware,node_profile_routes toneAmber
class node_order_routes toneMint
class node_agenda_routes toneRose
class node_messages_routes,node_admin_messages,node_delete_messages,node_mail_route,node_mail_template,node_browser toneIndigo
class node_api,node_database toneTeal
```

## Components

### Client application

- [Nuxt application shell](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/app.vue): `electric-city/client/app.vue`
- [Public pages](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/index.vue): `electric-city/client/pages/index.vue`
- [Signup page](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/signup.vue): `electric-city/client/pages/signup.vue`
- [Customer orders](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/orders.vue): `electric-city/client/pages/user/orders.vue`
- [Submit order](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/new-order.vue): `electric-city/client/pages/user/new-order.vue`
- [Customer appointments](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/user/appointments.vue): `electric-city/client/pages/user/appointments.vue`
- [Admin orders](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/orders.vue): `electric-city/client/pages/admin/orders.vue`
- [Admin appointments](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/appointments.vue): `electric-city/client/pages/admin/appointments.vue`
- [Admin display](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/client/pages/admin/display.vue): `electric-city/client/pages/admin/display.vue`

### Accounts and access

- [Signup and login](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/auth.js): `electric-city/server/routes/auth.js`
- [Token verification](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/middleware/auth.js): `electric-city/server/middleware/auth.js`
- [Profile management](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/profile.js): `electric-city/server/routes/profile.js`

### Order management

- [Order records and files](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/orders.js): `electric-city/server/routes/orders.js`

### Appointments

- [Appointment scheduling](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/agenda.js): `electric-city/server/routes/agenda.js`

### Messages and email

- [Contact messages](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/messages.js): `electric-city/server/routes/messages.js`
- [Admin message listing](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/adminMessages.js): `electric-city/server/routes/adminMessages.js`
- [Message deletion](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/deleteMessages.js): `electric-city/server/routes/deleteMessages.js`
- [Order mail endpoint](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/routes/mail.js): `electric-city/server/routes/mail.js`
- [Confirmation email template](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/utils/mailOrderConfirmation.js): `electric-city/server/utils/mailOrderConfirmation.js`

### Persistence

- [Express API](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/server.js): `electric-city/server/server.js`
- [Prisma database client](https://github.com/martin-hayot/projet-dev-3/blob/main/electric-city/server/utils/db.server.ts): `electric-city/server/utils/db.server.ts`

### Other components

- **Customer or admin**

## Connections

- Express API → Signup and login: routes to (evidence: `electric-city/server/server.js`)
- Express API → Order records and files: routes to (evidence: `electric-city/server/server.js`)
- Express API → Profile management: routes to (evidence: `electric-city/server/server.js`)
- Express API → Appointment scheduling: routes to (evidence: `electric-city/server/server.js`)
- Express API → Contact messages: routes to (evidence: `electric-city/server/server.js`)
- Express API → Admin message listing: routes to (evidence: `electric-city/server/server.js`)
- Express API → Message deletion: routes to (evidence: `electric-city/server/server.js`)
- Express API → Order mail endpoint: routes to (evidence: `electric-city/server/server.js`)
- Signup and login → Prisma database client: reads and writes (evidence: `electric-city/server/routes/auth.js`)
- Signup and login → Token verification: uses token functions (evidence: `electric-city/server/routes/auth.js`)
- Profile management → Prisma database client: reads and writes (evidence: `electric-city/server/routes/profile.js`)
- Profile management → Token verification: uses token functions (evidence: `electric-city/server/routes/profile.js`)
- Order records and files → Prisma database client: reads and writes (evidence: `electric-city/server/routes/orders.js`)
- Order records and files → Token verification: verifies tokens (evidence: `electric-city/server/routes/orders.js`)
- Appointment scheduling → Prisma database client: reads and writes (evidence: `electric-city/server/routes/agenda.js`)
- Appointment scheduling → Token verification: uses token functions (evidence: `electric-city/server/routes/agenda.js`)
- Contact messages → Prisma database client: writes messages (evidence: `electric-city/server/routes/messages.js`)
- Admin message listing → Prisma database client: reads messages (evidence: `electric-city/server/routes/adminMessages.js`)
- Message deletion → Prisma database client: deletes messages (evidence: `electric-city/server/routes/deleteMessages.js`)
- Order mail endpoint → Prisma database client: validates records (evidence: `electric-city/server/routes/mail.js`)
- Order mail endpoint → Confirmation email template: imports template (evidence: `electric-city/server/routes/mail.js`)
