# intweb2026/linqproduction2027 architecture

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

- Interactive diagram: https://gitdiagram.com/intweb2026/linqproduction2027
- Repository: https://github.com/intweb2026/linqproduction2027

## Overview

This is a multi-site event and conference platform: visitors browse event content, register or book, and reach confirmation/payment pages; administrators manage the content and event configuration. The React client has both page routing and hydration/fetch behavior, while a separate SSR service prepares page responses. The Express API routes requests through domain-aware model attachment to controllers and Sequelize models. The graph emphasizes documented routes and sampled calls; some backend feature links are grouped because their implementations were not excerpted.

Main entry points: [`server/app.js`](https://github.com/intweb2026/linqproduction2027/blob/main/server/app.js) (Express API), [`client/src/App.js`](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/App.js) (React application), [`server/routes/index.js`](https://github.com/intweb2026/linqproduction2027/blob/main/server/routes/index.js) (API routes), [`client/reactssr/controllers/ssr.controller.js`](https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/controllers/ssr.controller.js) (SSR page handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor experience"]
  node_app["React application<br/>[App.js]"]
  node_public_pages["Event pages"]
  node_page_shell["Page shell<br/>[index.js]"]
  node_booking_pages["Booking pages<br/>[index.jsx]"]
  node_theme["Theme settings<br/>[colors.js]"]
end

subgraph group_rendering["SSR and hydration"]
  node_global_state["Global state<br/>[GlobalContext.js]"]
  node_hydrate["Data hydration<br/>[useHydrateData.js]"]
  node_fetch["API fetch<br/>[useFetch.js]"]
  node_ssr_routes["SSR routes<br/>[ssr.routes.js]"]
  node_ssr_controller["SSR page handlers<br/>[ssr.controller.js]"]
  node_ssr_cache["SSR cache"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin routes<br/>[routes.js]"]
  node_admin_ui["Admin management<br/>[add.js]"]
end

subgraph group_api["API and tenancy"]
  node_api_routes["API routes<br/>[index.js]"]
  node_admin_controller["Admin controllers<br/>[sponsor.js]"]
  node_booking_controller["Booking workflows<br/>[bookingform.js]"]
  node_meta_controller["SEO metadata"]
  node_domain_middleware["Domain routing"]
  node_site_models["Site model binding"]
  node_backend["Express API<br/>[app.js]"]
end

subgraph group_data["Persistence and cache"]
  node_model_helper["Model lookup<br/>[modelHelper.js]"]
  node_models["Sequelize models<br/>[index.js]"]
  node_database[("Relational database<br/>[database.js]")]
  node_cache["API cache<br/>[cache.service.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_public_pages
node_app -->|"uses"| node_theme
node_public_pages -->|"renders in"| node_page_shell
node_booking_pages -->|"renders in"| node_page_shell
node_app -->|"provides"| node_global_state
node_global_state -->|"hydrates"| node_hydrate
node_hydrate -->|"fetches fallback"| node_fetch
node_fetch -.->|"requests data"| node_backend
node_visitor -->|"requests page"| node_ssr_routes
node_ssr_routes -->|"dispatches"| node_ssr_controller
node_ssr_controller -->|"uses cached fetch"| node_ssr_cache
node_ssr_cache -->|"reads cache"| node_cache
node_ssr_controller -->|"fetches page data"| node_backend
node_visitor -->|"opens admin"| node_admin_routes
node_admin_routes -->|"loads management"| node_admin_ui
node_backend -->|"applies"| node_domain_middleware
node_backend -->|"applies"| node_site_models
node_backend -->|"mounts"| node_api_routes
node_api_routes -->|"routes sponsor requests"| node_admin_controller
node_api_routes -.->|"routes booking requests"| node_booking_controller
node_api_routes -.->|"routes metadata requests"| node_meta_controller
node_admin_controller -.->|"looks up models"| node_model_helper
node_meta_controller -->|"looks up model"| node_model_helper
node_site_models -.->|"attaches models"| node_models
node_models -->|"uses connection"| node_database
node_backend -->|"invalidates"| node_cache

click node_app "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/App.js"
click node_public_pages "https://github.com/intweb2026/linqproduction2027/tree/main/client/src/views"
click node_page_shell "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/layout/Page/index.js"
click node_booking_pages "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/views/BookingFormV2/index.jsx"
click node_theme "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/styles/colors.js"
click node_global_state "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/GlobalContext.js"
click node_hydrate "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/hooks/useHydrateData.js"
click node_fetch "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/hooks/useFetch.js"
click node_ssr_routes "https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/routes/ssr.routes.js"
click node_ssr_controller "https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/controllers/ssr.controller.js"
click node_ssr_cache "https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/middleware/cache.middleware.js"
click node_admin_routes "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/routes.js"
click node_admin_ui "https://github.com/intweb2026/linqproduction2027/blob/main/client/src/views/Adminpanel/sponsors/allsponsors/add.js"
click node_api_routes "https://github.com/intweb2026/linqproduction2027/blob/main/server/routes/index.js"
click node_admin_controller "https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/adminpanel/sponsors/sponsor.js"
click node_booking_controller "https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/frontend/bookingform/bookingform.js"
click node_meta_controller "https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/metaTagController.js"
click node_domain_middleware "https://github.com/intweb2026/linqproduction2027/blob/main/server/middleware/domainMiddleware.js"
click node_site_models "https://github.com/intweb2026/linqproduction2027/blob/main/server/middleware/attachSiteModels.js"
click node_model_helper "https://github.com/intweb2026/linqproduction2027/blob/main/server/utils/modelHelper.js"
click node_models "https://github.com/intweb2026/linqproduction2027/blob/main/server/models/index.js"
click node_database "https://github.com/intweb2026/linqproduction2027/blob/main/server/config/database.js"
click node_cache "https://github.com/intweb2026/linqproduction2027/blob/main/server/services/cache.service.js"
click node_backend "https://github.com/intweb2026/linqproduction2027/blob/main/server/app.js"

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_page_shell,node_booking_pages,node_theme toneBlue
class node_global_state,node_hydrate,node_fetch,node_ssr_routes,node_ssr_controller,node_ssr_cache toneAmber
class node_admin_routes,node_admin_ui toneMint
class node_api_routes,node_admin_controller,node_booking_controller,node_meta_controller,node_domain_middleware,node_site_models,node_backend toneRose
class node_model_helper,node_models,node_database,node_cache,node_visitor toneIndigo
```

## Components

### Visitor experience

- [React application](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/App.js): `client/src/App.js`
- [Event pages](https://github.com/intweb2026/linqproduction2027/tree/main/client/src/views): `client/src/views`
- [Page shell](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/layout/Page/index.js): `client/src/layout/Page/index.js`
- [Booking pages](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/views/BookingFormV2/index.jsx): `client/src/views/BookingFormV2/index.jsx`
- [Theme settings](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/styles/colors.js): `client/src/styles/colors.js`

### SSR and hydration

- [Global state](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/GlobalContext.js): `client/src/GlobalContext.js`
- [Data hydration](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/hooks/useHydrateData.js): `client/src/hooks/useHydrateData.js`
- [API fetch](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/hooks/useFetch.js): `client/src/hooks/useFetch.js`
- [SSR routes](https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/routes/ssr.routes.js): `client/reactssr/routes/ssr.routes.js`
- [SSR page handlers](https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/controllers/ssr.controller.js): `client/reactssr/controllers/ssr.controller.js`
- [SSR cache](https://github.com/intweb2026/linqproduction2027/blob/main/client/reactssr/middleware/cache.middleware.js): `client/reactssr/middleware/cache.middleware.js`

### Administration

- [Admin routes](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/routes.js): `client/src/routes.js`
- [Admin management](https://github.com/intweb2026/linqproduction2027/blob/main/client/src/views/Adminpanel/sponsors/allsponsors/add.js): `client/src/views/Adminpanel/sponsors/allsponsors/add.js`

### API and tenancy

- [API routes](https://github.com/intweb2026/linqproduction2027/blob/main/server/routes/index.js): `server/routes/index.js`
- [Admin controllers](https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/adminpanel/sponsors/sponsor.js): `server/controllers/adminpanel/sponsors/sponsor.js`
- [Booking workflows](https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/frontend/bookingform/bookingform.js): `server/controllers/frontend/bookingform/bookingform.js`
- [SEO metadata](https://github.com/intweb2026/linqproduction2027/blob/main/server/controllers/metaTagController.js): `server/controllers/metaTagController.js`
- [Domain routing](https://github.com/intweb2026/linqproduction2027/blob/main/server/middleware/domainMiddleware.js): `server/middleware/domainMiddleware.js`
- [Site model binding](https://github.com/intweb2026/linqproduction2027/blob/main/server/middleware/attachSiteModels.js): `server/middleware/attachSiteModels.js`
- [Express API](https://github.com/intweb2026/linqproduction2027/blob/main/server/app.js): `server/app.js`

### Persistence and cache

- [Model lookup](https://github.com/intweb2026/linqproduction2027/blob/main/server/utils/modelHelper.js): `server/utils/modelHelper.js`
- [Sequelize models](https://github.com/intweb2026/linqproduction2027/blob/main/server/models/index.js): `server/models/index.js`
- [Relational database](https://github.com/intweb2026/linqproduction2027/blob/main/server/config/database.js): `server/config/database.js`
- [API cache](https://github.com/intweb2026/linqproduction2027/blob/main/server/services/cache.service.js): `server/services/cache.service.js`

### Other components

- **Visitor**

## Connections

- Visitor → React application: opens (evidence: `client/src/App.js`)
- React application → Event pages: routes to (evidence: `client/src/App.js`)
- React application → Theme settings: uses (evidence: `client/src/App.js`)
- Event pages → Page shell: renders in (evidence: `client/src/frontendRoutes.js`)
- Booking pages → Page shell: renders in
- React application → Global state: provides (evidence: `client/src/App.js`)
- Global state → Data hydration: hydrates (evidence: `client/src/GlobalContext.js`)
- Data hydration → API fetch: fetches fallback (evidence: `client/src/hooks/useHydrateData.js`)
- API fetch → Express API: requests data
- Visitor → SSR routes: requests page (evidence: `client/reactssr/routes/ssr.routes.js`)
- SSR routes → SSR page handlers: dispatches (evidence: `client/reactssr/routes/ssr.routes.js`)
- SSR page handlers → SSR cache: uses cached fetch (evidence: `client/reactssr/controllers/ssr.controller.js`)
- SSR cache → API cache: reads cache (evidence: `client/reactssr/middleware/cache.middleware.js`)
- SSR page handlers → Express API: fetches page data (evidence: `client/reactssr/controllers/ssr.controller.js`)
- Visitor → Admin routes: opens admin
- Admin routes → Admin management: loads management (evidence: `client/src/routes.js`)
- Express API → Domain routing: applies (evidence: `server/app.js`)
- Express API → Site model binding: applies (evidence: `server/app.js`)
- Express API → API routes: mounts (evidence: `server/app.js`)
- API routes → Admin controllers: routes sponsor requests (evidence: `server/routes/index.js`)
- API routes → Booking workflows: routes booking requests
- API routes → SEO metadata: routes metadata requests
- Admin controllers → Model lookup: looks up models
- SEO metadata → Model lookup: looks up model (evidence: `server/controllers/metaTagController.js`)
- Site model binding → Sequelize models: attaches models
- Sequelize models → Relational database: uses connection (evidence: `server/models/index.js`)
- Express API → API cache: invalidates (evidence: `server/app.js`)
