# frankji1019/remind-me architecture

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

- Interactive diagram: https://gitdiagram.com/frankji1019/remind-me
- Repository: https://github.com/frankji1019/remind-me

## Overview

remind-me is a self-hosted daily briefing system: a scheduled Lambda gathers Notion tasks and Google Calendar events, assembles template data, and sends an SES email. Its React admin portal previews email and themes, manages schedule and configuration, and displays delivery statistics and run logs through an HTTP API. The README documents the service relationships; sampled portal source shows routing and selected page-to-hook wiring. Other portal endpoint mappings are not shown, so those links are left unasserted.

Main entry points: [`admin-portal/src/App.tsx`](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/App.tsx) (Portal routing), [`admin-portal/src/api-hooks`](https://github.com/frankji1019/remind-me/tree/master/admin-portal/src/api-hooks) (API hooks), [`service-functions/src/remind-me.ts`](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/remind-me.ts) (Briefing orchestrator), [`service-functions/src/assemble-email.ts`](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/assemble-email.ts) (Email assembler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_briefing["Briefing delivery"]
  node_orchestrator["Briefing orchestrator<br/>[remind-me.ts]"]
  node_assembler["Email assembler<br/>[assemble-email.ts]"]
end

subgraph group_inputs["Briefing inputs"]
  node_todos["Todo retrieval<br/>[get-todos.ts]"]
  node_events["Calendar retrieval<br/>[get-calendar.ts]"]
end

subgraph group_admin_services["Admin services"]
  node_parameter_admin["Parameter management<br/>[manage-ssm.ts]"]
  node_schedule_admin["Schedule management<br/>[email-schedule.ts]"]
  node_stats_service["Delivery statistics<br/>[email-stats.ts]"]
  node_logs_service["Run log summaries<br/>[email-logs.ts]"]
  node_template_service["Template selection<br/>[email-template.ts]"]
end

subgraph group_portal["Admin portal"]
  node_portal_app["Portal routing<br/>[App.tsx]"]
  node_page_shell["Portal shell<br/>[index.tsx]"]
  node_api_hooks["API hooks"]
  node_email_page["Email preview"]
  node_themes_page["Theme selection<br/>[ThemesPage.tsx]"]
  node_stats_page["Statistics view<br/>[StatsPage.tsx]"]
  node_logs_page["Logs view<br/>[LogsPage.tsx]"]
  node_settings_page["Settings view<br/>[SettingsPage.tsx]"]
  node_mock_data["Preview sample data"]
end

node_schedule(("Daily schedule"))
node_ses["AWS SES"]
node_template_store["SES templates"]
node_notion["Notion API"]
node_calendar["Google Calendar API"]
node_ssm[("SSM Parameter Store")]
node_admin_api["HTTP API"]
node_user(("Administrator"))

node_schedule -->|"triggers daily"| node_orchestrator
node_orchestrator -->|"invokes"| node_assembler
node_assembler -->|"fetches tasks"| node_todos
node_assembler -->|"fetches events"| node_events
node_todos -->|"queries"| node_notion
node_events -->|"fetches events"| node_calendar
node_orchestrator -->|"sends email"| node_ses
node_orchestrator -->|"uses selected design"| node_template_store
node_assembler -->|"renders preview"| node_template_store
node_parameter_admin -->|"manages parameters"| node_ssm
node_schedule_admin -->|"serves schedule operations"| node_admin_api
node_stats_service -->|"serves statistics"| node_admin_api
node_logs_service -->|"serves run summaries"| node_admin_api
node_template_service -->|"reads and writes selection"| node_ssm
node_template_service -->|"serves template operations"| node_admin_api
node_user -->|"uses"| node_portal_app
node_portal_app -->|"renders shell"| node_page_shell
node_portal_app -->|"routes to"| node_email_page
node_portal_app -->|"routes to"| node_themes_page
node_portal_app -->|"routes to"| node_stats_page
node_portal_app -->|"routes to"| node_logs_page
node_portal_app -->|"routes to"| node_settings_page
node_email_page -->|"uses email and schedule data"| node_api_hooks
node_themes_page -->|"loads and applies templates"| node_api_hooks
node_stats_page -->|"receives statistics"| node_api_hooks
node_logs_page -->|"receives run logs"| node_api_hooks
node_settings_page -->|"loads settings"| node_api_hooks
node_api_hooks -->|"requests data"| node_admin_api
node_themes_page -->|"renders sample preview"| node_mock_data

click node_orchestrator "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/remind-me.ts"
click node_assembler "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/assemble-email.ts"
click node_template_store "https://github.com/frankji1019/remind-me/tree/master/service-functions/ses-templates"
click node_todos "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/get-todos.ts"
click node_events "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/get-calendar.ts"
click node_parameter_admin "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/manage-ssm.ts"
click node_schedule_admin "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-schedule.ts"
click node_stats_service "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-stats.ts"
click node_logs_service "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-logs.ts"
click node_template_service "https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-template.ts"
click node_portal_app "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/App.tsx"
click node_page_shell "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/containers/Page/index.tsx"
click node_api_hooks "https://github.com/frankji1019/remind-me/tree/master/admin-portal/src/api-hooks"
click node_email_page "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/EmailPreviewPage/EmailPreviewPage.tsx"
click node_themes_page "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/ThemesPage/ThemesPage.tsx"
click node_stats_page "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/StatsPage/StatsPage.tsx"
click node_logs_page "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/LogsPage/LogsPage.tsx"
click node_settings_page "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/SettingsPage/SettingsPage.tsx"
click node_mock_data "https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/utils/mockTemplateData.ts"

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_orchestrator,node_assembler toneBlue
class node_todos,node_events,node_ssm toneAmber
class node_parameter_admin,node_schedule_admin,node_stats_service,node_logs_service,node_template_service,node_notion,node_calendar,node_admin_api toneMint
class node_portal_app,node_page_shell,node_api_hooks,node_email_page,node_themes_page,node_stats_page,node_logs_page,node_settings_page,node_mock_data toneRose
class node_schedule,node_ses,node_user toneIndigo
class node_template_store toneTeal
```

## Components

### Briefing delivery

- [Briefing orchestrator](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/remind-me.ts): `service-functions/src/remind-me.ts`
- [Email assembler](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/assemble-email.ts): `service-functions/src/assemble-email.ts`

### Briefing inputs

- [Todo retrieval](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/get-todos.ts): `service-functions/src/get-todos.ts`
- [Calendar retrieval](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/get-calendar.ts): `service-functions/src/get-calendar.ts`

### Admin services

- [Parameter management](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/manage-ssm.ts): `service-functions/src/manage-ssm.ts`
- [Schedule management](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-schedule.ts): `service-functions/src/email-schedule.ts`
- [Delivery statistics](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-stats.ts): `service-functions/src/email-stats.ts`
- [Run log summaries](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-logs.ts): `service-functions/src/email-logs.ts`
- [Template selection](https://github.com/frankji1019/remind-me/blob/master/service-functions/src/email-template.ts): `service-functions/src/email-template.ts`

### Admin portal

- [Portal routing](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/App.tsx): `admin-portal/src/App.tsx`
- [Portal shell](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/containers/Page/index.tsx): `admin-portal/src/containers/Page/index.tsx`
- [API hooks](https://github.com/frankji1019/remind-me/tree/master/admin-portal/src/api-hooks): `admin-portal/src/api-hooks`
- [Email preview](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/EmailPreviewPage/EmailPreviewPage.tsx): `admin-portal/src/pages/EmailPreviewPage/EmailPreviewPage.tsx`
- [Theme selection](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/ThemesPage/ThemesPage.tsx): `admin-portal/src/pages/ThemesPage/ThemesPage.tsx`
- [Statistics view](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/StatsPage/StatsPage.tsx): `admin-portal/src/pages/StatsPage/StatsPage.tsx`
- [Logs view](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/LogsPage/LogsPage.tsx): `admin-portal/src/pages/LogsPage/LogsPage.tsx`
- [Settings view](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/pages/SettingsPage/SettingsPage.tsx): `admin-portal/src/pages/SettingsPage/SettingsPage.tsx`
- [Preview sample data](https://github.com/frankji1019/remind-me/blob/master/admin-portal/src/utils/mockTemplateData.ts): `admin-portal/src/utils/mockTemplateData.ts`

### Other components

- **Daily schedule**
- **AWS SES**
- [SES templates](https://github.com/frankji1019/remind-me/tree/master/service-functions/ses-templates): `service-functions/ses-templates`
- **Notion API**
- **Google Calendar API**
- **SSM Parameter Store**
- **HTTP API**
- **Administrator**

## Connections

- Daily schedule → Briefing orchestrator: triggers daily
- Briefing orchestrator → Email assembler: invokes
- Email assembler → Todo retrieval: fetches tasks
- Email assembler → Calendar retrieval: fetches events
- Todo retrieval → Notion API: queries
- Calendar retrieval → Google Calendar API: fetches events
- Briefing orchestrator → AWS SES: sends email
- Briefing orchestrator → SES templates: uses selected design
- Email assembler → SES templates: renders preview
- Parameter management → SSM Parameter Store: manages parameters
- Schedule management → HTTP API: serves schedule operations
- Delivery statistics → HTTP API: serves statistics
- Run log summaries → HTTP API: serves run summaries
- Template selection → SSM Parameter Store: reads and writes selection
- Template selection → HTTP API: serves template operations
- Administrator → Portal routing: uses
- Portal routing → Portal shell: renders shell (evidence: `admin-portal/src/App.tsx`)
- Portal routing → Email preview: routes to (evidence: `admin-portal/src/App.tsx`)
- Portal routing → Theme selection: routes to (evidence: `admin-portal/src/App.tsx`)
- Portal routing → Statistics view: routes to (evidence: `admin-portal/src/App.tsx`)
- Portal routing → Logs view: routes to (evidence: `admin-portal/src/App.tsx`)
- Portal routing → Settings view: routes to (evidence: `admin-portal/src/App.tsx`)
- Email preview → API hooks: uses email and schedule data (evidence: `admin-portal/src/pages/EmailPreviewPage/index.tsx`)
- Theme selection → API hooks: loads and applies templates (evidence: `admin-portal/src/pages/ThemesPage/index.tsx`)
- Statistics view → API hooks: receives statistics (evidence: `admin-portal/src/pages/StatsPage/index.tsx`)
- Logs view → API hooks: receives run logs (evidence: `admin-portal/src/pages/LogsPage/index.tsx`)
- Settings view → API hooks: loads settings (evidence: `admin-portal/src/pages/SettingsPage/index.tsx`)
- API hooks → HTTP API: requests data
- Theme selection → Preview sample data: renders sample preview (evidence: `admin-portal/src/pages/ThemesPage/ThemesPage.tsx`)
