# untypequicode/celcat-scraping architecture

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

- Interactive diagram: https://gitdiagram.com/untypequicode/celcat-scraping
- Repository: https://github.com/untypequicode/celcat-scraping

## Overview

Celcat → ICS turns a pasted Celcat calendar URL or manually entered resource into a shareable ICS endpoint link. The frontend parses and validates source and date options, then the backend fetches Celcat events, deduplicates and converts them into a calendar response, with caching. The UI also supports custom event colors, quick-add links, SEO metadata, and light/dark appearance. Backend fetching and conversion are visible in the sampled Rust excerpts; component wiring beyond the sampled frontend files is limited to documented or excerpted references.

Main entry points: [`frontend/app/app.vue`](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/app.vue) (Page orchestration), [`backend/src/main.rs`](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/main.rs) (HTTP API & routing), [`backend/src/celcat.rs`](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs) (Calendar generation), [`frontend/app/composables/useCalendarForm.ts`](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useCalendarForm.ts) (Form state & link)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Calendar web app"]
  node_form_ui["Calendar form UI"]
  node_app["Page orchestration<br/>[app.vue]"]
  node_form_state["Form state &amp; link<br/>[useCalendarForm.ts]"]
  node_url_parser["Celcat URL parser"]
  node_result_ui["Result &amp; quick-add"]
  node_theme["Theme preference<br/>[useColorScheme.ts]"]
  node_theme_plugin["Theme initialization"]
  node_seo["SEO metadata<br/>[useSiteSeo.ts]"]
end

subgraph group_backend["Calendar API"]
  node_api["HTTP API &amp; routing<br/>[main.rs]"]
  node_cache[("ICS response cache<br/>[main.rs]")]
end

subgraph group_celcat["Celcat integration"]
  node_celcat_service["Calendar generation<br/>[celcat.rs]"]
  node_fetch["Weekly event retrieval<br/>[celcat.rs]"]
  node_deduplicate["Event deduplication<br/>[celcat.rs]"]
end

subgraph group_conversion["Calendar conversion"]
  node_parse["Event detail parsing<br/>[celcat.rs]"]
  node_ics["ICS construction<br/>[celcat.rs]"]
end

node_visitor(("Calendar user"))
node_celcat_service_external["Celcat calendar service"]
node_calendar_client(("Calendar app"))

node_visitor -->|"enters options"| node_form_ui
node_app -->|"renders form"| node_form_ui
node_app -->|"uses form state"| node_form_state
node_form_state -->|"parses pasted URL"| node_url_parser
node_app -->|"renders result"| node_result_ui
node_form_state -->|"builds endpoint link"| node_api
node_app -->|"sets page metadata"| node_seo
node_theme_plugin -->|"initializes theme"| node_theme
node_api -->|"reads and writes"| node_cache
node_api -->|"generates calendar"| node_celcat_service
node_celcat_service -->|"fetches weeks"| node_fetch
node_fetch -->|"requests events"| node_celcat_service_external
node_celcat_service -->|"deduplicates events"| node_deduplicate
node_celcat_service -->|"builds calendar"| node_ics
node_ics -->|"parses event details"| node_parse
node_api -.->|"serves ICS"| node_calendar_client
node_visitor -.->|"changes appearance"| node_theme

