# v-par23/sprint-board-api architecture

> Architecture diagram of the GitHub repository v-par23/sprint-board-api, 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/v-par23/sprint-board-api
- Repository: https://github.com/v-par23/sprint-board-api

## Overview

Sprint Board is a lightweight HTTP API for managing projects, sprints, and issues, with in-memory persistence. An API client requests issue operations or a sprint summary; the server passes requests to the app, which matches routes and dispatches to issue or reporting services. Issue operations validate fields and workflow transitions before writing to the store; sprint reporting reads sprint and issue data to calculate progress by story points. The README documents board and report consumers; runtime links below are based on the sampled source and README.

Main entry points: [`src/app.js`](https://github.com/v-par23/sprint-board-api/blob/main/src/app.js) (Request Handler), [`src/services/issueService.js`](https://github.com/v-par23/sprint-board-api/blob/main/src/services/issueService.js) (Issue Service), [`src/server.js`](https://github.com/v-par23/sprint-board-api/blob/main/src/server.js) (HTTP Server), [`src/services/sprintService.js`](https://github.com/v-par23/sprint-board-api/blob/main/src/services/sprintService.js) (Sprint Reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_server["HTTP Server<br/>[server.js]"]
  node_app["Request Handler<br/>[app.js]"]
  node_router["Path Router<br/>[router.js]"]
  node_errors["API Errors<br/>[errors.js]"]
end

subgraph group_domain["Issue Workflow"]
  node_issue_service["Issue Service<br/>[issueService.js]"]
  node_workflow["Workflow Rules<br/>[workflows.js]"]
  node_constants["Issue Constants<br/>[constants.js]"]
end

subgraph group_reporting["Sprint Reporting"]
  node_sprint_service["Sprint Reports<br/>[sprintService.js]"]
end

subgraph group_data["Runtime Data"]
  node_store[("Memory Store<br/>[memoryStore.js]")]
  node_seed["Demo Dataset<br/>[seed.js]"]
end

node_client(("API Client"))

node_client -->|"sends HTTP"| node_server
node_server -->|"handles requests"| node_app
node_server -->|"creates store"| node_store
node_server -->|"loads demo data"| node_seed
node_app -->|"matches routes"| node_router
node_app -->|"dispatches issue calls"| node_issue_service
node_app -->|"dispatches report calls"| node_sprint_service
node_app -->|"formats errors"| node_errors
node_issue_service -->|"reads and writes"| node_store
node_issue_service -->|"checks transitions"| node_workflow
node_issue_service -->|"validates types"| node_constants
node_issue_service -->|"throws validation errors"| node_errors
node_sprint_service -->|"reads sprint data"| node_store
node_sprint_service -->|"throws not-found errors"| node_errors

click node_server "https://github.com/v-par23/sprint-board-api/blob/main/src/server.js"
click node_app "https://github.com/v-par23/sprint-board-api/blob/main/src/app.js"
click node_router "https://github.com/v-par23/sprint-board-api/blob/main/src/router.js"
click node_issue_service "https://github.com/v-par23/sprint-board-api/blob/main/src/services/issueService.js"
click node_workflow "https://github.com/v-par23/sprint-board-api/blob/main/src/workflows.js"
click node_constants "https://github.com/v-par23/sprint-board-api/blob/main/src/constants.js"
click node_errors "https://github.com/v-par23/sprint-board-api/blob/main/src/errors.js"
click node_sprint_service "https://github.com/v-par23/sprint-board-api/blob/main/src/services/sprintService.js"
click node_store "https://github.com/v-par23/sprint-board-api/blob/main/src/store/memoryStore.js"
click node_seed "https://github.com/v-par23/sprint-board-api/blob/main/src/data/seed.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_server,node_app,node_router,node_errors,node_client toneBlue
class node_issue_service,node_workflow,node_constants toneAmber
class node_sprint_service toneMint
class node_store,node_seed toneRose
```

## Components

### HTTP API

- [HTTP Server](https://github.com/v-par23/sprint-board-api/blob/main/src/server.js): `src/server.js`
- [Request Handler](https://github.com/v-par23/sprint-board-api/blob/main/src/app.js): `src/app.js`
- [Path Router](https://github.com/v-par23/sprint-board-api/blob/main/src/router.js): `src/router.js`
- [API Errors](https://github.com/v-par23/sprint-board-api/blob/main/src/errors.js): `src/errors.js`

### Issue Workflow

- [Issue Service](https://github.com/v-par23/sprint-board-api/blob/main/src/services/issueService.js): `src/services/issueService.js`
- [Workflow Rules](https://github.com/v-par23/sprint-board-api/blob/main/src/workflows.js): `src/workflows.js`
- [Issue Constants](https://github.com/v-par23/sprint-board-api/blob/main/src/constants.js): `src/constants.js`

### Sprint Reporting

- [Sprint Reports](https://github.com/v-par23/sprint-board-api/blob/main/src/services/sprintService.js): `src/services/sprintService.js`

### Runtime Data

- [Memory Store](https://github.com/v-par23/sprint-board-api/blob/main/src/store/memoryStore.js): `src/store/memoryStore.js`
- [Demo Dataset](https://github.com/v-par23/sprint-board-api/blob/main/src/data/seed.js): `src/data/seed.js`

### Other components

- **API Client**

## Connections

- API Client → HTTP Server: sends HTTP (evidence: `README.md`)
- HTTP Server → Request Handler: handles requests (evidence: `src/server.js`)
- HTTP Server → Memory Store: creates store (evidence: `src/server.js`)
- HTTP Server → Demo Dataset: loads demo data (evidence: `src/server.js`)
- Request Handler → Path Router: matches routes (evidence: `src/app.js`)
- Request Handler → Issue Service: dispatches issue calls (evidence: `src/app.js`)
- Request Handler → Sprint Reports: dispatches report calls (evidence: `src/app.js`)
- Request Handler → API Errors: formats errors (evidence: `src/app.js`)
- Issue Service → Memory Store: reads and writes (evidence: `src/services/issueService.js`)
- Issue Service → Workflow Rules: checks transitions (evidence: `src/services/issueService.js`)
- Issue Service → Issue Constants: validates types (evidence: `src/services/issueService.js`)
- Issue Service → API Errors: throws validation errors (evidence: `src/services/issueService.js`)
- Sprint Reports → Memory Store: reads sprint data (evidence: `src/services/sprintService.js`)
- Sprint Reports → API Errors: throws not-found errors (evidence: `src/services/sprintService.js`)
