# hori-png/google_ai_challenge_2026 architecture

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

- Interactive diagram: https://gitdiagram.com/hori-png/google_ai_challenge_2026
- Repository: https://github.com/hori-png/google_ai_challenge_2026

## Overview

Re:Note is a diary-based productivity and learning app: users write or record a diary, receive Gemini sentiment scores and advice, then use forecasts, charts, maps, and review tools to reflect and plan. Firebase provides sign-in and per-user persistence; server API routes authenticate requests, enforce Gemini usage limits, and call Gemini with prompt files. The map/Places capability is optional. Relationships below follow the README and indexed import references; unsampled modules are represented only where documented, so some UI-to-service wiring is omitted.

Main entry points: [`src/lib/server/gemini.ts`](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/gemini.ts) (Gemini client), [`src/app/api/analyze/route.ts`](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/analyze/route.ts) (Diary analysis API), [`src/app/api/transcribe/route.ts`](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/transcribe/route.ts) (Voice transcription API), [`src/app`](https://github.com/hori-png/google_ai_challenge_2026/tree/main/src/app) (App pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["App pages"]
  node_diaryform["Diary entry<br/>[DiaryForm.tsx]"]
  node_map["Map experience<br/>[MapScreen.tsx]"]
  node_ui["Shared UI components<br/>[Ui.tsx]"]
end

subgraph group_diary["Diary and insights"]
  node_forecast["Forecast experience<br/>[useForecast.ts]"]
  node_forecastlogic["Forecast rules<br/>[forecast.ts]"]
  node_ask["Diary Q&amp;A<br/>[route.ts]"]
  node_character["Character messages<br/>[route.ts]"]
  node_mood["Mood charts<br/>[MoodScreen.tsx]"]
  node_places["Nearby places API<br/>[route.ts]"]
end

subgraph group_server["AI services"]
  node_analyze["Diary analysis API<br/>[route.ts]"]
  node_transcribe["Voice transcription API<br/>[route.ts]"]
  node_prompts["Prompt loader<br/>[prompts.ts]"]
  node_gemini["Gemini client<br/>[gemini.ts]"]
end

subgraph group_learning["Learning and planning"]
  node_review["Learning review<br/>[ReviewScreen.tsx]"]
  node_forgetting["Recall scheduling<br/>[forgetting.ts]"]
  node_quiz["Review quiz API<br/>[route.ts]"]
end

subgraph group_platform["Identity and storage"]
  node_auth["Auth and profile<br/>[AuthProvider.tsx]"]
  node_diaries[("Diary storage<br/>[diaries.ts]")]
  node_security["Request verification<br/>[verifyIdToken.ts]"]
  node_quota["Usage limits<br/>[usage.ts]"]
end

node_user(("Diary user"))
node_firebase[("Firebase services")]
node_geminiservice{{"Google Gemini"}}
node_placeservice{{"Places service"}}

node_user -->|"uses"| node_app
node_app -->|"opens entry"| node_diaryform
node_diaryform -.->|"saves diary"| node_diaries
node_app -->|"renders"| node_ui
node_app -->|"guards pages"| node_auth
node_analyze -->|"verifies user"| node_security
node_analyze -->|"checks quota"| node_quota
node_analyze -->|"loads prompt"| node_prompts
node_analyze -->|"requests analysis"| node_gemini
node_analyze -.->|"stores analysis"| node_diaries
node_transcribe -->|"verifies user"| node_security
node_transcribe -->|"checks quota"| node_quota
node_transcribe -->|"loads prompt"| node_prompts
node_transcribe -->|"transcribes audio"| node_gemini
node_forecast -->|"builds history"| node_forecastlogic
node_forecast -->|"loads diary data"| node_diaries
node_forecast -.->|"saves forecast"| node_firebase
node_ask -->|"verifies user"| node_security
node_ask -->|"answers question"| node_gemini
node_character -->|"generates reply"| node_gemini
node_review -->|"sorts review"| node_forgetting
node_review -.->|"loads and saves"| node_firebase
node_quiz -->|"uses recall rules"| node_forgetting
node_quiz -->|"generates quiz"| node_gemini
node_places -->|"verifies user"| node_security
node_places -.->|"finds locations"| node_placeservice
node_map -.->|"requests locations"| node_places
node_auth -->|"authenticates"| node_firebase
node_diaries -->|"reads and writes"| node_firebase
node_gemini -->|"calls model"| node_geminiservice
node_prompts -.->|"supplies instructions"| node_geminiservice

click node_app "https://github.com/hori-png/google_ai_challenge_2026/tree/main/src/app"
click node_diaryform "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/DiaryForm.tsx"
click node_auth "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/AuthProvider.tsx"
click node_diaries "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/diaries.ts"
click node_analyze "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/analyze/route.ts"
click node_transcribe "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/transcribe/route.ts"
click node_prompts "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/prompts.ts"
click node_gemini "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/gemini.ts"
click node_security "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/verifyIdToken.ts"
click node_quota "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/usage.ts"
click node_forecast "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/useForecast.ts"
click node_forecastlogic "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/forecast.ts"
click node_ask "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/ask/route.ts"
click node_character "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/character/route.ts"
click node_mood "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/MoodScreen.tsx"
click node_review "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/ReviewScreen.tsx"
click node_forgetting "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/forgetting.ts"
click node_quiz "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/quiz/route.ts"
click node_places "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/places/route.ts"
click node_map "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/MapScreen.tsx"
click node_ui "https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/ui/Ui.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_app,node_diaryform,node_map,node_ui,node_user toneBlue
class node_forecast,node_forecastlogic,node_ask,node_character,node_mood,node_places,node_firebase toneAmber
class node_analyze,node_transcribe,node_prompts,node_gemini toneMint
class node_review,node_forgetting,node_quiz toneRose
class node_auth,node_diaries,node_security,node_quota,node_geminiservice,node_placeservice toneIndigo
```

## Components

### User experience

- [App pages](https://github.com/hori-png/google_ai_challenge_2026/tree/main/src/app): `src/app`
- [Diary entry](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/DiaryForm.tsx): `src/components/DiaryForm.tsx`
- [Map experience](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/MapScreen.tsx): `src/components/MapScreen.tsx`
- [Shared UI components](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/ui/Ui.tsx): `src/components/ui/Ui.tsx`

### Diary and insights

- [Forecast experience](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/useForecast.ts): `src/components/useForecast.ts`
- [Forecast rules](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/forecast.ts): `src/lib/forecast.ts`
- [Diary Q&A](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/ask/route.ts): `src/app/api/ask/route.ts`
- [Character messages](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/character/route.ts): `src/app/api/character/route.ts`
- [Mood charts](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/MoodScreen.tsx): `src/components/MoodScreen.tsx`
- [Nearby places API](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/places/route.ts): `src/app/api/places/route.ts`

### AI services

- [Diary analysis API](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/analyze/route.ts): `src/app/api/analyze/route.ts`
- [Voice transcription API](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/transcribe/route.ts): `src/app/api/transcribe/route.ts`
- [Prompt loader](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/prompts.ts): `src/lib/server/prompts.ts`
- [Gemini client](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/gemini.ts): `src/lib/server/gemini.ts`

### Learning and planning

- [Learning review](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/ReviewScreen.tsx): `src/components/ReviewScreen.tsx`
- [Recall scheduling](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/forgetting.ts): `src/lib/forgetting.ts`
- [Review quiz API](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/app/api/quiz/route.ts): `src/app/api/quiz/route.ts`

### Identity and storage

- [Auth and profile](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/components/AuthProvider.tsx): `src/components/AuthProvider.tsx`
- [Diary storage](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/diaries.ts): `src/lib/diaries.ts`
- [Request verification](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/verifyIdToken.ts): `src/lib/server/verifyIdToken.ts`
- [Usage limits](https://github.com/hori-png/google_ai_challenge_2026/blob/main/src/lib/server/usage.ts): `src/lib/server/usage.ts`

### Other components

- **Diary user**
- **Firebase services**
- **Google Gemini**
- **Places service**

## Connections

- Diary user → App pages: uses (evidence: `README.md`)
- App pages → Diary entry: opens entry (evidence: `README.md`)
- Diary entry → Diary storage: saves diary
- App pages → Shared UI components: renders (evidence: `src/app/ask/page.tsx`)
- App pages → Auth and profile: guards pages (evidence: `src/app/ask/page.tsx`)
- Diary analysis API → Request verification: verifies user (evidence: `src/app/api/analyze/route.ts`)
- Diary analysis API → Usage limits: checks quota (evidence: `src/app/api/analyze/route.ts`)
- Diary analysis API → Prompt loader: loads prompt (evidence: `src/app/api/analyze/route.ts`)
- Diary analysis API → Gemini client: requests analysis (evidence: `src/app/api/analyze/route.ts`)
- Diary analysis API → Diary storage: stores analysis
- Voice transcription API → Request verification: verifies user (evidence: `src/app/api/transcribe/route.ts`)
- Voice transcription API → Usage limits: checks quota (evidence: `src/app/api/transcribe/route.ts`)
- Voice transcription API → Prompt loader: loads prompt (evidence: `src/app/api/transcribe/route.ts`)
- Voice transcription API → Gemini client: transcribes audio (evidence: `src/app/api/transcribe/route.ts`)
- Forecast experience → Forecast rules: builds history (evidence: `src/components/useForecast.ts`)
- Forecast experience → Diary storage: loads diary data (evidence: `src/components/useForecast.ts`)
- Forecast experience → Firebase services: saves forecast
- Diary Q&A → Request verification: verifies user (evidence: `src/app/api/ask/route.ts`)
- Diary Q&A → Gemini client: answers question (evidence: `src/app/api/ask/route.ts`)
- Character messages → Gemini client: generates reply (evidence: `src/app/api/character/route.ts`)
- Learning review → Recall scheduling: sorts review (evidence: `src/components/ReviewScreen.tsx`)
- Learning review → Firebase services: loads and saves
- Review quiz API → Recall scheduling: uses recall rules (evidence: `src/app/api/quiz/route.ts`)
- Review quiz API → Gemini client: generates quiz (evidence: `src/app/api/quiz/route.ts`)
- Nearby places API → Request verification: verifies user (evidence: `src/app/api/places/route.ts`)
- Nearby places API → Places service: finds locations
- Map experience → Nearby places API: requests locations
- Auth and profile → Firebase services: authenticates (evidence: `README.md`)
- Diary storage → Firebase services: reads and writes (evidence: `src/lib/diaries.ts`)
- Gemini client → Google Gemini: calls model (evidence: `src/lib/server/gemini.ts`)
- Prompt loader → Google Gemini: supplies instructions
