# channcissp-dot/talk2jira architecture

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

- Interactive diagram: https://gitdiagram.com/channcissp-dot/talk2jira
- Repository: https://github.com/channcissp-dot/talk2jira

## Overview

VoiceToJira is a browser-based prototype that turns a selected stand-up transcript into Jira-update drafts for human approval. Its main workflow is transcript selection, AI extraction (or a clearly labeled recorded-example fallback), evidence-backed review, and—only after approval—updates to an in-memory mock Jira board with an audit log. The README documents these capabilities, but no source excerpts were available; internal wiring beyond those documented relationships is omitted. All runtime components point to the sole source file, index.html.

Main entry points: [`index.html`](https://github.com/channcissp-dot/talk2jira/blob/main/index.html) (Run coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Interaction"]
  node_app["Browser app<br/>[index.html]"]
  node_transcripts["Transcript picker<br/>[index.html]"]
end

subgraph group_extraction["Draft extraction"]
  node_runtime["Run coordinator<br/>[index.html]"]
  node_ai["Live AI"]
  node_canned["Recorded examples<br/>[index.html]"]
  node_drafts["Draft extraction<br/>[index.html]"]
end

subgraph group_approval["Review and outcomes"]
  node_review["Evidence review<br/>[index.html]"]
  node_decision["Approve, edit, reject<br/>[index.html]"]
  node_board[("Mock Jira board<br/>[index.html]")]
  node_audit["Audit log<br/>[index.html]"]
end

node_user(("Reviewer"))

node_user -->|"uses"| node_app
node_user -->|"selects transcript"| node_transcripts
node_transcripts -->|"runs extraction"| node_runtime
node_runtime -.->|"requests extraction"| node_ai
node_runtime -.->|"uses fallback"| node_canned
node_runtime -->|"produces drafts"| node_drafts
node_drafts -->|"shows evidence"| node_review
node_user -->|"reviews drafts"| node_decision
node_decision -->|"applies approved edits"| node_board
node_decision -->|"records decision"| node_audit

click node_app "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_transcripts "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_runtime "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_canned "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_drafts "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_review "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_decision "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_board "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"
click node_audit "https://github.com/channcissp-dot/talk2jira/blob/main/index.html"

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_transcripts,node_user toneBlue
class node_runtime,node_ai,node_canned,node_drafts toneAmber
class node_review,node_decision,node_board,node_audit toneMint
```

## Components

### Interaction

- [Browser app](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- [Transcript picker](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`

### Draft extraction

- [Run coordinator](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- **Live AI**
- [Recorded examples](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- [Draft extraction](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`

### Review and outcomes

- [Evidence review](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- [Approve, edit, reject](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- [Mock Jira board](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`
- [Audit log](https://github.com/channcissp-dot/talk2jira/blob/main/index.html): `index.html`

### Other components

- **Reviewer**

## Connections

- Reviewer → Browser app: uses
- Reviewer → Transcript picker: selects transcript
- Transcript picker → Run coordinator: runs extraction
- Run coordinator → Live AI: requests extraction
- Run coordinator → Recorded examples: uses fallback
- Run coordinator → Draft extraction: produces drafts
- Draft extraction → Evidence review: shows evidence
- Reviewer → Approve, edit, reject: reviews drafts
- Approve, edit, reject → Mock Jira board: applies approved edits
- Approve, edit, reject → Audit log: records decision