# 14ritin/presight-execise architecture

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

- Interactive diagram: https://gitdiagram.com/14ritin/presight-execise
- Repository: https://github.com/14ritin/presight-execise

## Overview

Presight is a full-stack user directory intended for searching, filtering, sorting, and browsing paginated people. The principal flow runs from URL-restored client controls through the API to SQLite-backed results, then updates a virtualized list and filter facets. The README documents these responsibilities and behaviors, but the supplied tree contains no implementation files; directory paths identify unsampled subsystems, and the graph reflects documented design rather than verified calls.

Main entry points: [`server`](https://github.com/14ritin/presight-execise/tree/main/server) (Directory API), [`client`](https://github.com/14ritin/presight-execise/tree/main/client) (URL view state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Directory client"]
  node_view_state["URL view state"]
  node_search_filters["Search and filters"]
  node_sort_controls["Sort controls"]
  node_user_list["Virtualized list"]
  node_user_cards["User cards"]
  node_facet_sidebar["Facet sidebar"]
end

subgraph group_api["Directory API"]
  node_api["Directory API"]
  node_result_query["Result query"]
  node_facet_counts["Facet counts"]
end

subgraph group_data["User data"]
  node_user_store[("User database")]
end

node_visitor(("Visitor"))

node_visitor -->|"searches and filters"| node_search_filters
node_visitor -->|"chooses sort"| node_sort_controls
node_view_state -->|"restores filters"| node_search_filters
node_view_state -->|"restores sort"| node_sort_controls
node_search_filters -->|"requests results and facets"| node_api
node_sort_controls -->|"requests sorted results"| node_api
node_api -->|"dispatches query"| node_result_query
node_api -->|"computes top values"| node_facet_counts
node_result_query -->|"reads users"| node_user_store
node_facet_counts -->|"reads filtered users"| node_user_store
node_api -->|"returns paginated users"| node_user_list
node_api -->|"returns facet counts"| node_facet_sidebar
node_user_list -->|"renders users"| node_user_cards
node_visitor -->|"shares or reloads URL"| node_view_state

click node_view_state "https://github.com/14ritin/presight-execise/tree/main/client"
click node_search_filters "https://github.com/14ritin/presight-execise/tree/main/client"
click node_sort_controls "https://github.com/14ritin/presight-execise/tree/main/client"
click node_user_list "https://github.com/14ritin/presight-execise/tree/main/client"
click node_user_cards "https://github.com/14ritin/presight-execise/tree/main/client"
click node_facet_sidebar "https://github.com/14ritin/presight-execise/tree/main/client"
click node_api "https://github.com/14ritin/presight-execise/tree/main/server"
click node_result_query "https://github.com/14ritin/presight-execise/tree/main/server"
click node_facet_counts "https://github.com/14ritin/presight-execise/tree/main/server"

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_view_state,node_search_filters,node_sort_controls,node_user_list,node_user_cards,node_facet_sidebar toneBlue
class node_api,node_result_query,node_facet_counts toneAmber
class node_user_store toneMint
class node_visitor toneIndigo
```

## Components

### Directory client

- [URL view state](https://github.com/14ritin/presight-execise/tree/main/client): `client`
- [Search and filters](https://github.com/14ritin/presight-execise/tree/main/client): `client`
- [Sort controls](https://github.com/14ritin/presight-execise/tree/main/client): `client`
- [Virtualized list](https://github.com/14ritin/presight-execise/tree/main/client): `client`
- [User cards](https://github.com/14ritin/presight-execise/tree/main/client): `client`
- [Facet sidebar](https://github.com/14ritin/presight-execise/tree/main/client): `client`

### Directory API

- [Directory API](https://github.com/14ritin/presight-execise/tree/main/server): `server`
- [Result query](https://github.com/14ritin/presight-execise/tree/main/server): `server`
- [Facet counts](https://github.com/14ritin/presight-execise/tree/main/server): `server`

### User data

- **User database**

### Other components

- **Visitor**

## Connections

- Visitor → Search and filters: searches and filters (evidence: `README.md`)
- Visitor → Sort controls: chooses sort (evidence: `README.md`)
- URL view state → Search and filters: restores filters (evidence: `README.md`)
- URL view state → Sort controls: restores sort (evidence: `README.md`)
- Search and filters → Directory API: requests results and facets (evidence: `README.md`)
- Sort controls → Directory API: requests sorted results (evidence: `README.md`)
- Directory API → Result query: dispatches query (evidence: `README.md`)
- Directory API → Facet counts: computes top values (evidence: `README.md`)
- Result query → User database: reads users (evidence: `README.md`)
- Facet counts → User database: reads filtered users (evidence: `README.md`)
- Directory API → Virtualized list: returns paginated users (evidence: `README.md`)
- Directory API → Facet sidebar: returns facet counts (evidence: `README.md`)
- Virtualized list → User cards: renders users (evidence: `README.md`)
- Visitor → URL view state: shares or reloads URL (evidence: `README.md`)
