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:04] – [2. Authority & Data Flow Diagram] bsamuelarchitecture:start [2026/02/23 01:11] (current) – [8. References] bsamuel
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 ===== 
 + 
 +  * Controller layers may communicate using one or more standardized protocols (see [[architecture:protocols:start|Communication Protocols & Standards]]) 
 +  * Protocol choice does not define authority 
 +  * Communication transport is strictly separated from control authority 
 + 
 +  * 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.     * AOFS-compliant deployments **must implement all three layers** as defined.  
Line 94: Line 110:
 --- ---
  
-===== 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.1769029442.txt.gz · Last modified: by bsamuel