# ridwanridu/ibbl-kartikpur architecture

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

- Interactive diagram: https://gitdiagram.com/ridwanridu/ibbl-kartikpur
- Repository: https://github.com/ridwanridu/ibbl-kartikpur

## Overview

#### Purpose and delivery model
This repository is a static informational website for the Islami Bank Bangladesh PLC Kartikpur Bazar Agent Banking outlet. It presents agent-banking services and contact information; it has no indicated backend, authentication, transaction processing, or API layer. Deployment is static hosting, primarily GitHub Pages.

Paths: `index.html`, `README.md`

#### Primary entry and navigation
`index.html` is the main browser entry point and likely landing page for outlet information. Navigation is implemented as separate HTML documents rather than a client-side router, keeping page boundaries URL- and browser-native.

Paths: `index.html`, `agent.html`, `branches.html`

#### Outlet and service presentation
The core UI is static HTML/CSS/JavaScript rendered directly by the browser. Its principal responsibility is making service descriptions, location/address, and emergency contact channels accessible across desktop and mobile layouts.

Paths: `index.html`, `agent.html`

#### Agent directory data boundary
`agents.json` is the repository’s structured data asset. It likely separates agent/outlet records from page markup, allowing JavaScript in the HTML pages to load or display directory information without a server database. Any changes to agent records should preserve this JSON-to-browser consumption contract.

Paths: `agents.json`, `agent.html`, `branches.html`

#### Branch and agent discovery views
The repository distinguishes the local outlet landing experience from directory-style views: `agent.html` is the agent-facing/listing page, while `branches.html` provides branch-related discovery. These pages form the main information-navigation flow from general banking context to specific service locations.

Paths: `index.html`, `agent.html`, `branches.html`

#### Client runtime and platform boundary
The runtime is a standard web browser using HTML5, CSS3, and JavaScript embedded or referenced from the static documents. The browser fetches same-origin static assets such as `agents.json`; therefore hosting must serve the JSON with browser-accessible paths. GitHub Pages is the stated hosting platform.

Paths: `index.html`, `agents.json`, `README.md`

#### Installability metadata
`site.webmanifest` supplies web-app metadata for compatible browsers, creating an installability/PWA-adjacent boundary without evidence of service-worker-based offline behavior in the available tree.

Paths: `site.webmanifest`, `index.html`

Main entry points: [`index.html`](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/index.html) (Outlet landing page), [`agent.html`](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agent.html) (Agent directory page), [`branches.html`](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/branches.html) (Branch discovery page), [`agents.json`](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agents.json) (Agent records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Static website"]
  node_index["Outlet landing page<br/>HTML page<br/>[index.html]"]
  node_agent["Agent directory page<br/>HTML page<br/>[agent.html]"]
  node_branches["Branch discovery page<br/>HTML page<br/>[branches.html]"]
  node_agents_data[("Agent records<br/>JSON data<br/>[agents.json]")]
  node_presentation["Client presentation<br/>HTML/CSS/JavaScript"]
  node_manifest["Web app manifest<br/>PWA metadata<br/>[site.webmanifest]"]
end

subgraph group_platform["Hosting"]
  node_github_pages{{"GitHub Pages<br/>static host"}}
end

node_browser(("Web browser<br/>runtime"))
node_readme["Project documentation<br/>README<br/>[README.md]"]

node_browser -->|"requests site"| node_github_pages
node_github_pages -->|"serves"| node_index
node_github_pages -->|"serves"| node_agent
node_github_pages -->|"serves"| node_branches
node_index -->|"navigates to"| node_agent
node_index -->|"navigates to"| node_branches
node_agent -->|"loads"| node_agents_data
node_branches -->|"uses for discovery"| node_agents_data
node_index -->|"renders"| node_presentation
node_agent -->|"renders"| node_presentation
node_index -->|"declares"| node_manifest
node_readme -.->|"documents deployment"| node_github_pages

click node_index "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/index.html"
click node_agent "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agent.html"
click node_branches "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/branches.html"
click node_agents_data "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agents.json"
click node_manifest "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/site.webmanifest"
click node_readme "https://github.com/ridwanridu/ibbl-kartikpur/blob/main/README.md"

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_index,node_agent,node_branches,node_agents_data,node_presentation,node_manifest toneBlue
class node_github_pages toneAmber
class node_browser,node_readme toneNeutral
```

## Components

### Static website

Browser-served informational pages and assets.

- [Outlet landing page](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/index.html): HTML page · Primary entry for outlet services and contacts. · `index.html`
- [Agent directory page](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agent.html): HTML page · Agent-facing listing and discovery view. · `agent.html`
- [Branch discovery page](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/branches.html): HTML page · Branch-related location discovery view. · `branches.html`
- [Agent records](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/agents.json): JSON data · Structured directory data consumed in the browser. · `agents.json`
- **Client presentation**: HTML/CSS/JavaScript · Static responsive service, location, and contact UI.
- [Web app manifest](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/site.webmanifest): PWA metadata · Installability metadata without indicated offline runtime. · `site.webmanifest`

### Hosting

Static deployment boundary.

- **GitHub Pages**: static host · Primary static hosting platform.

### Other components

- **Web browser**: runtime · Renders pages and fetches same-origin assets.
- [Project documentation](https://github.com/ridwanridu/ibbl-kartikpur/blob/main/README.md): README · Documents the static site and GitHub Pages delivery. · `README.md`

## Connections

- Web browser → GitHub Pages: requests site
- GitHub Pages → Outlet landing page: serves
- GitHub Pages → Agent directory page: serves
- GitHub Pages → Branch discovery page: serves
- Outlet landing page → Agent directory page: navigates to
- Outlet landing page → Branch discovery page: navigates to
- Agent directory page → Agent records: loads
- Branch discovery page → Agent records: uses for discovery
- Outlet landing page → Client presentation: renders
- Agent directory page → Client presentation: renders
- Outlet landing page → Web app manifest: declares
- Project documentation → GitHub Pages: documents deployment