click node_form_ui "https://github.com/untypequicode/celcat-scraping/tree/main/frontend/app/components/form"
click node_app "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/app.vue"
click node_form_state "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useCalendarForm.ts"
click node_url_parser "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useCelcatUrlParser.ts"
click node_result_ui "https://github.com/untypequicode/celcat-scraping/tree/main/frontend/app/components/result"
click node_theme "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useColorScheme.ts"
click node_theme_plugin "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/plugins/color-scheme.client.ts"
click node_seo "https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useSiteSeo.ts"
click node_api "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/main.rs"
click node_cache "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/main.rs"
click node_celcat_service "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs"
click node_fetch "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs"
click node_deduplicate "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs"
click node_parse "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs"
click node_ics "https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs"

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_form_ui,node_app,node_form_state,node_url_parser,node_result_ui,node_theme,node_theme_plugin,node_seo,node_visitor toneBlue
class node_api,node_cache toneAmber
class node_celcat_service,node_fetch,node_deduplicate toneMint
class node_parse,node_ics toneRose
class node_celcat_service_external,node_calendar_client toneIndigo
```

## Components

### Calendar web app

- [Calendar form UI](https://github.com/untypequicode/celcat-scraping/tree/main/frontend/app/components/form): `frontend/app/components/form`
- [Page orchestration](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/app.vue): `frontend/app/app.vue`
- [Form state & link](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useCalendarForm.ts): `frontend/app/composables/useCalendarForm.ts`
- [Celcat URL parser](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useCelcatUrlParser.ts): `frontend/app/composables/useCelcatUrlParser.ts`
- [Result & quick-add](https://github.com/untypequicode/celcat-scraping/tree/main/frontend/app/components/result): `frontend/app/components/result`
- [Theme preference](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useColorScheme.ts): `frontend/app/composables/useColorScheme.ts`
- [Theme initialization](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/plugins/color-scheme.client.ts): `frontend/app/plugins/color-scheme.client.ts`
- [SEO metadata](https://github.com/untypequicode/celcat-scraping/blob/main/frontend/app/composables/useSiteSeo.ts): `frontend/app/composables/useSiteSeo.ts`

### Calendar API

- [HTTP API & routing](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/main.rs): `backend/src/main.rs`
- [ICS response cache](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/main.rs): `backend/src/main.rs`

### Celcat integration

- [Calendar generation](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs): `backend/src/celcat.rs`
- [Weekly event retrieval](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs): `backend/src/celcat.rs`
- [Event deduplication](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs): `backend/src/celcat.rs`

### Calendar conversion

- [Event detail parsing](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs): `backend/src/celcat.rs`
- [ICS construction](https://github.com/untypequicode/celcat-scraping/blob/main/backend/src/celcat.rs): `backend/src/celcat.rs`

### Other components

- **Calendar user**
- **Celcat calendar service**
- **Calendar app**

## Connections

- Calendar user → Calendar form UI: enters options (evidence: `frontend/app/components/form/SourceStep.vue`)
- Page orchestration → Calendar form UI: renders form (evidence: `frontend/app/app.vue`)
- Page orchestration → Form state & link: uses form state (evidence: `frontend/app/app.vue`)
- Form state & link → Celcat URL parser: parses pasted URL (evidence: `frontend/app/composables/useCalendarForm.ts`)
- Page orchestration → Result & quick-add: renders result (evidence: `frontend/app/app.vue`)
- Form state & link → HTTP API & routing: builds endpoint link (evidence: `frontend/app/composables/useCalendarForm.ts`)
- Page orchestration → SEO metadata: sets page metadata (evidence: `frontend/app/app.vue`)
- Theme initialization → Theme preference: initializes theme (evidence: `frontend/app/plugins/color-scheme.client.ts`)
- HTTP API & routing → ICS response cache: reads and writes (evidence: `backend/src/main.rs`)
- HTTP API & routing → Calendar generation: generates calendar (evidence: `backend/src/main.rs`)
- Calendar generation → Weekly event retrieval: fetches weeks (evidence: `backend/src/celcat.rs`)
- Weekly event retrieval → Celcat calendar service: requests events (evidence: `backend/src/celcat.rs`)
- Calendar generation → Event deduplication: deduplicates events (evidence: `backend/src/celcat.rs`)
- Calendar generation → ICS construction: builds calendar (evidence: `backend/src/celcat.rs`)
- ICS construction → Event detail parsing: parses event details (evidence: `backend/src/celcat.rs`)
- HTTP API & routing → Calendar app: serves ICS
- Calendar user → Theme preference: changes appearance
