Project Guide | Operations Reliability and Data Governance…

Live Demo

Open the public GitHub Pages demo
Scope: credential-free demonstration with synthetic data.

A Streamlit platform that combines operational reliability, data governance, incident review, and AI-ready narrative generation in one deployable system.

Private Workshop or Pilot

Open the central private inquiry form for an operations reliability workshop or scoped pilot.
Revenue architecture defines the free-to-paid boundary, first deliverable, and trust guardrails.
Machine-readable service offer records the same commercial route for automated discovery.

Use the form for initial scoping only. Do not submit credentials, regulated data, raw incident logs, or other confidential material.

System Overview

An operations reliability desk that packages incident logs, signed bundles, and optional AI assist into a repeatable review loop.

Area	Details
Users	Operations managers, SRE/IT teams, managed service teams, and internal reliability owners.
Technical path	Validate the demo, README, architecture notes, and quality gate before deeper workflow review.
System scope	Signed review bundles, staged incident-log visibility, optional AI assist, and operations handoff framing.
Operating boundary	Synthetic/staged data by default; production use needs access control, retention policy, and approval workflows.
Evaluation path	Run the local checks, generate a signed bundle, and inspect the staged incident evidence.

Evaluation Path

Start here: Review command center, incident review, signed bundle export, and AI assist fallback.
Local demo: Run make install && make run, then open the Streamlit app at its printed local URL.
Checks: Run make verify, then make export-review and make export-bundle for handoff artifacts.

Technical Notes

Technical guide summarizes the system scope, first files to inspect, verification commands, and known boundaries.
Quality notes lists the local checks, CI surface, and release expectations for this repository.
Enterprise readiness notes outlines security, data, operations, integration, and handoff expectations.

Key Surfaces

Command Center: service health, risk scatter, ownership focus
Incident Review: incident narratives, evidence trail, action list
Data Governance: contract health, freshness vs SLA, drift visibility
Release Readiness: gate-based decisioning with confidence
Review Pack: markdown/json exports for handoff and audit
Signed Bundle Export: zip bundle with manifest and SHA256 checksums
Trend Analysis: posture shifts across recent operational windows
Action Board: prioritized remediation queue for service and data owners
AI Assist: optional OpenAI-powered brief generation (deterministic fallback always available)

Architecture

flowchart LR
    A[Operational services] --> B[Scenario snapshot builder]
    C[Data contracts] --> B
    B --> D[Risk scoring engine]
    D --> E[Release gate computation]
    D --> F[Deterministic narrative engine]
    E --> G[Review pack export]
    F --> G
    G --> H[Streamlit command surfaces]

Quick Start

make install
make verify
source .venv/bin/activate
streamlit run streamlit_app.py

No external LLM API is required. The deterministic narrative engine handles all summaries by default. For optional OpenAI assist, set OPENAI_API_KEY in .streamlit/secrets.toml or as an environment variable.

Deployment

Streamlit Community Cloud

Entrypoint: streamlit_app.py
Python 3.12 recommended
pip install -r requirements.txt

Export examples:

source .venv/bin/activate
PYTHONPATH=. python -m scripts.export_review_pack --scenario pressure --format markdown
PYTHONPATH=. python -m scripts.export_review_bundle --scenario pressure

Project Structure

app/core/           scoring, narratives, sample data, exports, bundles, evidence, scorecards, llm
pages/              Streamlit multipage review surfaces
scripts/            CLI exports
tests/              unit tests for scoring, exports, narratives, bundles, actions, and llm setup
docs/               architecture and technical report

Cloud + AI Architecture

Cloud + AI architecture blueprint
Machine-readable architecture manifest
Validation command: python3 scripts/validate_architecture_blueprint.py

Enterprise Productization

Product operating model defines the product scope, trust boundary, operating checks, and service path for this repository.

Service Architecture

Service architecture defines the cloud resources, account information, cost controls, and production guardrails needed to turn this repo into a scoped service without publishing public financial assumptions.