MainsKeeper Product & System Guide Edition 0.2.3

Edition · 0.2.3

MainsKeeper — Product & System Guide

How MainsKeeper watches UPS fleets and site connectivity across places like Broadwater, Home, Shop, and Duplex — for stakeholders and engineers, with Accepted, Proposed, and Open labelled clearly.

Start reading Decision register Diagram gallery

How to read status labels

Later correction sections in the app handoff take precedence over older text. This guide separates commitment from design exploration.

Accepted Frozen product behavior from the design contract.

Proposed Designed but not a production commitment (including wire schemas).

Open Explicitly unresolved — do not treat diagrams as decisions.

Recommendation Sensible option offered here; not a handoff commitment.

Path A

Stakeholder reading path

  1. 01
    Product & purpose
    Problem, sites, outcomes vs backup evidence
  2. 02
    Deployment patterns
    How collectors sit next to UPS hardware
  3. 07
    Battery Assurance
    Evidence, installations, protection findings
  4. 08
    Implementation & decisions
    Sequence, open choices, cost drivers
  5. 09
    Broadwater outage walkthrough
    One synthetic utility, WAN, and replay story
  6. ✓
    Broadwater pilot checklist
    Recommended first-site checks, not a release gate

Path B

Engineer reading path

  1. 03
    System responsibilities
    Components, ownership, ends-here
  2. 04
    Information, evidence, uncertainty
    Domain model, time, gaps, honesty rules
  3. 05
    Interfaces & contracts
    Boundaries, examples, monitoring-only
  4. 09
    Broadwater outage walkthrough
    What was known before and after replay
  5. 06
    Deployment & monitoring choices
    Standalone scrape vs centralized platform

Full contents

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 08
  9. —

Deliverable map

Declared checkpoint targets for this edition.

Scope. The attached app archive is a static prototype and design reference. Its fixture code and localStorage persistence are not a production backend. This guide explains the product and system design; it does not ship installers, firmware, or a live API.