# pulengtshaba/sentence-builder architecture

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

- Interactive diagram: https://gitdiagram.com/pulengtshaba/sentence-builder
- Repository: https://github.com/pulengtshaba/sentence-builder

## Overview

Sentence Builder is a full-stack app for choosing grammatical word types, assembling words into an in-progress sentence, and saving, viewing, or editing ordered sentences. The Angular builder and saved-sentence views use an API service to reach the Express API; backend controllers delegate to domain services and repositories for word lookup and sentence persistence. The README documents ordered sentence-word storage and the major user capabilities. Database details differ between README and the sampled adapter configuration, so the graph labels the external store generically.

Main entry points: [`server/src/app.js`](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/app.js) (API app and routing), [`client/src/app/services/sentence-api.service.ts`](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/services/sentence-api.service.ts) (Sentence API client), [`server/src/config/database.js`](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/config/database.js) (Prisma database client), [`client/src/app/app.routes.ts`](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/app.routes.ts) (App shell and routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["App shell and routes<br/>[app.routes.ts]"]
  node_builder["Sentence builder"]
  node_saved["Saved sentences"]
  node_clientmodels["Client data models"]
  node_api_client["Sentence API client"]
end

subgraph group_api["Express API"]
  node_express["API app and routing<br/>[app.js]"]
  node_sentence_routes["Sentence routes<br/>[sentenceRoutes.js]"]
  node_word_routes["Word routes<br/>[wordRoutes.js]"]
  node_type_routes["Word-type routes<br/>[wordTypeRoutes.js]"]
  node_sentence_controller["Sentence controller"]
  node_word_controller["Word controller<br/>[wordController.js]"]
  node_type_controller["Word-type controller"]
end

subgraph group_domain["Sentence and word logic"]
  node_sentence_service["Sentence service<br/>[sentenceService.js]"]
  node_word_service["Word service<br/>[wordService.js]"]
  node_type_service["Word-type service<br/>[wordTypeService.js]"]
end

subgraph group_persistence["Persistence"]
  node_sentence_repo["Sentence repository"]
  node_word_repo["Word repository<br/>[wordRepository.js]"]
  node_type_repo["Word-type repository"]
  node_db_client["Prisma database client<br/>[database.js]"]
end

node_user(("Sentence builder user"))
node_database[("Relational database")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_builder
node_app -->|"routes to"| node_saved
node_builder -->|"requests data"| node_api_client
node_saved -->|"requests sentences"| node_api_client
node_api_client -->|"uses types"| node_clientmodels
node_api_client -->|"calls REST API"| node_express
node_express -->|"mounts"| node_sentence_routes
node_express -->|"mounts"| node_word_routes
node_express -->|"mounts"| node_type_routes
node_sentence_routes -->|"dispatches"| node_sentence_controller
node_word_routes -->|"dispatches"| node_word_controller
node_type_routes -->|"dispatches"| node_type_controller
node_sentence_controller -->|"delegates to"| node_sentence_service
node_word_controller -->|"delegates to"| node_word_service
node_type_controller -->|"delegates to"| node_type_service
node_sentence_service -->|"reads and writes"| node_sentence_repo
node_sentence_service -->|"validates words"| node_word_repo
node_word_service -->|"looks up words"| node_word_repo
node_type_service -->|"looks up types"| node_type_repo
node_sentence_repo -->|"queries"| node_db_client
node_word_repo -->|"queries"| node_db_client
node_type_repo -->|"queries"| node_db_client
node_db_client -->|"persists records"| node_database

click node_app "https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/app.routes.ts"
click node_builder "https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/features/sentence-builder/sentence-builder.component.ts"
click node_saved "https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/features/saved-sentences/saved-sentences.component.ts"
click node_clientmodels "https://github.com/pulengtshaba/sentence-builder/tree/main/client/src/app/models"
click node_api_client "https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/services/sentence-api.service.ts"
click node_express "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/app.js"
click node_sentence_routes "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/sentenceRoutes.js"
click node_word_routes "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/wordRoutes.js"
click node_type_routes "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/wordTypeRoutes.js"
click node_sentence_controller "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/sentenceController.js"
click node_word_controller "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/wordController.js"
click node_type_controller "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/wordTypeController.js"
click node_sentence_service "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/sentenceService.js"
click node_word_service "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/wordService.js"
click node_type_service "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/wordTypeService.js"
click node_sentence_repo "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/sentenceRepository.js"
click node_word_repo "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/wordRepository.js"
click node_type_repo "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/wordTypeRepository.js"
click node_db_client "https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/config/database.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_builder,node_saved,node_clientmodels,node_api_client,node_user toneBlue
class node_express,node_sentence_routes,node_word_routes,node_type_routes,node_sentence_controller,node_word_controller,node_type_controller,node_database toneAmber
class node_sentence_service,node_word_service,node_type_service toneMint
class node_sentence_repo,node_word_repo,node_type_repo,node_db_client toneRose
```

## Components

### Angular client

- [App shell and routes](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/app.routes.ts): `client/src/app/app.routes.ts`
- [Sentence builder](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/features/sentence-builder/sentence-builder.component.ts): `client/src/app/features/sentence-builder/sentence-builder.component.ts`
- [Saved sentences](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/features/saved-sentences/saved-sentences.component.ts): `client/src/app/features/saved-sentences/saved-sentences.component.ts`
- [Client data models](https://github.com/pulengtshaba/sentence-builder/tree/main/client/src/app/models): `client/src/app/models`
- [Sentence API client](https://github.com/pulengtshaba/sentence-builder/blob/main/client/src/app/services/sentence-api.service.ts): `client/src/app/services/sentence-api.service.ts`

### Express API

- [API app and routing](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/app.js): `server/src/app.js`
- [Sentence routes](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/sentenceRoutes.js): `server/src/routes/sentenceRoutes.js`
- [Word routes](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/wordRoutes.js): `server/src/routes/wordRoutes.js`
- [Word-type routes](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/routes/wordTypeRoutes.js): `server/src/routes/wordTypeRoutes.js`
- [Sentence controller](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/sentenceController.js): `server/src/controllers/sentenceController.js`
- [Word controller](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/wordController.js): `server/src/controllers/wordController.js`
- [Word-type controller](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/controllers/wordTypeController.js): `server/src/controllers/wordTypeController.js`

### Sentence and word logic

- [Sentence service](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/sentenceService.js): `server/src/services/sentenceService.js`
- [Word service](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/wordService.js): `server/src/services/wordService.js`
- [Word-type service](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/services/wordTypeService.js): `server/src/services/wordTypeService.js`

### Persistence

- [Sentence repository](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/sentenceRepository.js): `server/src/repositories/sentenceRepository.js`
- [Word repository](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/wordRepository.js): `server/src/repositories/wordRepository.js`
- [Word-type repository](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/repositories/wordTypeRepository.js): `server/src/repositories/wordTypeRepository.js`
- [Prisma database client](https://github.com/pulengtshaba/sentence-builder/blob/main/server/src/config/database.js): `server/src/config/database.js`

### Other components

- **Sentence builder user**
- **Relational database**

## Connections

- Sentence builder user → App shell and routes: uses (evidence: `README.md`)
- App shell and routes → Sentence builder: routes to (evidence: `client/src/app/app.routes.ts`)
- App shell and routes → Saved sentences: routes to (evidence: `client/src/app/app.routes.ts`)
- Sentence builder → Sentence API client: requests data (evidence: `client/src/app/features/sentence-builder/sentence-builder.component.ts`)
- Saved sentences → Sentence API client: requests sentences (evidence: `client/src/app/features/saved-sentences/saved-sentences.component.ts`)
- Sentence API client → Client data models: uses types (evidence: `client/src/app/services/sentence-api.service.ts`)
- Sentence API client → API app and routing: calls REST API (evidence: `README.md`)
- API app and routing → Sentence routes: mounts (evidence: `server/src/app.js`)
- API app and routing → Word routes: mounts (evidence: `server/src/app.js`)
- API app and routing → Word-type routes: mounts (evidence: `server/src/app.js`)
- Sentence routes → Sentence controller: dispatches (evidence: `server/src/routes/sentenceRoutes.js`)
- Word routes → Word controller: dispatches (evidence: `server/src/routes/wordRoutes.js`)
- Word-type routes → Word-type controller: dispatches (evidence: `server/src/routes/wordTypeRoutes.js`)
- Sentence controller → Sentence service: delegates to (evidence: `server/src/controllers/sentenceController.js`)
- Word controller → Word service: delegates to (evidence: `server/src/controllers/wordController.js`)
- Word-type controller → Word-type service: delegates to (evidence: `server/src/controllers/wordTypeController.js`)
- Sentence service → Sentence repository: reads and writes (evidence: `server/src/services/sentenceService.js`)
- Sentence service → Word repository: validates words (evidence: `server/src/services/sentenceService.js`)
- Word service → Word repository: looks up words (evidence: `server/src/services/wordService.js`)
- Word-type service → Word-type repository: looks up types (evidence: `server/src/services/wordTypeService.js`)
- Sentence repository → Prisma database client: queries (evidence: `server/src/repositories/sentenceRepository.js`)
- Word repository → Prisma database client: queries (evidence: `server/src/repositories/wordRepository.js`)
- Word-type repository → Prisma database client: queries (evidence: `server/src/repositories/wordTypeRepository.js`)
- Prisma database client → Relational database: persists records (evidence: `server/src/config/database.js`)
