# ayhandemir7-lssbb/project3-research-and-report architecture

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

- Interactive diagram: https://gitdiagram.com/ayhandemir7-lssbb/project3-research-and-report
- Repository: https://github.com/ayhandemir7-lssbb/project3-research-and-report

## Overview

Fix My Process turns an employee’s process-friction report into an approved employee fix and a compliance-checked leadership use case. The employee submits through the Gradio form or chat; the UI sends requests to n8n, which performs research, checks internal policy and tools, writes both reports, then quality-checks and logs results. Status lookup and feedback, leadership hand-off and red-case governance, knowledge upload, and error handling are documented product branches. The n8n workflows are present in the tree but were not sampled, so workflow-level edges are documented or left unverified.

Main entry points: [`app.py`](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/app.py) (Gradio interface), [`n8n_workflows/Fix My Process_ main.json`](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json) (Research agent), [`n8n_workflows/Fix My Process - Error Handler.json`](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process%20-%20Error%20Handler.json) (Error handling), [`ui_style.py`](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/ui_style.py) (UI presentation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Employee experience"]
  node_ui["Gradio interface<br/>[app.py]"]
  node_ui_style["UI presentation<br/>[ui_style.py]"]
  node_status_feedback["Status and feedback"]
end

subgraph group_automation["Workflow automation"]
  node_intake["Request intake"]
end

subgraph group_research["Research and compliance"]
  node_research_agent["Research agent"]
  node_web_research["Web research tools"]
  node_internal_search["Internal knowledge search"]
end

subgraph group_delivery["Reports and governance"]
  node_report_writing["Report generation"]
  node_quality["Quality gate"]
  node_airtable[("Case records")]
  node_employee_reply["Employee response"]
  node_notion["Leadership report"]
  node_slack["Governance notifications"]
end

subgraph group_knowledge["Knowledge and operations"]
  node_knowledge_upload["Knowledge upload"]
  node_pinecone[("Knowledge index")]
  node_error_handler["Error handling"]
end

node_employee(("Employee"))
node_board(("Governance board"))

node_employee -->|"submits problem"| node_ui
node_ui -->|"renders interface"| node_ui_style
node_ui -->|"posts requests"| node_intake
node_intake -.->|"starts research"| node_research_agent
node_research_agent -.->|"queries web"| node_web_research
node_research_agent -.->|"searches knowledge"| node_internal_search
node_research_agent -.->|"supplies findings"| node_report_writing
node_report_writing -.->|"submits reports"| node_quality
node_quality -.->|"logs case"| node_airtable
node_quality -.->|"returns report"| node_employee_reply
node_employee_reply -->|"returns result"| node_ui
node_ui -->|"requests status and feedback"| node_status_feedback
node_status_feedback -.->|"reads and updates"| node_airtable
node_report_writing -.->|"creates report page"| node_notion
node_report_writing -.->|"notifies governance"| node_slack
node_slack -.->|"requests red-case decision"| node_board
node_board -.->|"saves decision"| node_airtable
node_knowledge_upload -.->|"stores embeddings"| node_pinecone
node_error_handler -.->|"logs failures"| node_airtable
node_error_handler -.->|"sends alert"| node_slack

click node_ui "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/app.py"
click node_ui_style "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/ui_style.py"
click node_intake "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_research_agent "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_web_research "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_internal_search "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_report_writing "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_quality "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_employee_reply "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_status_feedback "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_knowledge_upload "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json"
click node_error_handler "https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process%20-%20Error%20Handler.json"

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_ui,node_ui_style,node_status_feedback toneBlue
class node_intake toneAmber
class node_research_agent,node_web_research,node_internal_search toneMint
class node_report_writing,node_quality,node_airtable,node_employee_reply,node_notion,node_slack toneRose
class node_knowledge_upload,node_pinecone,node_error_handler,node_employee,node_board toneIndigo
```

## Components

### Employee experience

- [Gradio interface](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/app.py): `app.py`
- [UI presentation](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/ui_style.py): `ui_style.py`
- [Status and feedback](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`

### Workflow automation

- [Request intake](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`

### Research and compliance

- [Research agent](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- [Web research tools](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- [Internal knowledge search](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`

### Reports and governance

- [Report generation](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- [Quality gate](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- **Case records**
- [Employee response](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- **Leadership report**
- **Governance notifications**

### Knowledge and operations

- [Knowledge upload](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process_%20main.json): `n8n_workflows/Fix My Process_ main.json`
- **Knowledge index**
- [Error handling](https://github.com/ayhandemir7-lssbb/project3-research-and-report/blob/main/n8n_workflows/Fix%20My%20Process%20-%20Error%20Handler.json): `n8n_workflows/Fix My Process - Error Handler.json`

### Other components

- **Employee**
- **Governance board**

## Connections

- Employee → Gradio interface: submits problem (evidence: `README.md`)
- Gradio interface → UI presentation: renders interface (evidence: `app.py`)
- Gradio interface → Request intake: posts requests (evidence: `app.py`)
- Request intake → Research agent: starts research
- Research agent → Web research tools: queries web (evidence: `README.md`)
- Research agent → Internal knowledge search: searches knowledge (evidence: `README.md`)
- Research agent → Report generation: supplies findings (evidence: `README.md`)
- Report generation → Quality gate: submits reports (evidence: `README.md`)
- Quality gate → Case records: logs case (evidence: `README.md`)
- Quality gate → Employee response: returns report (evidence: `README.md`)
- Employee response → Gradio interface: returns result (evidence: `app.py`)
- Gradio interface → Status and feedback: requests status and feedback (evidence: `app.py`)
- Status and feedback → Case records: reads and updates (evidence: `README.md`)
- Report generation → Leadership report: creates report page (evidence: `README.md`)
- Report generation → Governance notifications: notifies governance (evidence: `README.md`)
- Governance notifications → Governance board: requests red-case decision (evidence: `README.md`)
- Governance board → Case records: saves decision (evidence: `README.md`)
- Knowledge upload → Knowledge index: stores embeddings (evidence: `README.md`)
- Error handling → Case records: logs failures (evidence: `README.md`)
- Error handling → Governance notifications: sends alert (evidence: `README.md`)
