# Eldercare Monitor

> Giám sát phòng bà nội 24/7. Chạy mỗi 5 phút. Đọc sensors từ Home Assistant (mmWave presence, camera motion, nhiệt độ, độ ẩm). Phân tích bất thường dựa trên context (giờ, thói quen). Gửi cảnh báo 4 mức qua Zalo. Đối tượng: Người cao tuổi cần chăm sóc. Minh mẫn, nặng tai, nằm giường.

- Skill: `nclamvn/eldercare-monitor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nclamvn/eldercare-monitor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nclamvn/eldercare-monitor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nclamvn (https://skillmd.com/u/nclamvn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nclamvn/eldercare-monitor

---


# Eldercare Monitor — Giám sát bà nội

Skill này chạy mỗi 5 phút (cron), đọc sensors từ Home Assistant, phân tích tình trạng bà, và gửi cảnh báo nếu phát hiện bất thường.

## Khi được trigger (mỗi 5 phút)

### Bước 1: Đọc sensors từ Home Assistant

Dùng tool `home_assistant` với action `get_state` để đọc từng entity:

| Entity ID | Ý nghĩa | Cách đọc |
|-----------|---------|----------|
| `binary_sensor.grandma_room_presence` | mmWave: có người trong phòng? (on/off) | `get_state` |
| `sensor.grandma_room_motion_minutes` | Số phút từ lần cử động cuối | `get_state` |
| `sensor.grandma_room_temperature` | Nhiệt độ phòng (°C) | `get_state` |
| `sensor.grandma_room_humidity` | Độ ẩm (%) | `get_state` |
| `binary_sensor.grandma_room_camera_motion` | Camera thấy cử động? (on/off) | `get_state` |

Nếu bất kỳ sensor nào không available hoặc trả lỗi, log warning và bỏ qua sensor đó. Tiếp tục với sensors còn lại.

### Bước 2: Xác định context thời gian

Lấy giờ hiện tại theo timezone **Asia/Ho_Chi_Minh** (UTC+7):

- **Giờ ngủ đêm:** 22:00 - 06:00
- **Giờ ngủ trưa (nap):** 13:00 - 15:00
- **Giờ hoạt động:** Tất cả giờ còn lại (06:00-13:00 và 15:00-22:00)

Có thể adjust giờ nap nếu memory có `eldercare_nap_pattern`.

### Bước 3: Phân tích và phân loại 4 mức

Đọc `sensor.grandma_room_motion_minutes` (gọi tắt: `motion_min`) và `binary_sensor.grandma_room_presence` (gọi tắt: `presence`).

**Mức BÌNH THƯỜNG** — Không hành động, chỉ log:
- `motion_min` < 30 (bà vừa cử động gần đây)
- HOẶC: Đang trong giờ ngủ đêm (22h-6h) VÀ `presence` = on
- HOẶC: Đang trong giờ nap (13h-15h) VÀ `presence` = on

**Mức CHÚ Ý** — Gửi Zalo cho contact ưu tiên #1:
- `motion_min` > 30, đang trong giờ hoạt động, VÀ `presence` = on
- Message: `⚠️ [Bà Nội Care] Bà bất động {motion_min} phút (lúc {giờ:phút}). Presence OK — có thể bà đang nghỉ. Nhờ kiểm tra ạ.`

**Mức CẢNH BÁO** — Gửi Zalo TẤT CẢ contacts + camera snapshot:
- `motion_min` > 60, đang trong giờ hoạt động
- HOẶC: `presence` = off liên tục > 2 giờ trong khung 6h-22h
- Message: `🔴 [Bà Nội Care] CẢNH BÁO: Bà bất động {motion_min} phút / Không phát hiện người trong phòng {X} giờ! [Ảnh camera]`
- Hành động thêm: Dùng tool `camsnap` chụp camera snapshot, gửi ảnh kèm message

**Mức KHẨN CẤP** — Trigger skill eldercare-sos:
- Camera phát hiện ngã (nếu có integration) → ưu tiên gọi skill `eldercare-fall-detect` trước (TTS xác nhận với bà). Nếu bà không phản hồi → fall-detect tự trigger SOS Level 2.
- HOẶC: AI pattern nghi ngã — camera motion spike rồi bất động > 5 phút → gọi skill `eldercare-fall-detect`
- HOẶC: `presence` = off VÀ nhiệt độ giảm bất thường (> 3°C/giờ so với giờ trước) → Gọi skill `eldercare-sos` trực tiếp
- Hành động mặc định: Gọi skill `eldercare-sos` để bắt đầu SOS protocol

### Bước 4: Quy tắc chống false alarm

**Bắt buộc kiểm tra trước khi gửi cảnh báo:**

1. **Giờ nap (13-15h):** Nếu `presence` = on và `motion_min` > 30 → đây là BÌNH THƯỜNG (bà ngủ trưa), KHÔNG gửi cảnh báo
2. **Giờ đêm (22-6h):** Nếu `presence` = on → BÌNH THƯỜNG (bà ngủ), KHÔNG gửi cảnh báo
3. **Sau cuộc gọi video:** Nếu memory cho thấy có cuộc gọi video kết thúc trong 30 phút qua → nâng ngưỡng CHÚ Ý lên 45 phút thay vì 30 (bà nghỉ sau call)
4. **Cooldown:** Nếu đã gửi cảnh báo cùng mức hoặc cao hơn trong 15 phút qua → KHÔNG gửi lại (tránh spam). Kiểm tra memory `eldercare_last_alert_time`.

### Bước 5: Gửi cảnh báo

- **Mức CHÚ Ý:** Gửi tin nhắn Zalo cho contact ưu tiên cao nhất (đọc từ memory `eldercare_contacts`)
- **Mức CẢNH BÁO:** Gửi Zalo cho TẤT CẢ contacts trong danh sách + dùng `camsnap` chụp ảnh gửi kèm
- **Mức KHẨN CẤP:** Nói rõ: "Kích hoạt skill eldercare-sos" để AI trigger SOS protocol

### Bước 6: Log vào memory

Luôn log kết quả check vào memory (dùng cho daily report):

```
eldercare_check_{HH:mm}: {level} — {summary}
```

Ví dụ:
- `eldercare_check_10:05: attention — motion 35 phút, presence on`
- `eldercare_check_14:15: normal — nap time, presence on`
- `eldercare_check_09:00: warning — presence off 2.5 giờ`

Cập nhật `eldercare_last_alert_time` khi gửi cảnh báo (để kiểm tra cooldown lần sau).

### Nhiệt độ & Độ ẩm

Kiểm tra thêm điều kiện môi trường:

- Nhiệt độ < 20°C → Gửi CHÚ Ý: `🌡️ Nhiệt độ phòng bà {X}°C — hơi lạnh. Cần đắp thêm chăn.`
- Nhiệt độ > 35°C → Gửi CHÚ Ý: `🌡️ Nhiệt độ phòng bà {X}°C — nóng quá. Cần bật quạt/điều hoà.`
- Độ ẩm < 40% → Gửi CHÚ Ý: `💧 Độ ẩm phòng bà {X}% — khô. Cần bật máy tạo ẩm.`
- Độ ẩm > 80% → Gửi CHÚ Ý: `💧 Độ ẩm phòng bà {X}% — ẩm cao. Cần thông gió.`

### Contacts

Đọc danh sách contacts từ memory key `eldercare_contacts`. Format:

```json
[
  { "name": "Contact 1", "priority": 1 },
  { "name": "Contact 2", "priority": 2 }
]
```

Nếu chưa có contacts trong memory, gửi cảnh báo vào channel hiện tại và nhắc: "Cần cấu hình contacts cho eldercare. Dùng eldercare-config để setup."

## Config Override (đọc từ memory)

Trước khi dùng thresholds mặc định từ `monitor-config.json`, **PHẢI** kiểm tra memory:

1. Dùng memory search query `eldercare_monitor_config`
2. Nếu tìm thấy → parse JSON, dùng các thresholds từ memory (gia đình đã tuỳ chỉnh qua UI)
3. Nếu KHÔNG tìm thấy → dùng giá trị mặc định từ `monitor-config.json`

Các field có thể override:
- `thresholds.no_motion_attention_minutes` (mặc định: 30)
- `thresholds.no_motion_warning_minutes` (mặc định: 60)
- `thresholds.no_presence_warning_minutes` (mặc định: 120)
- `thresholds.temp_low` / `temp_high` (mặc định: 20 / 35)
- `thresholds.humidity_low` / `humidity_high` (mặc định: 40 / 80)
- `cooldown_minutes` (mặc định: 15)

## Offline Queue Integration

Khi gửi cảnh báo thất bại (Zalo hoặc Telegram error):

1. Lưu vào memory với key: `eldercare_queue_{timestamp}`
2. Format:
   ```json
   {
     "id": "queue_{timestamp}_{random}",
     "created_at": "ISO timestamp",
     "source_skill": "eldercare-monitor",
     "priority": "ATTENTION | WARNING | EMERGENCY",
     "channels": ["zalo"],
     "message": "Nội dung cảnh báo gốc",
     "target": "contact_1 | all",
     "retry_count": 0,
     "max_retries": 10,
     "last_retry_at": null,
     "status": "pending",
     "metadata": {
       "level": "attention | warning | emergency",
       "motion_minutes": 45,
       "presence": true
     }
   }
   ```
3. Skill eldercare-offline-queue sẽ retry theo backoff schedule
4. ATTENTION/INFO: chỉ retry Zalo
5. WARNING: retry Zalo, nếu fail thử Telegram
6. EMERGENCY: retry không backoff 3 lần đầu + channel failover

### Tóm tắt flow

```
Cron 5 phút
  ├── Đọc sensors (HA)
  ├── Xác định giờ (Asia/Ho_Chi_Minh)
  ├── Kiểm tra false alarm rules
  ├── Phân loại mức
  ├── Gửi cảnh báo (nếu cần)
  └── Log vào memory
