# umum12/fast-app architecture

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

- Interactive diagram: https://gitdiagram.com/umum12/fast-app
- Repository: https://github.com/umum12/fast-app

## Overview

FAST APP is a GitHub Pages frontend PWA for a Google Apps Script backend. The principal workflow is a user interacting with the app UI, whose API calls are adapted to HTTP requests to Apps Script; the repository documents activity, scheduling, work, statistics, and PDF features. The build script assembles the published pages and PWA assets, so it is included as the source-to-site assembly layer. UI feature internals are not sampled; their existence is supported by the README and file tree, but no unverified calls between them are shown.

Main entry points: [`public/api-adapter.js`](https://github.com/umum12/fast-app/blob/main/public/api-adapter.js) (Apps Script adapter), [`build.js`](https://github.com/umum12/fast-app/blob/main/build.js) (Site assembler), [`public/sw.js`](https://github.com/umum12/fast-app/blob/main/public/sw.js) (Service worker), [`source/index.html`](https://github.com/umum12/fast-app/blob/main/source/index.html) (App entry UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assembly["Site assembly"]
  node_build["Site assembler<br/>[build.js]"]
  node_pages["Static app pages"]
  node_assets["PWA static assets"]
end

subgraph group_app["App UI"]
  node_app_ui["App entry UI<br/>[index.html]"]
  node_login["Login UI<br/>[login-card.html]"]
  node_activity["Activity UI"]
  node_schedule["Schedule UI<br/>[script-jadwal.html]"]
  node_work["Work UI"]
  node_statistics["Statistics view<br/>[statistik.html]"]
  node_pdf["PDF view<br/>[pdfrender.html]"]
end

subgraph group_connectivity["Backend connectivity"]
  node_adapter["Apps Script adapter<br/>[api-adapter.js]"]
end

subgraph group_pwa["PWA runtime"]
  node_install["Install prompt<br/>[pwa-install.js]"]
  node_updates["Update manager<br/>[pwa-update.js]"]
  node_service_worker["Service worker<br/>[sw.js]"]
  node_firebase_config["Firebase settings<br/>[firebase-config.js]"]
end

node_user(("App user"))
node_backend["Apps Script backend"]

node_user -->|"uses"| node_app_ui
node_build -->|"resolves templates"| node_pages
node_build -->|"copies assets"| node_assets
node_build -->|"configures shell"| node_service_worker
node_app_ui -->|"uses API bridge"| node_adapter
node_login -.->|"uses API bridge"| node_adapter
node_activity -.->|"uses API bridge"| node_adapter
node_schedule -.->|"uses API bridge"| node_adapter
node_work -.->|"uses API bridge"| node_adapter
node_statistics -.->|"uses API bridge"| node_adapter
node_pdf -.->|"uses API bridge"| node_adapter
node_adapter -->|"sends API requests"| node_backend
node_user -.->|"requests installation"| node_install
node_updates -->|"checks registration"| node_service_worker
node_service_worker -->|"shows push notifications"| node_user

click node_build "https://github.com/umum12/fast-app/blob/main/build.js"
click node_pages "https://github.com/umum12/fast-app/tree/main/source"
click node_assets "https://github.com/umum12/fast-app/tree/main/public"
click node_app_ui "https://github.com/umum12/fast-app/blob/main/source/index.html"
click node_login "https://github.com/umum12/fast-app/blob/main/source/login-card.html"
click node_activity "https://github.com/umum12/fast-app/blob/main/source/script-aktivitas.html"
click node_schedule "https://github.com/umum12/fast-app/blob/main/source/script-jadwal.html"
click node_work "https://github.com/umum12/fast-app/blob/main/source/script-pekerjaan.html"
click node_statistics "https://github.com/umum12/fast-app/blob/main/source/statistik.html"
click node_pdf "https://github.com/umum12/fast-app/blob/main/source/pdfrender.html"
click node_adapter "https://github.com/umum12/fast-app/blob/main/public/api-adapter.js"
click node_install "https://github.com/umum12/fast-app/blob/main/public/pwa-install.js"
click node_updates "https://github.com/umum12/fast-app/blob/main/public/pwa-update.js"
click node_service_worker "https://github.com/umum12/fast-app/blob/main/public/sw.js"
click node_firebase_config "https://github.com/umum12/fast-app/blob/main/public/firebase-config.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_build,node_pages,node_assets,node_user toneBlue
class node_app_ui,node_login,node_activity,node_schedule,node_work,node_statistics,node_pdf toneAmber
class node_adapter toneMint
class node_install,node_updates,node_service_worker,node_firebase_config toneRose
class node_backend toneIndigo
```

## Components

### Site assembly

- [Site assembler](https://github.com/umum12/fast-app/blob/main/build.js): `build.js`
- [Static app pages](https://github.com/umum12/fast-app/tree/main/source): `source`
- [PWA static assets](https://github.com/umum12/fast-app/tree/main/public): `public`

### App UI

- [App entry UI](https://github.com/umum12/fast-app/blob/main/source/index.html): `source/index.html`
- [Login UI](https://github.com/umum12/fast-app/blob/main/source/login-card.html): `source/login-card.html`
- [Activity UI](https://github.com/umum12/fast-app/blob/main/source/script-aktivitas.html): `source/script-aktivitas.html`
- [Schedule UI](https://github.com/umum12/fast-app/blob/main/source/script-jadwal.html): `source/script-jadwal.html`
- [Work UI](https://github.com/umum12/fast-app/blob/main/source/script-pekerjaan.html): `source/script-pekerjaan.html`
- [Statistics view](https://github.com/umum12/fast-app/blob/main/source/statistik.html): `source/statistik.html`
- [PDF view](https://github.com/umum12/fast-app/blob/main/source/pdfrender.html): `source/pdfrender.html`

### Backend connectivity

- [Apps Script adapter](https://github.com/umum12/fast-app/blob/main/public/api-adapter.js): `public/api-adapter.js`

### PWA runtime

- [Install prompt](https://github.com/umum12/fast-app/blob/main/public/pwa-install.js): `public/pwa-install.js`
- [Update manager](https://github.com/umum12/fast-app/blob/main/public/pwa-update.js): `public/pwa-update.js`
- [Service worker](https://github.com/umum12/fast-app/blob/main/public/sw.js): `public/sw.js`
- [Firebase settings](https://github.com/umum12/fast-app/blob/main/public/firebase-config.js): `public/firebase-config.js`

### Other components

- **App user**
- **Apps Script backend**

## Connections

- App user → App entry UI: uses (evidence: `README.md`)
- Site assembler → Static app pages: resolves templates (evidence: `build.js`)
- Site assembler → PWA static assets: copies assets (evidence: `build.js`)
- Site assembler → Service worker: configures shell (evidence: `build.js`)
- App entry UI → Apps Script adapter: uses API bridge
- Login UI → Apps Script adapter: uses API bridge
- Activity UI → Apps Script adapter: uses API bridge
- Schedule UI → Apps Script adapter: uses API bridge
- Work UI → Apps Script adapter: uses API bridge
- Statistics view → Apps Script adapter: uses API bridge
- PDF view → Apps Script adapter: uses API bridge
- Apps Script adapter → Apps Script backend: sends API requests (evidence: `public/api-adapter.js`)
- App user → Install prompt: requests installation
- Update manager → Service worker: checks registration (evidence: `public/pwa-update.js`)
- Service worker → App user: shows push notifications (evidence: `public/sw.js`)
