# wangw73066-byte/financial-report-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/wangw73066-byte/financial-report-dashboard
- Repository: https://github.com/wangw73066-byte/financial-report-dashboard

## Overview

This repository is a financial-report visualization skill, not an automated report-processing application: it guides an agent through sourcing, checking, and presenting listed-company results. The principal workflow runs from a user’s company details or report file, through official-source acquisition and PDF analysis, into financial validation and dashboard adaptation, then produces an offline ECharts dashboard from the bundled template. The README documents additional chart, responsive-layout, and visual-polish requirements. Internal wiring beyond the sampled scaffold script is not verified, so the graph represents documented workflow rather than inferred code calls.

Main entry points: [`SKILL.md`](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/SKILL.md) (Financial dashboard skill), [`assets/dashboard-template/app.js`](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/app.js) (Charts and financial views), [`assets/dashboard-template/index.html`](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/index.html) (Dashboard page), [`scripts/scaffold_dashboard.py`](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/scripts/scaffold_dashboard.py) (Template scaffold)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Report workflow"]
  node_skill["Financial dashboard skill<br/>[SKILL.md]"]
end

subgraph group_guidance["Analysis guidance"]
  node_source_rules["Source acquisition"]
  node_pdf_rules["PDF ingestion<br/>[pdf-ingestion.md]"]
  node_adapt_rules["Dashboard adaptation"]
  node_polish_rules["Visual polish<br/>[visual-polish.md]"]
end

subgraph group_dashboard["Dashboard product"]
  node_dashboard_html["Dashboard page<br/>[index.html]"]
  node_dashboard_app["Charts and financial views<br/>[app.js]"]
end

subgraph group_scaffold["Template creation"]
  node_scaffold_script["Template scaffold"]
end

node_user(("Report requester"))
node_official_sources(("Official report sources"))
node_report["Report PDF or data"]
node_output["Offline dashboard"]

node_user -->|"requests report view"| node_skill
node_skill -->|"follows sourcing rules"| node_source_rules
node_source_rules -.->|"locates latest filing"| node_official_sources
node_user -->|"provides report"| node_report
node_skill -->|"follows extraction rules"| node_pdf_rules
node_report -->|"provides source material"| node_pdf_rules
node_skill -->|"follows adaptation rules"| node_adapt_rules
node_pdf_rules -->|"supplies checked figures"| node_adapt_rules
node_skill -->|"applies visual guidance"| node_polish_rules
node_skill -->|"creates template copy"| node_scaffold_script
node_scaffold_script -->|"copies template"| node_dashboard_html
node_scaffold_script -->|"copies template"| node_dashboard_app
node_dashboard_html -->|"loads chart logic"| node_dashboard_app
node_adapt_rules -->|"defines dashboard data"| node_dashboard_app
node_polish_rules -->|"guides presentation"| node_dashboard_app
node_dashboard_html -->|"renders offline page"| node_output
node_dashboard_app -->|"renders financial views"| node_output

click node_skill "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/SKILL.md"
click node_source_rules "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/source-acquisition.md"
click node_pdf_rules "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/pdf-ingestion.md"
click node_adapt_rules "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/dashboard-adaptation.md"
click node_polish_rules "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/visual-polish.md"
click node_dashboard_html "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/index.html"
click node_dashboard_app "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/app.js"
click node_scaffold_script "https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/scripts/scaffold_dashboard.py"

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_skill toneBlue
class node_source_rules,node_pdf_rules,node_adapt_rules,node_polish_rules toneAmber
class node_dashboard_html,node_dashboard_app,node_user toneMint
class node_scaffold_script toneRose
class node_official_sources,node_report,node_output toneIndigo
```

## Components

### Report workflow

- [Financial dashboard skill](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/SKILL.md): `SKILL.md`

### Analysis guidance

- [Source acquisition](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/source-acquisition.md): `references/source-acquisition.md`
- [PDF ingestion](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/pdf-ingestion.md): `references/pdf-ingestion.md`
- [Dashboard adaptation](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/dashboard-adaptation.md): `references/dashboard-adaptation.md`
- [Visual polish](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/references/visual-polish.md): `references/visual-polish.md`

### Dashboard product

- [Dashboard page](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/index.html): `assets/dashboard-template/index.html`
- [Charts and financial views](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/assets/dashboard-template/app.js): `assets/dashboard-template/app.js`

### Template creation

- [Template scaffold](https://github.com/wangw73066-byte/financial-report-dashboard/blob/main/scripts/scaffold_dashboard.py): `scripts/scaffold_dashboard.py`

### Other components

- **Report requester**
- **Official report sources**
- **Report PDF or data**
- **Offline dashboard**

## Connections

- Report requester → Financial dashboard skill: requests report view
- Financial dashboard skill → Source acquisition: follows sourcing rules
- Source acquisition → Official report sources: locates latest filing
- Report requester → Report PDF or data: provides report
- Financial dashboard skill → PDF ingestion: follows extraction rules
- Report PDF or data → PDF ingestion: provides source material
- Financial dashboard skill → Dashboard adaptation: follows adaptation rules
- PDF ingestion → Dashboard adaptation: supplies checked figures
- Financial dashboard skill → Visual polish: applies visual guidance
- Financial dashboard skill → Template scaffold: creates template copy
- Template scaffold → Dashboard page: copies template
- Template scaffold → Charts and financial views: copies template
- Dashboard page → Charts and financial views: loads chart logic
- Dashboard adaptation → Charts and financial views: defines dashboard data
- Visual polish → Charts and financial views: guides presentation
- Dashboard page → Offline dashboard: renders offline page
- Charts and financial views → Offline dashboard: renders financial views