```

## Multi-Elder Support

Skill này hỗ trợ nhiều người thân:

1. Đọc `eldercare_profiles` từ memory
2. Nếu không tồn tại → auto-migrate default profile "ba_noi" (xem skill eldercare-profiles)
3. Loop qua tất cả active elders
4. Với mỗi elder:
   - Dùng `elder.ha_entities.*` thay vì hardcoded entity names
   - Dùng `eldercare_{elder.id}_*` làm memory key prefix
   - Dùng `elder.name` trong messages/TTS
   - Dùng `elder.contacts` cho alert recipients (fallback global contacts)
   - Dùng `elder.tts.*` cho TTS settings

### Thay đổi cụ thể

- `binary_sensor.grandma_room_presence` → `elder.ha_entities.presence`
- `sensor.grandma_room_motion_minutes` → `elder.ha_entities.motion`
- `sensor.grandma_room_temperature` → `elder.ha_entities.temperature`
- `sensor.grandma_room_humidity` → `elder.ha_entities.humidity`
- `binary_sensor.grandma_room_camera_motion` → `elder.ha_entities.camera` + `_motion` attribute
- Memory: `eldercare_check_*` → `eldercare_{elder.id}_check_*`
- Memory: `eldercare_last_alert_time` → `eldercare_{elder.id}_last_alert_time`
- Memory: `eldercare_monitor_config` → `eldercare_{elder.id}_monitor_config`
- Memory: `eldercare_queue_*` → `eldercare_{elder.id}_queue_*`
- Contacts: `eldercare_contacts` → `elder.contacts` (fallback global)
- Alert messages: Prefix with `elder.name`, e.g. "⚠️ Bà Nội: bất động 35 phút"