Afritic Open Farming Standard

User Tools

Site Tools

You are here: Afritic Open Water and Farming Standard (AOWFS) » System Architecture Overview
Trace: • AOFS Change Log & Versioning • System Architecture Overview • Farm Controller Layer (Local / Federated) • Valves, Pumps & Actuation • Water Towers
architecture:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
architecture:start [2026/01/21 21:02] – bsamuelarchitecture:start [2026/02/23 01:11] (current) – [8. References] bsamuel
Line 22: Line 22:
 <code> <code>
                 ┌───────────────────────┐                 ┌───────────────────────┐
-                │   HQ / Federated       │ +                │   HQ / Federated      │ 
-                │      Controller        │ +                │      Controller       │ 
-                │  Dashboards & Reports  │+                │  Dashboards & Reports │
                 └─────────┬─────────────┘                 └─────────┬─────────────┘
                           │ Push/Pull Config & Logs                           │ Push/Pull Config & Logs
Line 45: Line 45:
 **Legend:** **Legend:**
  
-- **Field Controller:** authoritative for safety-critical irrigation.   +  * **Field Controller:** authoritative for safety-critical irrigation.   
-- **Farm Controller:** local supervision, configuration, and federation; respects Field Controller authority.   +  * **Farm Controller:** local supervision, configuration, and federation; respects Field Controller authority.   
-- **HQ Controller:** multi-farm oversight, reporting, analytics; may propose updates but cannot override Field Controller safety logic.  +  * **HQ Controller:** multi-farm oversight, reporting, analytics; may propose updates but cannot override Field Controller safety logic.  
  
 --- ---
Line 63: Line 63:
 ===== 4. Federation / Sync Model ===== ===== 4. Federation / Sync Model =====
  
-* **Push/Pull:** Farm Controllers sync with HQ and/or peer farms.   +  * **Push/Pull:** Farm Controllers sync with HQ and/or peer farms.   
-* **Conflict Resolution:**   +  * **Conflict Resolution:**   
-  - Timestamp precedence   +    * Timestamp precedence   
-  - Operator approval for schedule/config conflicts   +    * Operator approval for schedule/config conflicts   
-  - Field Controller safety rules **always take priority**   +    * Field Controller safety rules **always take priority**   
-* **Offline First:**   +  * **Offline First:**   
-  - Controllers continue autonomous operation if disconnected   +    * Controllers continue autonomous operation if disconnected   
-  - Logs and changes queue for synchronization once connectivity is restored  +    * Logs and changes queue for synchronization once connectivity is restored  
  
 --- ---
Line 76: Line 76:
 ===== 5. Human Interface Rules ===== ===== 5. Human Interface Rules =====
  
-* All controllers expose interfaces appropriate to their role:   +  * All controllers expose interfaces appropriate to their role:   
-  - Field Controller: embedded status UI, safety alerts, non-critical operator overrides   +    * Field Controller: embedded status UI, safety alerts, non-critical operator overrides   
-  - Farm Controller: full local UI for monitoring, configuration, and federation   +    * Farm Controller: full local UI for monitoring, configuration, and federation   
-  - HQ Controller: multi-farm dashboards, analytics, authorized configuration proposals   +    * HQ Controller: multi-farm dashboards, analytics, authorized configuration proposals   
-* No interface may bypass Field Controller safety rules.  +  * No interface may bypass Field Controller safety rules.  
  
 --- ---
  
-===== 6. Compliance Notes =====+===== 6. Communication Model & Protocol Independence =====
  
-* AOFS-compliant deployments **must implement all three layers** as defined.   +  * Controller layers may communicate using one or more standardized protocols (see [[architecture:protocols:start|Communication Protocols & Standards]]) 
-* Field Controller safety rules **cannot be overridden** by higher layers.   +  * Protocol choice does not define authority 
-* All push/pull, configuration changes, and operator actions **must be logged**.   +  * Communication transport is strictly separated from control authority 
-* Offline operation **must not compromise irrigation or safety**.   + 
-* Failure to respect authority boundaries **invalidates AOFS compliance**.+  * Field Controller authority is defined by architectural rules, not by message origin 
 +  * Remote commands received via MQTT, AMQP, or other protocols must always be validated locally 
 +  * Loss of connectivity must never affect safety-critical irrigation execution 
 +  * Communication failure must default to safe autonomous operation 
 + 
 +  * AOFS architecture is protocol-agnostic 
 +  * Multiple protocols may coexist within a deployment 
 +  * Implementations must ensure auditability of all received and transmitted messages 
 + 
 +--- 
 +===== 7. Compliance Notes ===== 
 + 
 +  * AOFS-compliant deployments **must implement all three layers** as defined.   
 +  * Field Controller safety rules **cannot be overridden** by higher layers.   
 +  * All push/pull, configuration changes, and operator actions **must be logged**.   
 +  * Offline operation **must not compromise irrigation or safety**.   
 +  * Failure to respect authority boundaries **invalidates AOFS compliance**.
  
 --- ---
  
-===== 7. References =====+===== 8. References =====
  
-* [[architecture:field_controller:start|Field Controller Layer]]   +  * [[architecture:field_controller:start|Field Controller Layer]]   
-* [[architecture:farm_controller:start|Farm Controller Layer (Local / Federated)]]   +  * [[architecture:farm_controller:start|Farm Controller Layer (Local / Federated)]]   
-* [[architecture:hq_controller:start|HQ / Federated Controller Layer]]   +  * [[architecture:hq_controller:start|HQ / Federated Controller Layer]]   
-* [[hydraulics|Hydraulic & Water Systems]]   +  * [[hydraulics:start]]   
-* [[electrical|Electrical & Control Interfaces]]   +  * [[electrical|Electrical & Control Interfaces]]   
-* [[sensors|Measuring, Monitoring & Documentation Systems]]  +  * [[sensors|Measuring, Monitoring & Documentation Systems]]  
  
architecture/start.1769029361.txt.gz · Last modified: by bsamuel

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki