# srishtea-22/we_capstone_project architecture

> Architecture diagram of the GitHub repository srishtea-22/we_capstone_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/srishtea-22/we_capstone_project
- Repository: https://github.com/srishtea-22/we_capstone_project

## Overview

WebhookVault lets a developer create a temporary webhook URL, send events to it, inspect captured payloads, and generate types and framework-specific handlers from the captured data. The backend assigns UUIDs, stores endpoints and payloads in Redis with 24-hour expiry, and emits Socket.IO events; the frontend provides the capture and inspection workspace. Type generation flows through schema generation, an intermediate representation, and handler generation. The README documents additional language and framework support. Some frontend event and payload wiring is omitted from the excerpts, so those links are marked unverified.

Main entry points: [`frontend/app/page.tsx`](https://github.com/srishtea-22/we_capstone_project/blob/main/frontend/app/page.tsx) (Webhook workspace), [`backend/server.js`](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js) (Payload and types API), [`backend/services/IRGenerator.js`](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/IRGenerator.js) (IR generator), [`backend/services/schemaGenerator.js`](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/schemaGenerator.js) (Schema generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and storage"]
  node_create_capture["Endpoint and capture API<br/>[server.js]"]
  node_payload_api["Payload and types API<br/>[server.js]"]
  node_realtime["Realtime dispatch<br/>[server.js]"]
end

subgraph group_generation["Code generation"]
  node_schema["Schema generator<br/>[schemaGenerator.js]"]
  node_ir["IR generator<br/>[IRGenerator.js]"]
  node_handlers["Handler generator"]
end

subgraph group_workspace["Developer workspace"]
  node_workspace_ui["Webhook workspace<br/>[page.tsx]"]
  node_json_view["JSON viewer<br/>[JsonViewer.tsx]"]
end

subgraph group_integrations["External services"]
  node_redis[("Redis store")]
  node_socket_service["Socket.IO service"]
end

node_developer(("Developer"))
node_sender(("Webhook sender"))

node_developer -->|"uses"| node_workspace_ui
node_workspace_ui -->|"creates endpoint"| node_create_capture
node_create_capture -->|"stores endpoint"| node_redis
node_sender -->|"sends webhook"| node_create_capture
node_create_capture -->|"stores payload"| node_redis
node_create_capture -->|"emits event"| node_realtime
node_realtime -->|"dispatches event"| node_socket_service
node_socket_service -.->|"updates live"| node_workspace_ui
node_workspace_ui -->|"requests types"| node_payload_api
node_payload_api -->|"reads payloads"| node_redis
node_payload_api -->|"generates types"| node_schema
node_payload_api -->|"builds IR"| node_ir
node_payload_api -->|"generates handlers"| node_handlers
node_schema -->|"schema input"| node_ir
node_ir -->|"IR input"| node_handlers
node_workspace_ui -->|"renders payload"| node_json_view
node_developer -->|"inspects and exports"| node_workspace_ui

click node_workspace_ui "https://github.com/srishtea-22/we_capstone_project/blob/main/frontend/app/page.tsx"
click node_json_view "https://github.com/srishtea-22/we_capstone_project/blob/main/frontend/app/components/JsonViewer.tsx"
click node_create_capture "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js"
click node_payload_api "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js"
click node_realtime "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js"
click node_schema "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/schemaGenerator.js"
click node_ir "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/IRGenerator.js"
click node_handlers "https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/handlerGenerator.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_create_capture,node_payload_api,node_realtime toneBlue
class node_schema,node_ir,node_handlers toneAmber
class node_workspace_ui,node_json_view,node_sender toneMint
class node_redis,node_socket_service toneRose
class node_developer toneIndigo
```

## Components

### Capture and storage

- [Endpoint and capture API](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js): `backend/server.js`
- [Payload and types API](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js): `backend/server.js`
- [Realtime dispatch](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/server.js): `backend/server.js`

### Code generation

- [Schema generator](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/schemaGenerator.js): `backend/services/schemaGenerator.js`
- [IR generator](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/IRGenerator.js): `backend/services/IRGenerator.js`
- [Handler generator](https://github.com/srishtea-22/we_capstone_project/blob/main/backend/services/handlerGenerator.js): `backend/services/handlerGenerator.js`

### Developer workspace

- [Webhook workspace](https://github.com/srishtea-22/we_capstone_project/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [JSON viewer](https://github.com/srishtea-22/we_capstone_project/blob/main/frontend/app/components/JsonViewer.tsx): `frontend/app/components/JsonViewer.tsx`

### External services

- **Redis store**
- **Socket.IO service**

### Other components

- **Developer**
- **Webhook sender**

## Connections

- Developer → Webhook workspace: uses (evidence: `README.md`)
- Webhook workspace → Endpoint and capture API: creates endpoint (evidence: `frontend/app/page.tsx`)
- Endpoint and capture API → Redis store: stores endpoint (evidence: `backend/server.js`)
- Webhook sender → Endpoint and capture API: sends webhook (evidence: `backend/server.js`)
- Endpoint and capture API → Redis store: stores payload (evidence: `backend/server.js`)
- Endpoint and capture API → Realtime dispatch: emits event (evidence: `backend/server.js`)
- Realtime dispatch → Socket.IO service: dispatches event (evidence: `backend/server.js`)
- Socket.IO service → Webhook workspace: updates live
- Webhook workspace → Payload and types API: requests types (evidence: `frontend/app/page.tsx`)
- Payload and types API → Redis store: reads payloads (evidence: `backend/server.js`)
- Payload and types API → Schema generator: generates types (evidence: `backend/server.js`)
- Payload and types API → IR generator: builds IR (evidence: `backend/server.js`)
- Payload and types API → Handler generator: generates handlers (evidence: `backend/server.js`)
- Schema generator → IR generator: schema input (evidence: `backend/server.js`)
- IR generator → Handler generator: IR input (evidence: `backend/server.js`)
- Webhook workspace → JSON viewer: renders payload (evidence: `frontend/app/page.tsx`)
- Developer → Webhook workspace: inspects and exports (evidence: `README.md`)
