# jabegueroinnersparc-lgtm/birthday-invitation architecture

> Architecture diagram of the GitHub repository jabegueroinnersparc-lgtm/birthday-invitation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jabegueroinnersparc-lgtm/birthday-invitation
- Repository: https://github.com/jabegueroinnersparc-lgtm/birthday-invitation

## Overview

The repository appears to be a small web app with a scanner page, a Google Apps Script file, and an API proxy. The README is empty, and only the proxy source was available to inspect, so the scanner’s behavior and how the HTML pages connect to the backend cannot be verified. The proxy explicitly forwards POST requests to a Google Apps Script URL. Audio files are present, but their use is unclear.

Main entry points: [`api/proxy.js`](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/api/proxy.js) (API proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web pages"]
  node_scanner["Scanner page<br/>[scanner.html]"]
  node_home["Main page<br/>[index.html]"]
end

subgraph group_server["Server integration"]
  node_proxy["API proxy<br/>[proxy.js]"]
  node_apps_script["Apps Script<br/>[Code.gs]"]
end

subgraph group_assets["Audio assets"]
  node_audio1["Audio track<br/>[planning.mp3]"]
  node_audio2["Audio track"]
  node_audio3["Audio track"]
  node_audio4["Audio track"]
end

node_upstream["Apps Script endpoint"]

node_proxy -->|"forwards POST"| node_upstream

click node_scanner "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/scanner.html"
click node_home "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/index.html"
click node_proxy "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/api/proxy.js"
click node_apps_script "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/Code.gs"
click node_audio1 "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/planning.mp3"
click node_audio2 "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/saira%20ingay%202%20(mp3cut.net).mp3"
click node_audio3 "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/shanghai%20salamat%20po.mp3"
click node_audio4 "https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/walakangshanghai.mp3"

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_scanner,node_home toneBlue
class node_proxy,node_apps_script toneAmber
class node_audio1,node_audio2,node_audio3,node_audio4 toneMint
class node_upstream toneIndigo
```

## Components

### Web pages

- [Scanner page](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/scanner.html): `scanner.html`
- [Main page](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/index.html): `index.html`

### Server integration

- [API proxy](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/api/proxy.js): `api/proxy.js`
- [Apps Script](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/Code.gs): `Code.gs`

### Audio assets

- [Audio track](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/planning.mp3): `planning.mp3`
- [Audio track](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/saira%20ingay%202%20(mp3cut.net).mp3): `saira ingay 2 (mp3cut.net).mp3`
- [Audio track](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/shanghai%20salamat%20po.mp3): `shanghai salamat po.mp3`
- [Audio track](https://github.com/jabegueroinnersparc-lgtm/birthday-invitation/blob/main/walakangshanghai.mp3): `walakangshanghai.mp3`

### Other components

- **Apps Script endpoint**

## Connections

- API proxy → Apps Script endpoint: forwards POST