# jomarbunquin/minsu_library_tracker architecture

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

## Overview

This is a browser-based library tracker for a librarian. After signing in, the librarian manages books, borrowers, and borrowing records; the dashboard summarizes availability, overdue items, and popular books. App owns the records and CRUD rules, loads initial JSON data, and persists changes in browser storage. Table components provide search, sorting, and pagination. The README is empty; the graph reflects the supplied source excerpts and index, so details of unsampled components and JSON loading are limited.

Main entry points: [`src/App.jsx`](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/App.jsx) (App coordinator), [`src/components/BorrowTable.jsx`](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BorrowTable.jsx) (Borrowing history), [`src/components/BookTable.jsx`](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BookTable.jsx) (Book catalog), [`src/components/MemberTable.jsx`](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/MemberTable.jsx) (Borrower list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["App coordinator<br/>[App.jsx]"]
  node_login["Sign-in<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_browserstore[("Browser storage<br/>[App.jsx]")]
  node_entry["React entry point<br/>[main.jsx]"]
end

subgraph group_catalog["Library records"]
  node_books["Book records<br/>[BookForm.jsx]"]
  node_booklist["Book catalog<br/>[BookTable.jsx]"]
  node_members["Borrower records<br/>[MemberForm.jsx]"]
  node_memberlist["Borrower list<br/>[MemberTable.jsx]"]
  node_bookseed["Book seed data<br/>[books.json]"]
  node_memberseed["Borrower seed data<br/>[members.json]"]
end

subgraph group_circulation["Borrowing"]
  node_borrowform["Borrowing form<br/>[BorrowForm.jsx]"]
  node_borrowlist["Borrowing history<br/>[BorrowTable.jsx]"]
  node_borrowseed["Borrowing seed data<br/>[borrowings.json]"]
end

subgraph group_shared["Shared UI"]
  node_toast["Notifications<br/>[Toast.jsx]"]
  node_tableparts["Table controls<br/>[TableParts.jsx]"]
  node_sortpage["Sort and paginate<br/>[hooks.js]"]
  node_utils["Domain utilities<br/>[utils.js]"]
end

node_librarian(("Librarian"))

node_librarian -->|"signs in"| node_login
node_entry -->|"renders"| node_app
node_app -->|"gates access"| node_login
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_books
node_app -->|"renders"| node_booklist
node_booklist -->|"invokes actions"| node_app
node_app -->|"renders"| node_members
node_app -->|"renders"| node_memberlist
node_memberlist -->|"invokes actions"| node_app
node_app -->|"renders"| node_borrowform
node_borrowform -->|"submits records"| node_app
node_app -->|"renders"| node_borrowlist
node_borrowlist -->|"invokes actions"| node_app
node_app -->|"renders"| node_toast
node_app -->|"loads and saves"| node_browserstore
node_app -.->|"loads seed data"| node_bookseed
node_app -.->|"loads seed data"| node_memberseed
node_app -.->|"loads seed data"| node_borrowseed
node_booklist -->|"sorts pages"| node_sortpage
node_borrowlist -->|"sorts pages"| node_sortpage
node_memberlist -->|"sorts pages"| node_sortpage
node_booklist -->|"renders controls"| node_tableparts
node_borrowlist -->|"renders controls"| node_tableparts
node_memberlist -->|"renders controls"| node_tableparts
node_dashboard -->|"checks overdue"| node_utils
node_borrowlist -->|"checks overdue"| node_utils
node_borrowform -->|"sets dates"| node_utils
node_app -->|"validates records"| node_utils

click node_app "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/App.jsx"
click node_login "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Login.jsx"
click node_dashboard "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Dashboard.jsx"
click node_toast "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Toast.jsx"
click node_books "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BookForm.jsx"
click node_booklist "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BookTable.jsx"
click node_members "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/MemberForm.jsx"
click node_memberlist "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/MemberTable.jsx"
click node_borrowform "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BorrowForm.jsx"
click node_borrowlist "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BorrowTable.jsx"
click node_tableparts "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/TableParts.jsx"
click node_sortpage "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/hooks.js"
click node_utils "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/utils.js"
click node_browserstore "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/App.jsx"
click node_bookseed "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/books.json"
click node_memberseed "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/members.json"
click node_borrowseed "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/borrowings.json"
click node_entry "https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/main.jsx"

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_login,node_dashboard,node_browserstore,node_entry toneBlue
class node_books,node_booklist,node_members,node_memberlist,node_bookseed,node_memberseed toneAmber
class node_borrowform,node_borrowlist,node_borrowseed toneMint
class node_toast,node_tableparts,node_sortpage,node_utils toneRose
class node_librarian toneIndigo
```

## Components

### Application

- [App coordinator](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/App.jsx): `src/App.jsx`
- [Sign-in](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Login.jsx): `src/components/Login.jsx`
- [Dashboard](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Dashboard.jsx): `src/components/Dashboard.jsx`
- [Browser storage](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/App.jsx): `src/App.jsx`
- [React entry point](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/main.jsx): `src/main.jsx`

### Library records

- [Book records](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BookForm.jsx): `src/components/BookForm.jsx`
- [Book catalog](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BookTable.jsx): `src/components/BookTable.jsx`
- [Borrower records](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/MemberForm.jsx): `src/components/MemberForm.jsx`
- [Borrower list](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/MemberTable.jsx): `src/components/MemberTable.jsx`
- [Book seed data](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/books.json): `public/books.json`
- [Borrower seed data](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/members.json): `public/members.json`

### Borrowing

- [Borrowing form](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BorrowForm.jsx): `src/components/BorrowForm.jsx`
- [Borrowing history](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/BorrowTable.jsx): `src/components/BorrowTable.jsx`
- [Borrowing seed data](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/public/borrowings.json): `public/borrowings.json`

### Shared UI

- [Notifications](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/Toast.jsx): `src/components/Toast.jsx`
- [Table controls](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/components/TableParts.jsx): `src/components/TableParts.jsx`
- [Sort and paginate](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/hooks.js): `src/hooks.js`
- [Domain utilities](https://github.com/jomarbunquin/minsu_library_tracker/blob/main/src/utils.js): `src/utils.js`

### Other components

- **Librarian**

## Connections

- Librarian → Sign-in: signs in
- React entry point → App coordinator: renders (evidence: `src/main.jsx`)
- App coordinator → Sign-in: gates access (evidence: `src/App.jsx`)
- App coordinator → Dashboard: renders (evidence: `src/App.jsx`)
- App coordinator → Book records: renders (evidence: `src/App.jsx`)
- App coordinator → Book catalog: renders (evidence: `src/App.jsx`)
- Book catalog → App coordinator: invokes actions (evidence: `src/App.jsx`)
- App coordinator → Borrower records: renders (evidence: `src/App.jsx`)
- App coordinator → Borrower list: renders (evidence: `src/App.jsx`)
- Borrower list → App coordinator: invokes actions (evidence: `src/App.jsx`)
- App coordinator → Borrowing form: renders (evidence: `src/App.jsx`)
- Borrowing form → App coordinator: submits records (evidence: `src/App.jsx`)
- App coordinator → Borrowing history: renders (evidence: `src/App.jsx`)
- Borrowing history → App coordinator: invokes actions (evidence: `src/App.jsx`)
- App coordinator → Notifications: renders (evidence: `src/App.jsx`)
- App coordinator → Browser storage: loads and saves (evidence: `src/App.jsx`)
- App coordinator → Book seed data: loads seed data
- App coordinator → Borrower seed data: loads seed data
- App coordinator → Borrowing seed data: loads seed data
- Book catalog → Sort and paginate: sorts pages (evidence: `src/components/BookTable.jsx`)
- Borrowing history → Sort and paginate: sorts pages (evidence: `src/components/BorrowTable.jsx`)
- Borrower list → Sort and paginate: sorts pages (evidence: `src/components/MemberTable.jsx`)
- Book catalog → Table controls: renders controls (evidence: `src/components/BookTable.jsx`)
- Borrowing history → Table controls: renders controls (evidence: `src/components/BorrowTable.jsx`)
- Borrower list → Table controls: renders controls (evidence: `src/components/MemberTable.jsx`)
- Dashboard → Domain utilities: checks overdue (evidence: `src/components/Dashboard.jsx`)
- Borrowing history → Domain utilities: checks overdue (evidence: `src/components/BorrowTable.jsx`)
- Borrowing form → Domain utilities: sets dates (evidence: `src/components/BorrowForm.jsx`)
- App coordinator → Domain utilities: validates records (evidence: `src/App.jsx`)
