# m3m3nto/giaa architecture

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

- Interactive diagram: https://gitdiagram.com/m3m3nto/giaa
- Repository: https://github.com/m3m3nto/giaa

## Overview

GIAA accepts indexing requests through a web UI, validates and checks URLs, persists their status, then a scheduled worker dispatches eligible pending URLs through Google’s Indexing API and updates the UI. The graph preserves account/property configuration, quota tracking, request history, and live status updates. Relationships reflect the provided source excerpts or README; the UI/template and account-pairing details are only documented or visible in routes, so no unshown internals are inferred.

Main entry points: [`worker.js`](https://github.com/m3m3nto/giaa/blob/master/worker.js) (Scheduled worker), [`app.js`](https://github.com/m3m3nto/giaa/blob/master/app.js) (HTTP app), [`routes/index.js`](https://github.com/m3m3nto/giaa/blob/master/routes/index.js) (Web routes), [`models/url.js`](https://github.com/m3m3nto/giaa/blob/master/models/url.js) (URL history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app["HTTP app<br/>[app.js]"]
  node_routes["Web routes<br/>[index.js]"]
  node_browser["Live request UI<br/>[application.js]"]
  node_templates["Rendered pages"]
  node_auth["Basic auth<br/>[auth.js]"]
end

subgraph group_validation["Request validation"]
  node_checker["URL checks<br/>[checker.js]"]
  node_quota["Quota counter<br/>[utils.js]"]
end

subgraph group_dispatch["Indexing dispatch"]
  node_worker["Scheduled worker<br/>[worker.js]"]
  node_indexer["Google notifier<br/>[indexer.js]"]
end

subgraph group_persistence["Persistent state"]
  node_urlmodel[("URL history<br/>[url.js]")]
  node_accountmodel[("GSC accounts<br/>[account.js]")]
end

subgraph group_settings["Configuration"]
  node_config["App settings<br/>[app.js]"]
end

node_user(("Operator"))
node_google{{"Google Indexing API"}}
node_mongo[("MongoDB")]
node_target(("Submitted URL"))

node_user -->|"uses"| node_app
node_app -->|"guards requests"| node_auth
node_app -->|"mounts routes"| node_routes
node_routes -->|"renders pages"| node_templates
node_user -->|"submits requests"| node_routes
node_routes -->|"checks URLs"| node_checker
node_target -->|"provides URL"| node_routes
node_checker -->|"checks property"| node_accountmodel
node_checker -->|"saves checks"| node_urlmodel
node_routes -->|"manages accounts"| node_accountmodel
node_routes -->|"reads quota"| node_quota
node_quota -->|"counts requests"| node_urlmodel
node_worker -->|"checks quota"| node_quota
node_worker -->|"loads pending"| node_urlmodel
node_worker -->|"finds account"| node_accountmodel
node_worker -->|"dispatches notification"| node_indexer
node_indexer -->|"publishes URL"| node_google
node_worker -->|"saves outcome"| node_urlmodel
node_worker -->|"emits updates"| node_app
node_app -->|"broadcasts updates"| node_browser
node_config -->|"configures"| node_app
node_config -->|"configures"| node_worker
node_config -->|"selects key directory"| node_indexer
node_app -->|"connects"| node_mongo
node_worker -->|"connects"| node_mongo

click node_app "https://github.com/m3m3nto/giaa/blob/master/app.js"
click node_routes "https://github.com/m3m3nto/giaa/blob/master/routes/index.js"
click node_browser "https://github.com/m3m3nto/giaa/blob/master/public/js/application.js"
click node_templates "https://github.com/m3m3nto/giaa/tree/master/views"
click node_auth "https://github.com/m3m3nto/giaa/blob/master/modules/auth.js"
click node_checker "https://github.com/m3m3nto/giaa/blob/master/modules/checker.js"
click node_urlmodel "https://github.com/m3m3nto/giaa/blob/master/models/url.js"
click node_accountmodel "https://github.com/m3m3nto/giaa/blob/master/models/account.js"
click node_quota "https://github.com/m3m3nto/giaa/blob/master/modules/utils.js"
click node_worker "https://github.com/m3m3nto/giaa/blob/master/worker.js"
click node_indexer "https://github.com/m3m3nto/giaa/blob/master/modules/indexer.js"
click node_config "https://github.com/m3m3nto/giaa/blob/master/config/app.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_routes,node_browser,node_templates,node_auth toneBlue
class node_checker,node_quota,node_mongo toneAmber
class node_worker,node_indexer,node_google toneMint
class node_urlmodel,node_accountmodel toneRose
class node_config,node_user,node_target toneIndigo
```

## Components

### Web interface

- [HTTP app](https://github.com/m3m3nto/giaa/blob/master/app.js): `app.js`
- [Web routes](https://github.com/m3m3nto/giaa/blob/master/routes/index.js): `routes/index.js`
- [Live request UI](https://github.com/m3m3nto/giaa/blob/master/public/js/application.js): `public/js/application.js`
- [Rendered pages](https://github.com/m3m3nto/giaa/tree/master/views): `views`
- [Basic auth](https://github.com/m3m3nto/giaa/blob/master/modules/auth.js): `modules/auth.js`

### Request validation

- [URL checks](https://github.com/m3m3nto/giaa/blob/master/modules/checker.js): `modules/checker.js`
- [Quota counter](https://github.com/m3m3nto/giaa/blob/master/modules/utils.js): `modules/utils.js`

### Indexing dispatch

- [Scheduled worker](https://github.com/m3m3nto/giaa/blob/master/worker.js): `worker.js`
- [Google notifier](https://github.com/m3m3nto/giaa/blob/master/modules/indexer.js): `modules/indexer.js`

### Persistent state

- [URL history](https://github.com/m3m3nto/giaa/blob/master/models/url.js): `models/url.js`
- [GSC accounts](https://github.com/m3m3nto/giaa/blob/master/models/account.js): `models/account.js`

### Configuration

- [App settings](https://github.com/m3m3nto/giaa/blob/master/config/app.js): `config/app.js`

### Other components

- **Operator**
- **Google Indexing API**
- **MongoDB**
- **Submitted URL**

## Connections

- Operator → HTTP app: uses (evidence: `README.md`)
- HTTP app → Basic auth: guards requests (evidence: `app.js`)
- HTTP app → Web routes: mounts routes (evidence: `app.js`)
- Web routes → Rendered pages: renders pages (evidence: `routes/index.js`)
- Operator → Web routes: submits requests (evidence: `routes/index.js`)
- Web routes → URL checks: checks URLs (evidence: `routes/index.js`)
- Submitted URL → Web routes: provides URL (evidence: `routes/index.js`)
- URL checks → GSC accounts: checks property (evidence: `modules/checker.js`)
- URL checks → URL history: saves checks (evidence: `modules/checker.js`)
- Web routes → GSC accounts: manages accounts (evidence: `routes/index.js`)
- Web routes → Quota counter: reads quota (evidence: `routes/index.js`)
- Quota counter → URL history: counts requests (evidence: `modules/utils.js`)
- Scheduled worker → Quota counter: checks quota (evidence: `worker.js`)
- Scheduled worker → URL history: loads pending (evidence: `worker.js`)
- Scheduled worker → GSC accounts: finds account (evidence: `worker.js`)
- Scheduled worker → Google notifier: dispatches notification (evidence: `worker.js`)
- Google notifier → Google Indexing API: publishes URL (evidence: `modules/indexer.js`)
- Scheduled worker → URL history: saves outcome (evidence: `worker.js`)
- Scheduled worker → HTTP app: emits updates (evidence: `worker.js`)
- HTTP app → Live request UI: broadcasts updates (evidence: `app.js`)
- App settings → HTTP app: configures (evidence: `app.js`)
- App settings → Scheduled worker: configures (evidence: `worker.js`)
- App settings → Google notifier: selects key directory (evidence: `modules/indexer.js`)
- HTTP app → MongoDB: connects (evidence: `app.js`)
- Scheduled worker → MongoDB: connects (evidence: `worker.js`)
