# kcpeppe/peakit architecture

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

## Overview

This repository is a Java performance-diagnostics workshop containing independent exercises, including a stock-history web application. The principal stock workflow serves a ticker request, consults session history or a configured data source, and renders prices; the data-source layer can read from a relational database or the filesystem. Other exercises cover person storage and integer/data-generation workloads. The graph follows the shown servlet and datasource calls; some stock analysis and database-history internals are represented based on the SOURCE INDEX, so uncertain links are omitted.

Main entry points: [`exercise2/src/main/java/com/kodewerk/web/StockHistory.java`](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java) (History servlet), [`exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java) (Relational source), [`exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java) (Data source API), [`exercise2/src/main/java/com/kodewerk/web/DBHistory.java`](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/DBHistory.java) (DB history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stock_web["Stock web"]
  node_stock_history["History servlet<br/>[StockHistory.java]"]
  node_history_base["Servlet base"]
  node_db_history["DB history<br/>[DBHistory.java]"]
  node_analysis["Stock analysis<br/>[Analysis.java]"]
  node_crumbs["Session history<br/>[CrumbTrail.java]"]
  node_ticker_list["Ticker selector<br/>[TickerList.java]"]
end

subgraph group_stock_data["Stock data"]
  node_datasource["Data source API"]
  node_file_source["File source"]
  node_rdb_source["Relational source"]
  node_database["Database access<br/>[DataBase.java]"]
  node_sql_store[("Stocks database")]
  node_stock_properties["Stock settings"]
  node_price_list["Price collection"]
  node_price["Closing price<br/>[ClosingPrice.java]"]
  node_data_source_error["Source errors"]
  node_cache_error["Cache errors"]
end

subgraph group_person["Person storage"]
  node_person_api["Person store API<br/>[PersonStore.java]"]
  node_person_storage[("Person storage<br/>[PersonStorage.java]")]
  node_person["Person record<br/>[Person.java]"]
end

subgraph group_profiling["Profiling exercises"]
  node_integer_harness["Integer workload"]
  node_data_generator["Data generator<br/>[GenerateData.java]"]
end

node_browser(("Web user"))

node_browser -->|"requests history"| node_stock_history
node_stock_history -->|"uses servlet"| node_history_base
node_stock_history -->|"loads prices"| node_datasource
node_stock_history -->|"checks session"| node_crumbs
node_stock_history -->|"lists tickers"| node_ticker_list
node_stock_history -->|"renders results"| node_price_list
node_datasource -.->|"implemented by"| node_file_source
node_datasource -.->|"implemented by"| node_rdb_source
node_rdb_source -->|"queries"| node_database
node_database -->|"reads and writes"| node_sql_store
node_rdb_source -->|"reads settings"| node_stock_properties
node_stock_history -->|"selects source"| node_stock_properties
node_rdb_source -->|"builds list"| node_price_list
node_rdb_source -->|"creates prices"| node_price
node_database -->|"maps query rows"| node_price
node_rdb_source -->|"wraps failures"| node_data_source_error
node_stock_history -->|"handles cache miss"| node_cache_error
node_person_storage -->|"implements"| node_person_api
node_person_storage -->|"stores records"| node_person
node_db_history -->|"uses source"| node_datasource
node_db_history -->|"uses session history"| node_crumbs
node_db_history -->|"uses tickers"| node_ticker_list
node_analysis -->|"uses source"| node_datasource
node_analysis -->|"analyzes prices"| node_price_list
node_analysis -->|"uses tickers"| node_ticker_list

click node_stock_history "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java"
click node_history_base "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/HistoryServlet.java"
click node_db_history "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/DBHistory.java"
click node_analysis "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/Analysis.java"
click node_crumbs "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/CrumbTrail.java"
click node_ticker_list "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/TickerList.java"
click node_datasource "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java"
click node_file_source "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java"
click node_rdb_source "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java"
click node_database "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/DataBase.java"
click node_stock_properties "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/StockProperties.java"
click node_price_list "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/ClosingPriceList.java"
click node_price "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/ClosingPrice.java"
click node_data_source_error "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSourceException.java"
click node_cache_error "https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/StockNotCachedException.java"
click node_person_api "https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStore.java"
click node_person_storage "https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStorage.java"
click node_person "https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/Person.java"
click node_integer_harness "https://github.com/kcpeppe/peakit/blob/main/exercise1/src/main/java/com/kodewerk/profile/CheckIntegerTestHarness.java"
click node_data_generator "https://github.com/kcpeppe/peakit/blob/main/exercise1/src/main/java/com/kodewerk/profile/GenerateData.java"

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_stock_history,node_history_base,node_db_history,node_analysis,node_crumbs,node_ticker_list,node_browser toneBlue
class node_datasource,node_file_source,node_rdb_source,node_database,node_sql_store,node_stock_properties,node_price_list,node_price,node_data_source_error,node_cache_error toneAmber
class node_person_api,node_person_storage,node_person toneMint
class node_integer_harness,node_data_generator toneRose
```

## Components

### Stock web

- [History servlet](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/StockHistory.java): `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`
- [Servlet base](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/HistoryServlet.java): `exercise2/src/main/java/com/kodewerk/web/HistoryServlet.java`
- [DB history](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/DBHistory.java): `exercise2/src/main/java/com/kodewerk/web/DBHistory.java`
- [Stock analysis](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/web/Analysis.java): `exercise2/src/main/java/com/kodewerk/web/Analysis.java`
- [Session history](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/CrumbTrail.java): `exercise2/src/main/java/com/kodewerk/stock/CrumbTrail.java`
- [Ticker selector](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/TickerList.java): `exercise2/src/main/java/com/kodewerk/stock/TickerList.java`

### Stock data

- [Data source API](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java): `exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSource.java`
- [File source](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java): `exercise2/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`
- [Relational source](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java): `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`
- [Database access](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/DataBase.java): `exercise2/src/main/java/com/kodewerk/db/DataBase.java`
- **Stocks database**
- [Stock settings](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/StockProperties.java): `exercise2/src/main/java/com/kodewerk/stock/StockProperties.java`
- [Price collection](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/ClosingPriceList.java): `exercise2/src/main/java/com/kodewerk/stock/ClosingPriceList.java`
- [Closing price](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/ClosingPrice.java): `exercise2/src/main/java/com/kodewerk/stock/ClosingPrice.java`
- [Source errors](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSourceException.java): `exercise2/src/main/java/com/kodewerk/db/ClosingPriceDataSourceException.java`
- [Cache errors](https://github.com/kcpeppe/peakit/blob/main/exercise2/src/main/java/com/kodewerk/stock/StockNotCachedException.java): `exercise2/src/main/java/com/kodewerk/stock/StockNotCachedException.java`

### Person storage

- [Person store API](https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStore.java): `cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStore.java`
- [Person storage](https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStorage.java): `cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStorage.java`
- [Person record](https://github.com/kcpeppe/peakit/blob/main/cheapdrink/src/main/java/com/kodewerk/cheapdrink/Person.java): `cheapdrink/src/main/java/com/kodewerk/cheapdrink/Person.java`

### Profiling exercises

- [Integer workload](https://github.com/kcpeppe/peakit/blob/main/exercise1/src/main/java/com/kodewerk/profile/CheckIntegerTestHarness.java): `exercise1/src/main/java/com/kodewerk/profile/CheckIntegerTestHarness.java`
- [Data generator](https://github.com/kcpeppe/peakit/blob/main/exercise1/src/main/java/com/kodewerk/profile/GenerateData.java): `exercise1/src/main/java/com/kodewerk/profile/GenerateData.java`

### Other components

- **Web user**

## Connections

- Web user → History servlet: requests history (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- History servlet → Servlet base: uses servlet (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- History servlet → Data source API: loads prices (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- History servlet → Session history: checks session (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- History servlet → Ticker selector: lists tickers (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- History servlet → Price collection: renders results (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Data source API → File source: implemented by (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceFileSystemDataSource.java`)
- Data source API → Relational source: implemented by (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- Relational source → Database access: queries (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- Database access → Stocks database: reads and writes (evidence: `exercise2/src/main/java/com/kodewerk/db/DataBase.java`)
- Relational source → Stock settings: reads settings (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- History servlet → Stock settings: selects source (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Relational source → Price collection: builds list (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- Relational source → Closing price: creates prices (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- Database access → Closing price: maps query rows (evidence: `exercise2/src/main/java/com/kodewerk/db/DataBase.java`)
- Relational source → Source errors: wraps failures (evidence: `exercise2/src/main/java/com/kodewerk/db/ClosingPriceRDBDataSource.java`)
- History servlet → Cache errors: handles cache miss (evidence: `exercise2/src/main/java/com/kodewerk/web/StockHistory.java`)
- Person storage → Person store API: implements (evidence: `cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStorage.java`)
- Person storage → Person record: stores records (evidence: `cheapdrink/src/main/java/com/kodewerk/cheapdrink/PersonStorage.java`)
- DB history → Data source API: uses source (evidence: `exercise2/src/main/java/com/kodewerk/web/DBHistory.java`)
- DB history → Session history: uses session history (evidence: `exercise2/src/main/java/com/kodewerk/web/DBHistory.java`)
- DB history → Ticker selector: uses tickers (evidence: `exercise2/src/main/java/com/kodewerk/web/DBHistory.java`)
- Stock analysis → Data source API: uses source (evidence: `exercise2/src/main/java/com/kodewerk/web/Analysis.java`)
- Stock analysis → Price collection: analyzes prices (evidence: `exercise2/src/main/java/com/kodewerk/web/Analysis.java`)
- Stock analysis → Ticker selector: uses tickers (evidence: `exercise2/src/main/java/com/kodewerk/web/Analysis.java`)
