# egamijun/ai-giziroku architecture

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

- Interactive diagram: https://gitdiagram.com/egamijun/ai-giziroku
- Repository: https://github.com/egamijun/ai-giziroku

## Overview

AI-Giziroku captures meeting audio, transcribes it in real time, supports speaker correction and role-based Claude feedback, then generates a meeting record asynchronously. The main flow runs from meeting setup through recording and transcript storage to feedback, meeting end, and summary display. README statements support the broader UI capabilities; source excerpts show recording-to-transcription, API-to-service, and persistence relationships. Some UI and API internals were not sampled, so those links are documented rather than inferred from module names.

Main entry points: [`lib/prisma.ts`](https://github.com/egamijun/ai-giziroku/blob/main/lib/prisma.ts) (Prisma client), [`app/[id]/recording/page.tsx`](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/recording/page.tsx) (Recording screen), [`lib/amivoice/client.ts`](https://github.com/egamijun/ai-giziroku/blob/main/lib/amivoice/client.ts) (AmiVoice recognizer), [`app/[id]/page.tsx`](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/page.tsx) (Meeting detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_meeting_ui["Meeting workflow UI"]
  node_meeting_list["Meeting list<br/>[page.tsx]"]
  node_meeting_card["Meeting card<br/>[meeting-card.tsx]"]
  node_meeting_setup["Meeting setup<br/>[page.tsx]"]
  node_recording_ui["Recording screen<br/>[page.tsx]"]
  node_meeting_detail["Meeting detail<br/>[page.tsx]"]
  node_transcript_view["Transcript editor"]
  node_speaker_controls["Speaker controls<br/>[speakers-ui.tsx]"]
  node_feedback_tabs["Role feedback tabs"]
  node_summary_poller["Summary status poller"]
end

subgraph group_speech["Speech and speakers"]
  node_audio_input(("Microphone and loopback"))
  node_recognition["AmiVoice recognizer<br/>[client.ts]"]
  node_pcm_worklet["PCM audio worklet<br/>[pcm-worklet.js]"]
  node_speaker_logic["Speaker mapping<br/>[speakers.ts]"]
end

subgraph group_api["Meeting APIs"]
  node_meetings_api["Meeting routes<br/>[route.ts]"]
  node_meeting_id_api["Meeting detail routes<br/>[route.ts]"]
  node_meeting_end_api["Meeting end route<br/>[route.ts]"]
  node_transcripts_api["Transcript routes<br/>[route.ts]"]
  node_transcript_id_api["Transcript edit route<br/>[route.ts]"]
  node_feedback_api["Feedback route<br/>[route.ts]"]
  node_summary_api["Summary route<br/>[route.ts]"]
end

subgraph group_ai["AI services"]
  node_role_prompts["Role prompt logic<br/>[roles.ts]"]
  node_claude_client["Claude service<br/>[claude.ts]"]
end

subgraph group_persistence["Persistence"]
  node_prisma_client["Prisma client<br/>[prisma.ts]"]
  node_database[("Meeting database<br/>[schema.prisma]")]
end

node_operator(("Meeting user"))
node_amivoice_service{{"AmiVoice Cloud"}}
node_anthropic_service{{"Anthropic API"}}

node_operator -->|"opens"| node_meeting_list
node_meeting_list -->|"renders"| node_meeting_card
node_operator -->|"starts meeting"| node_meeting_setup
node_meeting_setup -->|"creates meeting"| node_meetings_api
node_meetings_api -->|"creates record"| node_prisma_client
node_meeting_list -->|"loads meetings"| node_prisma_client
node_operator -->|"records meeting"| node_recording_ui
node_audio_input -->|"supplies audio"| node_recognition
node_recognition -->|"streams audio"| node_amivoice_service
node_recognition -->|"processes audio"| node_pcm_worklet
node_recognition -->|"maps diarization"| node_speaker_logic
node_recording_ui -->|"starts recognizers"| node_recognition
node_recording_ui -->|"saves utterances"| node_transcripts_api
node_transcripts_api -->|"stores transcript"| node_prisma_client
node_recording_ui -->|"requests feedback"| node_feedback_api
node_feedback_api -->|"requests feedback"| node_claude_client
node_feedback_api -->|"parses roles"| node_role_prompts
node_claude_client -->|"builds prompts"| node_role_prompts
node_claude_client -->|"sends prompts"| node_anthropic_service
node_feedback_api -->|"reads and saves"| node_prisma_client
node_recording_ui -->|"renames speakers"| node_meeting_id_api
node_transcript_view -->|"renders controls"| node_speaker_controls
node_transcript_view -->|"reassigns speaker"| node_transcript_id_api
node_meeting_detail -->|"renders log"| node_transcript_view
node_meeting_detail -->|"renders feedback"| node_feedback_tabs
node_recording_ui -->|"shows feedback"| node_feedback_tabs
node_operator -->|"ends and generates"| node_summary_api
node_summary_api -->|"requests summary"| node_claude_client
node_summary_api -->|"parses roles"| node_role_prompts
node_summary_api -->|"loads and updates"| node_prisma_client
node_meeting_detail -->|"polls status"| node_summary_poller
node_meeting_detail -->|"loads meeting"| node_prisma_client
node_meeting_end_api -->|"ends meeting"| node_prisma_client
node_meeting_id_api -->|"reads and updates"| node_prisma_client
node_transcript_id_api -->|"updates transcript"| node_prisma_client
node_prisma_client -.->|"queries data"| node_database

click node_meeting_list "https://github.com/egamijun/ai-giziroku/blob/main/app/page.tsx"
click node_meeting_card "https://github.com/egamijun/ai-giziroku/blob/main/app/meeting-card.tsx"
click node_meeting_setup "https://github.com/egamijun/ai-giziroku/blob/main/app/new/page.tsx"
click node_recording_ui "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/recording/page.tsx"
click node_meeting_detail "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/page.tsx"
click node_transcript_view "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/transcript-list.tsx"
click node_speaker_controls "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/speakers-ui.tsx"
click node_feedback_tabs "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/role-feedback-tabs.tsx"
click node_summary_poller "https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/summary-status-poller.tsx"
click node_recognition "https://github.com/egamijun/ai-giziroku/blob/main/lib/amivoice/client.ts"
click node_pcm_worklet "https://github.com/egamijun/ai-giziroku/blob/main/public/worklets/pcm-worklet.js"
click node_speaker_logic "https://github.com/egamijun/ai-giziroku/blob/main/lib/speakers.ts"
click node_meetings_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/route.ts"
click node_meeting_id_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/%5Bid%5D/route.ts"
click node_meeting_end_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/%5Bid%5D/end/route.ts"
click node_transcripts_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/transcripts/route.ts"
click node_transcript_id_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/transcripts/%5Bid%5D/route.ts"
click node_feedback_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/claude/feedback/route.ts"
click node_summary_api "https://github.com/egamijun/ai-giziroku/blob/main/app/api/claude/summary/route.ts"
click node_role_prompts "https://github.com/egamijun/ai-giziroku/blob/main/lib/roles.ts"
click node_claude_client "https://github.com/egamijun/ai-giziroku/blob/main/lib/claude.ts"
click node_prisma_client "https://github.com/egamijun/ai-giziroku/blob/main/lib/prisma.ts"
click node_database "https://github.com/egamijun/ai-giziroku/blob/main/prisma/schema.prisma"

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_meeting_list,node_meeting_card,node_meeting_setup,node_recording_ui,node_meeting_detail,node_transcript_view,node_speaker_controls,node_feedback_tabs,node_summary_poller,node_operator toneBlue
class node_audio_input,node_recognition,node_pcm_worklet,node_speaker_logic toneAmber
class node_meetings_api,node_meeting_id_api,node_meeting_end_api,node_transcripts_api,node_transcript_id_api,node_feedback_api,node_summary_api,node_anthropic_service toneMint
class node_role_prompts,node_claude_client toneRose
class node_prisma_client,node_database,node_amivoice_service toneIndigo
```

## Components

### Meeting workflow UI

- [Meeting list](https://github.com/egamijun/ai-giziroku/blob/main/app/page.tsx): `app/page.tsx`
- [Meeting card](https://github.com/egamijun/ai-giziroku/blob/main/app/meeting-card.tsx): `app/meeting-card.tsx`
- [Meeting setup](https://github.com/egamijun/ai-giziroku/blob/main/app/new/page.tsx): `app/new/page.tsx`
- [Recording screen](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/recording/page.tsx): `app/[id]/recording/page.tsx`
- [Meeting detail](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/page.tsx): `app/[id]/page.tsx`
- [Transcript editor](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/transcript-list.tsx): `app/[id]/transcript-list.tsx`
- [Speaker controls](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/speakers-ui.tsx): `app/[id]/speakers-ui.tsx`
- [Role feedback tabs](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/role-feedback-tabs.tsx): `app/[id]/role-feedback-tabs.tsx`
- [Summary status poller](https://github.com/egamijun/ai-giziroku/blob/main/app/%5Bid%5D/summary-status-poller.tsx): `app/[id]/summary-status-poller.tsx`

### Speech and speakers

- **Microphone and loopback**
- [AmiVoice recognizer](https://github.com/egamijun/ai-giziroku/blob/main/lib/amivoice/client.ts): `lib/amivoice/client.ts`
- [PCM audio worklet](https://github.com/egamijun/ai-giziroku/blob/main/public/worklets/pcm-worklet.js): `public/worklets/pcm-worklet.js`
- [Speaker mapping](https://github.com/egamijun/ai-giziroku/blob/main/lib/speakers.ts): `lib/speakers.ts`

### Meeting APIs

- [Meeting routes](https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/route.ts): `app/api/meetings/route.ts`
- [Meeting detail routes](https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/%5Bid%5D/route.ts): `app/api/meetings/[id]/route.ts`
- [Meeting end route](https://github.com/egamijun/ai-giziroku/blob/main/app/api/meetings/%5Bid%5D/end/route.ts): `app/api/meetings/[id]/end/route.ts`
- [Transcript routes](https://github.com/egamijun/ai-giziroku/blob/main/app/api/transcripts/route.ts): `app/api/transcripts/route.ts`
- [Transcript edit route](https://github.com/egamijun/ai-giziroku/blob/main/app/api/transcripts/%5Bid%5D/route.ts): `app/api/transcripts/[id]/route.ts`
- [Feedback route](https://github.com/egamijun/ai-giziroku/blob/main/app/api/claude/feedback/route.ts): `app/api/claude/feedback/route.ts`
- [Summary route](https://github.com/egamijun/ai-giziroku/blob/main/app/api/claude/summary/route.ts): `app/api/claude/summary/route.ts`

### AI services

- [Role prompt logic](https://github.com/egamijun/ai-giziroku/blob/main/lib/roles.ts): `lib/roles.ts`
- [Claude service](https://github.com/egamijun/ai-giziroku/blob/main/lib/claude.ts): `lib/claude.ts`

### Persistence

- [Prisma client](https://github.com/egamijun/ai-giziroku/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [Meeting database](https://github.com/egamijun/ai-giziroku/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **Meeting user**
- **AmiVoice Cloud**
- **Anthropic API**

## Connections

- Meeting user → Meeting list: opens (evidence: `README.md`)
- Meeting list → Meeting card: renders (evidence: `app/page.tsx`)
- Meeting user → Meeting setup: starts meeting (evidence: `README.md`)
- Meeting setup → Meeting routes: creates meeting (evidence: `README.md`)
- Meeting routes → Prisma client: creates record (evidence: `app/api/meetings/route.ts`)
- Meeting list → Prisma client: loads meetings (evidence: `app/page.tsx`)
- Meeting user → Recording screen: records meeting (evidence: `README.md`)
- Microphone and loopback → AmiVoice recognizer: supplies audio (evidence: `lib/amivoice/client.ts`)
- AmiVoice recognizer → AmiVoice Cloud: streams audio (evidence: `lib/amivoice/client.ts`)
- AmiVoice recognizer → PCM audio worklet: processes audio (evidence: `lib/amivoice/client.ts`)
- AmiVoice recognizer → Speaker mapping: maps diarization (evidence: `lib/amivoice/client.ts`)
- Recording screen → AmiVoice recognizer: starts recognizers (evidence: `app/[id]/recording/page.tsx`)
- Recording screen → Transcript routes: saves utterances (evidence: `app/[id]/recording/page.tsx`)
- Transcript routes → Prisma client: stores transcript (evidence: `app/api/transcripts/route.ts`)
- Recording screen → Feedback route: requests feedback (evidence: `README.md`)
- Feedback route → Claude service: requests feedback (evidence: `app/api/claude/feedback/route.ts`)
- Feedback route → Role prompt logic: parses roles (evidence: `app/api/claude/feedback/route.ts`)
- Claude service → Role prompt logic: builds prompts (evidence: `lib/claude.ts`)
- Claude service → Anthropic API: sends prompts (evidence: `lib/claude.ts`)
- Feedback route → Prisma client: reads and saves (evidence: `app/api/claude/feedback/route.ts`)
- Recording screen → Meeting detail routes: renames speakers (evidence: `app/[id]/recording/page.tsx`)
- Transcript editor → Speaker controls: renders controls (evidence: `app/[id]/transcript-list.tsx`)
- Transcript editor → Transcript edit route: reassigns speaker (evidence: `README.md`)
- Meeting detail → Transcript editor: renders log (evidence: `app/[id]/page.tsx`)
- Meeting detail → Role feedback tabs: renders feedback (evidence: `app/[id]/page.tsx`)
- Recording screen → Role feedback tabs: shows feedback (evidence: `app/[id]/recording/page.tsx`)
- Meeting user → Summary route: ends and generates (evidence: `README.md`)
- Summary route → Claude service: requests summary (evidence: `app/api/claude/summary/route.ts`)
- Summary route → Role prompt logic: parses roles (evidence: `app/api/claude/summary/route.ts`)
- Summary route → Prisma client: loads and updates (evidence: `app/api/claude/summary/route.ts`)
- Meeting detail → Summary status poller: polls status (evidence: `app/[id]/page.tsx`)
- Meeting detail → Prisma client: loads meeting (evidence: `app/[id]/page.tsx`)
- Meeting end route → Prisma client: ends meeting (evidence: `app/api/meetings/[id]/end/route.ts`)
- Meeting detail routes → Prisma client: reads and updates (evidence: `app/api/meetings/[id]/route.ts`)
- Transcript edit route → Prisma client: updates transcript (evidence: `app/api/transcripts/[id]/route.ts`)
- Prisma client → Meeting database: queries data
