System Flow Overview

This page shows how Asset Intelligence works end-to-end.

It connects sensing, evaluation, state management, and automation into a single continuous flow.

---

High-Level Flow

---

Step-by-Step Flow

---

1. Sensors Capture the Environment

Home Assistant sensors provide real-world data:

• Temperature
• Humidity
• CO₂
• Lux / UV
• Air quality
• Leak detection
• Noise and pressure

---

2. Environment Model Is Built

The system builds a structured room model:

• Combines sensor inputs
• Adds external context (sun, weather)
• Assigns confidence

👉 Key Question:
“What is happening in the room?”

---

3. Evaluation Determines Risk

The system compares:

• Room conditions
  vs
• Asset requirements

It produces:

• Candidate risk state
• Risk reasons
• Signals used

👉 Key Question:
“What should the risk be?”

---

4. Coordinator Applies Runtime Logic

The coordinator:

• Applies debounce
• Confirms state transitions
• Generates events
• Produces advisory insights

👉 Key Question:
“What actually changed?”

---

Outputs

---

✅ Risk State

• Stable, confirmed state
• Used for automation

---

✅ Advisory

• Human-readable explanation
• Suggestions and context

---

✅ Activity Events

Recorded history of:

• Audit
• Environment
• Risk
• Documents
• Custody
• Measurements

---

5. Entities Expose State

Entities:

• Reflect current system state
• Feed UI and automations
• Do not perform logic

---

6. UI Displays Information

The UI shows:

• Environment conditions
• Risk and advisory
• Asset details
• Activity timeline

---

7. Automations Take Action

Home Assistant automations can:

• Trigger on risk state
• Use advisory context
• Control devices

Examples:

• Close shades
• Turn on ventilation
• Send alerts

---

8. Real-World Changes Occur

Actions affect the environment:

• Temperature adjusts
• Light reduces
• Air quality improves

---

🔁 The cycle repeats continuously

---

Example Scenario

Rising CO₂

1. CO₂ increases
2. Environment updates
3. Evaluation detects violation
4. Candidate state becomes RED
5. Coordinator applies debounce
6. Risk transitions to RED
7. Event recorded
8. Advisory generated
9. Automation triggers ventilation
10. CO₂ decreases
11. Risk returns to GREEN

---

Responsibility by Layer

Layer	Responsibility
Sensors	Provide raw data
Environment	Describe conditions
Evaluation	Determine risk
Coordinator	Handle state and events
Entities	Display results
Automations	Execute actions

---

Key Principle

Asset Intelligence separates:

• Awareness → what is happening
• Decision → what it means
• Action → what to do

---

Summary

Asset Intelligence continuously:

1. Observes the environment
2. Evaluates impact on assets
3. Generates insight
4. Records history
5. Enables action
6. Observes results

---

The system answers:

• What is happening?
• Does it matter?
• What should I understand?
• What should I do?

---

This is what turns a smart home into a system that behaves intelligently.