# anandreddy1986/po-daily-fs-digest architecture

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

- Interactive diagram: https://gitdiagram.com/anandreddy1986/po-daily-fs-digest
- Repository: https://github.com/anandreddy1986/po-daily-fs-digest

## Overview

This repository automates Jira-based status reporting for four RHEL File System teams. The main workflow queries issues, applies CVE and grouping rules, renders an HTML digest, and sends it by email; cron and a SessionStart hook provide scheduled and catch-up runs. Separate scripts generate executive and FS-Net health reports, while another sends the project-summary PDF. The report scripts contain their own Jira clients and analysis/rendering logic. README documents several capabilities whose implementation details were not sampled, so those links are shown as documented rather than inferred code calls.

Main entry points: [`daily_po_report.py`](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py) (Digest Runner), [`fs_teams_executive_health_report.py`](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_teams_executive_health_report.py) (Executive Health Report), [`fs_net_health_sample.py`](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_net_health_sample.py) (FS-Net Health Report), [`send_project_summary.py`](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/send_project_summary.py) (Summary Emailer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_digest["Daily Digest"]
  node_daily["Digest Runner<br/>[daily_po_report.py]"]
  node_digest_query["Jira Query Client<br/>[daily_po_report.py]"]
  node_digest_logic["Filters &amp; Grouping<br/>[daily_po_report.py]"]
  node_digest_html["HTML Digest<br/>[daily_po_report.py]"]
end

subgraph group_health["Team Health"]
  node_executive["Executive Health Report"]
  node_fsnet["FS-Net Health Report"]
end

subgraph group_delivery["Delivery"]
  node_scheduler["Cron / Hook"]
  node_smtp["SMTP Server"]
end

subgraph group_project_mail["Project Summary"]
  node_summary_mailer["Summary Emailer"]
end

node_owner(("Product Owner"))
node_jira["Jira REST API"]

node_scheduler -->|"runs"| node_daily
node_daily -->|"queries"| node_digest_query
node_digest_query -->|"searches"| node_jira
node_daily -->|"filters and groups"| node_digest_logic
node_daily -->|"renders"| node_digest_html
node_daily -->|"sends email"| node_smtp
node_owner -->|"receives"| node_digest_html
node_executive -->|"searches"| node_jira
node_executive -->|"generates health report"| node_owner
node_fsnet -->|"searches"| node_jira
node_fsnet -->|"generates health report"| node_owner
node_summary_mailer -->|"sends email"| node_smtp

click node_daily "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py"
click node_digest_query "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py"
click node_digest_logic "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py"
click node_digest_html "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py"
click node_executive "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_teams_executive_health_report.py"
click node_fsnet "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_net_health_sample.py"
click node_summary_mailer "https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/send_project_summary.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_daily,node_digest_query,node_digest_logic,node_digest_html toneBlue
class node_executive,node_fsnet toneAmber
class node_scheduler,node_smtp,node_jira toneMint
class node_summary_mailer toneRose
class node_owner toneIndigo
```

## Components

### Daily Digest

- [Digest Runner](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py): `daily_po_report.py`
- [Jira Query Client](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py): `daily_po_report.py`
- [Filters & Grouping](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py): `daily_po_report.py`
- [HTML Digest](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/daily_po_report.py): `daily_po_report.py`

### Team Health

- [Executive Health Report](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_teams_executive_health_report.py): `fs_teams_executive_health_report.py`
- [FS-Net Health Report](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/fs_net_health_sample.py): `fs_net_health_sample.py`

### Delivery

- **Cron / Hook**
- **SMTP Server**

### Project Summary

- [Summary Emailer](https://github.com/anandreddy1986/po-daily-fs-digest/blob/main/send_project_summary.py): `send_project_summary.py`

### Other components

- **Product Owner**
- **Jira REST API**

## Connections

- Cron / Hook → Digest Runner: runs (evidence: `README.md`)
- Digest Runner → Jira Query Client: queries (evidence: `daily_po_report.py`)
- Jira Query Client → Jira REST API: searches (evidence: `daily_po_report.py`)
- Digest Runner → Filters & Grouping: filters and groups (evidence: `README.md`)
- Digest Runner → HTML Digest: renders (evidence: `README.md`)
- Digest Runner → SMTP Server: sends email (evidence: `README.md`)
- Product Owner → HTML Digest: receives (evidence: `README.md`)
- Executive Health Report → Jira REST API: searches (evidence: `fs_teams_executive_health_report.py`)
- Executive Health Report → Product Owner: generates health report (evidence: `fs_teams_executive_health_report.py`)
- FS-Net Health Report → Jira REST API: searches (evidence: `fs_net_health_sample.py`)
- FS-Net Health Report → Product Owner: generates health report (evidence: `fs_net_health_sample.py`)
- Summary Emailer → SMTP Server: sends email (evidence: `send_project_summary.py`)
