# zeeelord/havardref architecture

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

- Interactive diagram: https://gitdiagram.com/zeeelord/havardref
- Repository: https://github.com/zeeelord/havardref

## Overview

HavardRef is a small Java library for assembling Harvard-style references from author and publication details. Its demonstrated workflow creates author objects, supplies them to a publication type, and formats the resulting citation; books, journal articles, and web pages each add their own details and formatting. The shared Publication class holds common data and formats author names. PublicationMain demonstrates printing citations. Evidence is limited to the README and sampled source; no storage or external-service integration is shown.

Main entry points: [`src/PublicationMain.java`](https://github.com/zeeelord/havardref/blob/main/src/PublicationMain.java) (Publication Demo), [`src/Publication.java`](https://github.com/zeeelord/havardref/blob/main/src/Publication.java) (Publication Base), [`src/Author.java`](https://github.com/zeeelord/havardref/blob/main/src/Author.java) (Author Contract), [`src/IndividualAuthor.java`](https://github.com/zeeelord/havardref/blob/main/src/IndividualAuthor.java) (Individual Author)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authors["Author Models"]
  node_author_contract["Author Contract<br/>[Author.java]"]
  node_individual_author["Individual Author"]
  node_institutional_author["Institutional Author"]
end

subgraph group_publications["Publication Types"]
  node_publication["Publication Base<br/>[Publication.java]"]
  node_book["Book<br/>[Book.java]"]
  node_journal_article["Journal Article"]
  node_web_page["Web Page<br/>[WebPage.java]"]
end

subgraph group_demo["Citation Demo"]
  node_publication_main["Publication Demo"]
end

node_citation_output["Printed Citations"]

node_individual_author -->|"implements"| node_author_contract
node_institutional_author -->|"implements"| node_author_contract
node_book -->|"extends"| node_publication
node_journal_article -->|"extends"| node_publication
node_web_page -->|"extends"| node_publication
node_publication -->|"formats names"| node_author_contract
node_publication_main -->|"creates"| node_individual_author
node_publication_main -->|"creates"| node_book
node_publication_main -->|"creates"| node_journal_article
node_publication_main -->|"creates"| node_web_page
node_publication_main -->|"prints"| node_citation_output

click node_author_contract "https://github.com/zeeelord/havardref/blob/main/src/Author.java"
click node_individual_author "https://github.com/zeeelord/havardref/blob/main/src/IndividualAuthor.java"
click node_institutional_author "https://github.com/zeeelord/havardref/blob/main/src/InstitutionalAuthor.java"
click node_publication "https://github.com/zeeelord/havardref/blob/main/src/Publication.java"
click node_book "https://github.com/zeeelord/havardref/blob/main/src/Book.java"
click node_journal_article "https://github.com/zeeelord/havardref/blob/main/src/JournalArticle.java"
click node_web_page "https://github.com/zeeelord/havardref/blob/main/src/WebPage.java"
click node_publication_main "https://github.com/zeeelord/havardref/blob/main/src/PublicationMain.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_author_contract,node_individual_author,node_institutional_author toneBlue
class node_publication,node_book,node_journal_article,node_web_page toneAmber
class node_publication_main toneMint
class node_citation_output toneIndigo
```

## Components

### Author Models

- [Author Contract](https://github.com/zeeelord/havardref/blob/main/src/Author.java): `src/Author.java`
- [Individual Author](https://github.com/zeeelord/havardref/blob/main/src/IndividualAuthor.java): `src/IndividualAuthor.java`
- [Institutional Author](https://github.com/zeeelord/havardref/blob/main/src/InstitutionalAuthor.java): `src/InstitutionalAuthor.java`

### Publication Types

- [Publication Base](https://github.com/zeeelord/havardref/blob/main/src/Publication.java): `src/Publication.java`
- [Book](https://github.com/zeeelord/havardref/blob/main/src/Book.java): `src/Book.java`
- [Journal Article](https://github.com/zeeelord/havardref/blob/main/src/JournalArticle.java): `src/JournalArticle.java`
- [Web Page](https://github.com/zeeelord/havardref/blob/main/src/WebPage.java): `src/WebPage.java`

### Citation Demo

- [Publication Demo](https://github.com/zeeelord/havardref/blob/main/src/PublicationMain.java): `src/PublicationMain.java`

### Other components

- **Printed Citations**

## Connections

- Individual Author → Author Contract: implements (evidence: `src/IndividualAuthor.java`)
- Institutional Author → Author Contract: implements (evidence: `src/InstitutionalAuthor.java`)
- Book → Publication Base: extends (evidence: `src/Book.java`)
- Journal Article → Publication Base: extends (evidence: `src/JournalArticle.java`)
- Web Page → Publication Base: extends (evidence: `src/WebPage.java`)
- Publication Base → Author Contract: formats names (evidence: `src/Publication.java`)
- Publication Demo → Individual Author: creates (evidence: `src/PublicationMain.java`)
- Publication Demo → Book: creates (evidence: `src/PublicationMain.java`)
- Publication Demo → Journal Article: creates (evidence: `src/PublicationMain.java`)
- Publication Demo → Web Page: creates (evidence: `src/PublicationMain.java`)
- Publication Demo → Printed Citations: prints (evidence: `src/PublicationMain.java`)
