# zyan1129/ai-schedule-planner architecture

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

- Interactive diagram: https://gitdiagram.com/zyan1129/ai-schedule-planner
- Repository: https://github.com/zyan1129/ai-schedule-planner

## Overview

SmartSchedule’s working planning flow is the Streamlit app: users enter a schedule, which is parsed, checked for overlaps, and used to generate alternatives; they can select an option, view a monthly calendar, and export CSV or ICS. The repository also contains a separate Next.js landing site. The README describes AI/Gemini capabilities, but the sampled runtime excerpts show regex-based parsing and no Gemini call; unsampled utility behavior is represented cautiously.

Main entry points: [`streamlit-app/app.py`](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py) (Planner interface), [`pages/index.tsx`](https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/index.tsx) (Home page), [`streamlit-app/utils.py`](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py) (Schedule parsing), [`pages/features.tsx`](https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/features.tsx) (Features page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planner["Schedule planning"]
  node_planner_ui["Planner interface<br/>[app.py]"]
  node_schedule_parse["Schedule parsing<br/>[utils.py]"]
  node_conflict_detection["Conflict detection<br/>[utils.py]"]
  node_solution_generation["Solution generation<br/>[utils.py]"]
  node_option_selection["Option selection<br/>[app.py]"]
  node_bilingual_ui["Bilingual interface<br/>[app.py]"]
end

subgraph group_views["Calendar and export"]
  node_calendar_rendering["Monthly calendar<br/>[utils.py]"]
  node_csv_export["CSV export<br/>[utils.py]"]
  node_ics_export["ICS export<br/>[utils.py]"]
end

subgraph group_web["Public web pages"]
  node_home_page["Home page<br/>[index.tsx]"]
  node_features_page["Features page<br/>[features.tsx]"]
end

node_planner_user(("Schedule user"))

node_planner_user -->|"enters schedule"| node_planner_ui
node_planner_ui -->|"parses input"| node_schedule_parse
node_planner_ui -->|"checks overlaps"| node_conflict_detection
node_planner_ui -->|"generates options"| node_solution_generation
node_planner_ui -->|"selects option"| node_option_selection
node_planner_ui -->|"switches language"| node_bilingual_ui
node_planner_ui -->|"renders calendar"| node_calendar_rendering
node_planner_ui -->|"exports CSV"| node_csv_export
node_planner_ui -->|"exports ICS"| node_ics_export
node_home_page -->|"links to"| node_features_page

click node_planner_ui "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py"
click node_schedule_parse "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_conflict_detection "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_solution_generation "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_option_selection "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py"
click node_bilingual_ui "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py"
click node_calendar_rendering "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_csv_export "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_ics_export "https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py"
click node_home_page "https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/index.tsx"
click node_features_page "https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/features.tsx"

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_planner_ui,node_schedule_parse,node_conflict_detection,node_solution_generation,node_option_selection,node_bilingual_ui,node_planner_user toneBlue
class node_calendar_rendering,node_csv_export,node_ics_export toneAmber
class node_home_page,node_features_page toneMint
```

## Components

### Schedule planning

- [Planner interface](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py): `streamlit-app/app.py`
- [Schedule parsing](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`
- [Conflict detection](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`
- [Solution generation](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`
- [Option selection](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py): `streamlit-app/app.py`
- [Bilingual interface](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/app.py): `streamlit-app/app.py`

### Calendar and export

- [Monthly calendar](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`
- [CSV export](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`
- [ICS export](https://github.com/zyan1129/ai-schedule-planner/blob/main/streamlit-app/utils.py): `streamlit-app/utils.py`

### Public web pages

- [Home page](https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/index.tsx): `pages/index.tsx`
- [Features page](https://github.com/zyan1129/ai-schedule-planner/blob/main/pages/features.tsx): `pages/features.tsx`

### Other components

- **Schedule user**

## Connections

- Schedule user → Planner interface: enters schedule (evidence: `streamlit-app/app.py`)
- Planner interface → Schedule parsing: parses input (evidence: `streamlit-app/app.py`)
- Planner interface → Conflict detection: checks overlaps (evidence: `streamlit-app/app.py`)
- Planner interface → Solution generation: generates options (evidence: `streamlit-app/app.py`)
- Planner interface → Option selection: selects option (evidence: `streamlit-app/app.py`)
- Planner interface → Bilingual interface: switches language (evidence: `streamlit-app/app.py`)
- Planner interface → Monthly calendar: renders calendar (evidence: `streamlit-app/app.py`)
- Planner interface → CSV export: exports CSV (evidence: `streamlit-app/app.py`)
- Planner interface → ICS export: exports ICS (evidence: `streamlit-app/app.py`)
- Home page → Features page: links to (evidence: `pages/index.tsx`)
