Service Report Generator (SRG)

A Streamlit-based internal tool to generate standardized service reports with optional telemetry ingestion and PDF/DOCX export.

Quickstart (Local)

1. Create a virtual environment and install deps:

python -m venv .venv
. .venv/Scripts/activate  # Windows PowerShell: .venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Run the app:

streamlit run app/main.py

3. App will open in your browser at http://localhost:8501.

Project Layout

• app/main.py: Streamlit UI
• srg/: Core library (models, storage, telemetry, exporters)
• data/: Runtime storage (created on demand)
  • data/uploads/
  • data/reports/

Docker

Build and run:

docker build -t srg:dev .
docker run -p 8501:8501 -v %CD%/data:/app/data srg:dev  # Windows PowerShell

Notes

• Telemetry integration is stubbed for MVP. Upload a simple key-value log to prefill fields.
• Generated reports and uploaded images are saved under data/.