6.5 KiB
6.5 KiB
Blocao · Wiki
This is the human-friendly entry point to the WDM repository. Start here if you want context before diving into specific files.
Where everything lives
Status snapshot
Phase: design (no production code yet).
Mockups available:
- Operator console (SYNOPSIS, CAMS, FRIGATE, GITOPS, MQTT, HEALTH, FORENSICS, setup wizard, camera onboarding).
- Audio transcript forensics panel.
Decisions taken: 10 ADRs (see decisions/).
Sprint plan: 8 epics, ~19 weeks to first MVP demo.
Next milestone: close Sprint 0 (foundation) before any UI work begins.
How to contribute
- Design discussion → open an issue tagged
discussionand link to relevant decision/doc. - New ADR → propose in an issue, agree, then PR with the ADR file numbered next in sequence.
- Backlog grooming → comment on individual story issues. Story IDs are
BL-XX.Yfor Blocao andWDM-T-XX.Yfor transcript-specific. - Mockup iteration → branch from
main, modify the relevantmockups/*.html, PR with screenshots. - Documentation → keep prose tight, prefer tables over bullet lists when comparing things, link liberally to other docs.
Avoid:
- Editing accepted ADRs. Supersede with a new number instead.
- Adding new mockup files for minor variations of existing ones — branch and edit.
- Putting code in this repo. Code lives in companion repositories (when those exist).
Glossary (extended)
For the short version see the README. Extended terms:
| Term | Meaning |
|---|---|
| Bridge | The mosquitto-to-mosquitto MQTT connection between site router and hub. Selectively configured to enforce sovereignty. |
| Drift | When the live config on disk diverges from what the GitOps repo says it should be. |
| Edge AI | AI inference running on-site (Cell or Core), not in cloud. |
| Enricher | Service that consumes detection events and adds embeddings, hashes, re-ID vectors. |
| Evidence pack | An exportable bundle of clips + manifests + custody log for a case. |
| Fleet token | Single-use token issued by the hub during enrollment of a new site. |
| Frigate | Open-source NVR + edge AI engine. The first edge AI integrated. |
| HAI | Internal abbreviation for "Hardware AI". Now mostly replaced by "edge AI" in customer-facing copy. |
| Quarantine VLAN | The cameras VLAN (default VLAN-10) with zero internet egress. |
| Reconcile | The router's process of fetching latest GitOps config and applying differences. |
| Selftest | The 5-minute periodic health check ran by healthd. |
| SP-A / SP-B / SP-C | Speaker labels used in transcript forensics when speakers haven't been identified by voiceprint. |
| Voiceprint | Speaker embedding stored in the speaker library, used to identify speakers in new sessions. |
Why "WDM"
WDM = Watch · Detect · Manage. The three operations the platform performs at every site, in that order:
- Watch — capture video and audio streams.
- Detect — run edge AI to extract events, embeddings, transcripts.
- Manage — orchestrate the fleet, enforce sovereignty policies, surface insights to operators.
The product name remains Blocao. WDM is the internal name of the platform layer and this design repository.
Maintainers
- Design + product: Blocao Labs core team.
- This repo: documentation-first. Code repos will be linked when they exist.
For questions before contributing: open an issue, no need to ask permission.