# savshatrov/project architecture

> Architecture diagram of the GitHub repository savshatrov/project, 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/savshatrov/project
- Repository: https://github.com/savshatrov/project

## Overview

This is a full-stack React/Express application with shared resolver code. The principal documented runtime path is browser routes rendering registered widgets, while API requests enter the Express route set; resolver requests are validated, dispatched by name, and executed through shared resolver registrations. The tree also shows user-list/detail widgets, device and health endpoints, and auth/static routes. Several of those implementations were not excerpted, so their internal calls are not asserted here; the graph includes only relationships visible in excerpts, the source index, or README.

Main entry points: [`server/src/routes/index.ts`](https://github.com/savshatrov/project/blob/master/server/src/routes/index.ts) (Route mounting), [`server/src/index.ts`](https://github.com/savshatrov/project/blob/master/server/src/index.ts) (Express app), [`server/src/routes/resolver/index.ts`](https://github.com/savshatrov/project/blob/master/server/src/routes/resolver/index.ts) (Resolver endpoints), [`shared/src/resolver/createResolver.client.ts`](https://github.com/savshatrov/project/blob/master/shared/src/resolver/createResolver.client.ts) (Client resolver proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_entry["React entry<br/>[index.tsx]"]
  node_app_routes["Route rendering<br/>[App.tsx]"]
  node_widget_runtime["Widget runtime<br/>[WidgetShell.tsx]"]
  node_widget_context["Widget context<br/>[context.tsx]"]
end

subgraph group_server["Server API"]
  node_express_app["Express app<br/>[index.ts]"]
  node_api_routes["Route mounting<br/>[index.ts]"]
  node_resolver_route["Resolver endpoints<br/>[index.ts]"]
  node_validation["Request validation<br/>[validate.ts]"]
  node_api_docs["OpenAPI specification<br/>[swagger.ts]"]
end

subgraph group_shared["Shared Runtime"]
  node_resolver_registry["Resolver runtime"]
  node_resolver_factory["Client resolver proxy"]
  node_resolver_batch["Resolver batching"]
  node_resolver_normalize["Result normalization<br/>[normalize.ts]"]
end

subgraph group_domain["Product Features"]
  node_user_list["User list widget"]
  node_user_detail["User detail widget"]
  node_not_found["Not found widget"]
  node_user_routes["User endpoints"]
  node_auth_routes["Auth endpoints"]
  node_device_health["Device and health"]
  node_static_routes["Static delivery"]
  node_resolve_users["Resolve users<br/>[index.client.ts]"]
end

node_browser(("Browser user"))
node_api_client(("API consumer"))

node_browser -->|"opens app"| node_client_entry
node_client_entry -->|"renders"| node_app_routes
node_app_routes -->|"renders slots"| node_widget_runtime
node_widget_runtime -->|"uses context"| node_widget_context
node_api_client -->|"requests API"| node_express_app
node_express_app -->|"mounts routes"| node_api_routes
node_express_app -->|"serves docs"| node_api_docs
node_api_routes -->|"mounts"| node_resolver_route
node_api_routes -->|"mounts"| node_user_routes
node_api_routes -->|"mounts"| node_auth_routes
node_api_routes -->|"mounts"| node_device_health
node_api_routes -->|"mounts"| node_static_routes
node_resolver_route -->|"validates input"| node_validation
node_resolver_route -->|"dispatches resolver"| node_resolver_registry
node_resolve_users -->|"creates proxy"| node_resolver_factory
node_resolver_factory -->|"enqueues call"| node_resolver_batch
node_resolver_factory -->|"uses collections"| node_resolver_normalize

click node_client_entry "https://github.com/savshatrov/project/blob/master/client/src/index.tsx"
click node_app_routes "https://github.com/savshatrov/project/blob/master/client/src/App.tsx"
click node_widget_runtime "https://github.com/savshatrov/project/blob/master/client/src/utils/global/widget/WidgetShell.tsx"
click node_widget_context "https://github.com/savshatrov/project/blob/master/client/src/utils/global/widget/context.tsx"
click node_user_list "https://github.com/savshatrov/project/tree/master/client/src/widget/UserList"
click node_user_detail "https://github.com/savshatrov/project/tree/master/client/src/widget/UserDetail"
click node_not_found "https://github.com/savshatrov/project/tree/master/client/src/widget/NotFound"
click node_express_app "https://github.com/savshatrov/project/blob/master/server/src/index.ts"
click node_api_routes "https://github.com/savshatrov/project/blob/master/server/src/routes/index.ts"
click node_resolver_route "https://github.com/savshatrov/project/blob/master/server/src/routes/resolver/index.ts"
click node_validation "https://github.com/savshatrov/project/blob/master/server/src/middleware/validate.ts"
click node_user_routes "https://github.com/savshatrov/project/tree/master/server/src/routes/users"
click node_auth_routes "https://github.com/savshatrov/project/tree/master/server/src/routes/auth"
click node_device_health "https://github.com/savshatrov/project/tree/master/server/src/routes"
click node_static_routes "https://github.com/savshatrov/project/tree/master/server/src/routes/static"
click node_api_docs "https://github.com/savshatrov/project/blob/master/server/src/swagger.ts"
click node_resolver_registry "https://github.com/savshatrov/project/tree/master/shared/src/resolver"
click node_resolver_factory "https://github.com/savshatrov/project/blob/master/shared/src/resolver/createResolver.client.ts"
click node_resolver_batch "https://github.com/savshatrov/project/blob/master/shared/src/resolver/resolverBatch.client.ts"
click node_resolve_users "https://github.com/savshatrov/project/blob/master/shared/src/resolver/resolveUsers/index.client.ts"
click node_resolver_normalize "https://github.com/savshatrov/project/blob/master/shared/src/resolver/normalize.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_client_entry,node_app_routes,node_widget_runtime,node_widget_context,node_browser toneBlue
class node_express_app,node_api_routes,node_resolver_route,node_validation,node_api_docs toneAmber
class node_resolver_registry,node_resolver_factory,node_resolver_batch,node_resolver_normalize,node_api_client toneMint
class node_user_list,node_user_detail,node_not_found,node_user_routes,node_auth_routes,node_device_health,node_static_routes,node_resolve_users toneRose
```

## Components

### Client

- [React entry](https://github.com/savshatrov/project/blob/master/client/src/index.tsx): `client/src/index.tsx`
- [Route rendering](https://github.com/savshatrov/project/blob/master/client/src/App.tsx): `client/src/App.tsx`
- [Widget runtime](https://github.com/savshatrov/project/blob/master/client/src/utils/global/widget/WidgetShell.tsx): `client/src/utils/global/widget/WidgetShell.tsx`
- [Widget context](https://github.com/savshatrov/project/blob/master/client/src/utils/global/widget/context.tsx): `client/src/utils/global/widget/context.tsx`

### Server API

- [Express app](https://github.com/savshatrov/project/blob/master/server/src/index.ts): `server/src/index.ts`
- [Route mounting](https://github.com/savshatrov/project/blob/master/server/src/routes/index.ts): `server/src/routes/index.ts`
- [Resolver endpoints](https://github.com/savshatrov/project/blob/master/server/src/routes/resolver/index.ts): `server/src/routes/resolver/index.ts`
- [Request validation](https://github.com/savshatrov/project/blob/master/server/src/middleware/validate.ts): `server/src/middleware/validate.ts`
- [OpenAPI specification](https://github.com/savshatrov/project/blob/master/server/src/swagger.ts): `server/src/swagger.ts`

### Shared Runtime

- [Resolver runtime](https://github.com/savshatrov/project/tree/master/shared/src/resolver): `shared/src/resolver`
- [Client resolver proxy](https://github.com/savshatrov/project/blob/master/shared/src/resolver/createResolver.client.ts): `shared/src/resolver/createResolver.client.ts`
- [Resolver batching](https://github.com/savshatrov/project/blob/master/shared/src/resolver/resolverBatch.client.ts): `shared/src/resolver/resolverBatch.client.ts`
- [Result normalization](https://github.com/savshatrov/project/blob/master/shared/src/resolver/normalize.ts): `shared/src/resolver/normalize.ts`

### Product Features

- [User list widget](https://github.com/savshatrov/project/tree/master/client/src/widget/UserList): `client/src/widget/UserList`
- [User detail widget](https://github.com/savshatrov/project/tree/master/client/src/widget/UserDetail): `client/src/widget/UserDetail`
- [Not found widget](https://github.com/savshatrov/project/tree/master/client/src/widget/NotFound): `client/src/widget/NotFound`
- [User endpoints](https://github.com/savshatrov/project/tree/master/server/src/routes/users): `server/src/routes/users`
- [Auth endpoints](https://github.com/savshatrov/project/tree/master/server/src/routes/auth): `server/src/routes/auth`
- [Device and health](https://github.com/savshatrov/project/tree/master/server/src/routes): `server/src/routes`
- [Static delivery](https://github.com/savshatrov/project/tree/master/server/src/routes/static): `server/src/routes/static`
- [Resolve users](https://github.com/savshatrov/project/blob/master/shared/src/resolver/resolveUsers/index.client.ts): `shared/src/resolver/resolveUsers/index.client.ts`

### Other components

- **Browser user**
- **API consumer**

## Connections

- Browser user → React entry: opens app (evidence: `README.md`)
- React entry → Route rendering: renders (evidence: `client/src/index.tsx`)
- Route rendering → Widget runtime: renders slots (evidence: `client/src/App.tsx`)
- Widget runtime → Widget context: uses context (evidence: `client/src/utils/global/widget/WidgetShell.tsx`)
- API consumer → Express app: requests API (evidence: `README.md`)
- Express app → Route mounting: mounts routes (evidence: `server/src/index.ts`)
- Express app → OpenAPI specification: serves docs (evidence: `server/src/index.ts`)
- Route mounting → Resolver endpoints: mounts (evidence: `server/src/routes/index.ts`)
- Route mounting → User endpoints: mounts (evidence: `server/src/routes/index.ts`)
- Route mounting → Auth endpoints: mounts (evidence: `server/src/routes/index.ts`)
- Route mounting → Device and health: mounts (evidence: `server/src/routes/index.ts`)
- Route mounting → Static delivery: mounts (evidence: `server/src/routes/index.ts`)
- Resolver endpoints → Request validation: validates input (evidence: `server/src/routes/resolver/index.ts`)
- Resolver endpoints → Resolver runtime: dispatches resolver (evidence: `server/src/routes/resolver/index.ts`)
- Resolve users → Client resolver proxy: creates proxy (evidence: `shared/src/resolver/resolveUsers/index.client.ts`)
- Client resolver proxy → Resolver batching: enqueues call (evidence: `shared/src/resolver/createResolver.client.ts`)
- Client resolver proxy → Result normalization: uses collections (evidence: `shared/src/resolver/createResolver.client.ts`)
