Repository navigation
Architecture 12 Glossary
github-actions[bot] edited this page Oct 18, 2026
·
39 revisions
| Term | Meaning |
|---|---|
| Account | Household or business; data, rights and billing boundary |
| Sub-user | User created by an account, possibly without e-mail address |
| Role | Named bundle of single permissions |
| Permission | Single right such as mower.control
|
| Site | Location of an account with address, time zone and own map |
| Group | Collection of mowers, possibly across sites |
| Principal | The authenticated user or API token making a request |
| Gateway | Single entry point (Traefik) |
| Device-Gateway | Service that holds connections to mowers and bridges |
| Bridge | ESP32 on the mower that connects Bluetooth with WLAN |
| PyMammotion | Python library speaking the Mammotion protocol |
| RTK | Real-time kinematic positioning for centimeter accuracy |
| Network RTK | Correction data delivered over 4G instead of an own station |
| OpenFGA | Open source relationship-based authorization service (Zanzibar model) |
| JetStream | Persistence layer of NATS |
| JWT / JWKS | Signed token / published set of public keys to verify it |
| Entitlement | Statement what an account may do under its plan |
| Mowing pattern | Plug-in that turns an area and settings into a route |
| Spot mowing | Mowing a user-drawn area of arbitrary shape |
| ADR | Architecture decision record |
| arc42 | Template for architecture documentation |
| C4 | Context, container, component, code: diagram levels |
| PWA | Progressive web app, installable from the browser |
| HACS | Home Assistant Community Store |
| Gate | Release criterion at the end of a phase |
Mirrored from docs/architecture/12-glossary.md at commit 2c95bd2e71e632d0ce48646e30681257807fac8c. Edit the file in the repository, not this wiki page.
Mirrored from the docs/ directory at commit 2c95bd2e71e632d0ce48646e30681257807fac8c. Edit the files in the repository, not this wiki.
MowDeck documentation
- Home
- Phases
- Architecture
-
Decisions (ADR)
- Architecture decisions
- ADR 0001: OpenFGA instead of self-built authorization
- ADR 0002: Self-built Identity service in FastAPI instead of Keycloak or Zitadel
- ADR 0003: SvelteKit for the web app
- ADR 0004: Monorepo with a uv workspace
- ADR 0005: AGPL-3.0 for services and apps, Apache-2.0 for libraries
- ADR 0006: PostgreSQL for all persistence, no SQLite
- ADR 0007: NATS JetStream as event bus
- ADR 0008: Traefik as gateway
- ADR 0009: Command and event envelopes, subject naming and de-duplication
- ADR 0010: Python 3.13 for all services and libraries
- ADR 0011: Separate GPL-3.0 package for the PyMammotion adapter
- ADR 0012: Mower control interface and safety rules
- ADR 0013: Device-Gateway registry, sharding and per-mower concurrency
- ADR 0014: Authorization model, tuple ownership and the mowdeck-authz client
- ADR 0015: Tokens, sessions and key rotation
- ADR 0016: Fleet commands and authorization per command kind
- ADR 0017: Telemetry storage and retention
- ADR 0018: Realtime WebSocket protocol
- ADR 0019: Mammotion adapter transports, manual drive and secrets
- ADR 0020: Web app architecture
- ADR 0021: Browser authentication flow
- ADR 0022: Notifications: rules, recipients and delivery
- ADR 0023: Map rendering and projection
- ADR 0024: Scheduler: recurrence, rain pause and command issuing
- ADR 0025: Home Assistant integration as a pure API client
- ADR 0026: Manual drive channel over the Realtime WebSocket
- ADR 0027: Health history and theft alarm
- ADR 0028: Entitlements: plans as data and enforcement
- ADR 0029: Helm chart and release pipeline
- ADR 0030: Mowing patterns as plug-ins and the Planner
- ADR 0031: Billing with a Stripe adapter
- ADR 0032: Live camera over Agora, joined directly by the browser
- ADR 0033: Vision-assisted recovery with human approval
- ADR 0034: Linked cloud accounts and device discovery
- ADR 0035: Server-side camera frames and automatic AI analysis on errors
- ADR 0036: Native app shells with Capacitor, loading the web app from the server
- ADR 0037: Camera panorama calibration in the browser, with the AI supplying points only
- ADR 0038: Dual link per mower and firmware updates
- ADR 0039: Spot mowing by MowDeck-driven paths
- ADR 0040: Link heartbeat for online status
- ADR 0041: Spot runs from the dock: undock, transit and return
- ADR 0042: Drive calibration
- ADR 0043: Turn styles
- ADR 0044: Drive view with camera
- ADR 0045: Camera relay
- Development
- Operations
- Spikes
- Guides
- Original plan (German)