23-P3D — Notification Outbox / Reviewer Inbox — Roadmap Note

Date: 2026-05-07 Status: ROADMAP — chưa design, chưa execution. Prerequisite: P3C2 PASS. Required before: Hermes/reviewer agent production.

---

Vấn đề

Sau P3C2, AI có thể tạo draft, comment, apply. Nhưng không có cách nào để reviewer (GPT/Hermes) biết:

• Ai vừa comment vào draft/miếng nào?
• Miếng nào vừa được apply/update?
• Comment nào mới cần xem?

Hiện tại phải search thủ công — tốn token, dễ bỏ sót.

Thiết kế hướng

Hai log riêng biệt (KHÔNG phải general activity log):

1. Comment event log — ai vừa comment vào draft/miếng nào

unit_edit_comment_event (
  id, draft_id, comment_id, unit_id, author_ref,
  event_type, created_at, metadata
)

2. Update event log — miếng nào vừa apply/version mới

unit_edit_update_event (
  id, unit_id, version_id, draft_id, actor_ref,
  event_type, created_at, metadata
)

Cả hai:

• Lightweight references, không lưu full body
• PG trigger append tự động khi comment INSERT hoặc apply
• Index newest-first cho inbox query
• Kết hợp per-actor watermark (unit_edit_review_state) để biết ai xem đến đâu

Scope P3D

• DDL: 2 event tables + triggers
• Không function mới (triggers tự fire)
• Hermes/reviewer query: WHERE created_at > my_watermark ORDER BY created_at DESC

PG First

Trigger = PG-native event sourcing. Không cần message queue, không cần external service.

---

P3D Roadmap | 2026-05-07 | Notification Outbox | Chờ P3C2 completion