AOWIS:Table of Contents

Overview of all AOWIS namespaces and their intended scope.

This document defines the high‑level structure of the AOWIS documentation. 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 technologies, systems, components, and engineering principles used in AOWIS deployments. Infrastructure pages describe classes of physical systems rather than specific implementation blueprints. Specific implementation blueprints go to "Reference Implementations" instead.

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 Implementations:

Concrete implementations, engineering blueprints, example deployments, and validated design patterns.

Reference pages describe specific implementations of technologies, systems, and principles documented elsewhere in AOWIS. They are non-normative unless a normative AOWIS requirement explicitly references them.

Contains:

• Case studies
• Implementation examples
• Engineering blueprints
• Hardware examples
• Bills of materials
• Construction details
• Example deployments
• Validated design patterns

TODO

• Glossary
• FAQ
• Change log

---

End of AOWIS Table of Contents