AOWIS:Table of Contents

Overview of all AOWIS namespaces and their intended scope.

This document defines the high‑level structure of the AOWIS standard. Each namespace serves a specific purpose within the overall architecture.

---

Standard:

The normative core of AOWIS. Contains binding requirements, definitions, and compliance rules.

Pages in this namespace include:

• Scope of the standard
• Normative requirements (MUST/SHOULD/MAY)
• Definitions and terminology
• Safety rules
• Conformance levels
• Versioning and change control

---

Concepts:

Non‑normative explanations of the ideas behind AOWIS. Provides context, philosophy, and rationale.

Typical content:

• Design philosophy
• Human‑in‑the‑loop principles
• Offline‑first operation
• Real‑world constraints
• Paper‑based operation
• Shared infrastructure model

---

Architecture:

The structural blueprint of AOWIS. Describes how controllers, communication, and logic fit together.

Includes:

• System overview
• Field Controller architecture
• Farm Controller architecture
• HQ Controller architecture
• Communication model
• Data flow diagrams
• Security model
• State machines

---

Infrastructure:

Physical systems that AOWIS interacts with. Covers water, power, and mechanical components.

Topics include:

• Hydraulics
• Pumps and pump protection
• Valves and actuators
• Water towers and tanks
• Distribution networks
• Electrical systems
• Power constraints

---

Measurement:

All forms of measurement used by AOWIS, including sensors, manual readings, and derived values.

Sub‑topics:

• Electronic sensors (soil moisture, flow meters, tank levels, weather, optical, power)
• Manual measurements (dipsticks, visual inspection, paper forms)
• Derived measurements (ET₀, flow estimation, soil water balance)
• Calibration and drift
• Measurement uncertainty

---

Data:

Data structures, logs, synchronization formats, and documentation models.

Includes:

• Data models
• Logging formats
• Paper forms
• Sync protocols
• Event types
• Audit trails
• Data validation rules

---

Operations:

Runtime behavior and operational logic of AOWIS.

Covers:

• Decision hierarchy
• Scheduling
• Safety logic
• Manual intervention
• Bypass modes
• Fallback behavior
• Offline operation

---

Modules:

Domain‑specific extensions to the AOWIS core. Modules define specialized logic for particular use cases.

Examples:

• Crop irrigation
• Community water supply
• Livestock
• Poultry
• Greenhouse and hydroponics
• Custom modules
• Module templates

---

Databases:

Federated knowledge bases that support AOWIS implementations.

Includes:

• AOWIS‑Agro‑DB
• AOWIS‑Water‑DB
• Hardware database
• Device database
• Contribution model
• Sync model

---

Governance:

Organizational, legal, and certification aspects of AOWIS.

Topics:

• Certification processes
• Compliance verification
• Licensing
• Governance model
• Protection strategy

---

Training:

Human capacity building and operator education.

Includes:

• Training programs
• Certification levels
• Curriculum
• Field guides
• Operator checklists

---

Reference:

Non‑normative supporting material.

Contains:

• Case studies
• Implementation examples
• Hardware examples
• Glossary
• FAQ
• Change log

---

End of AOWIS Table of Contents