IU Agent Front-Door Context

AI/Agent: hướng dẫn hệ thống Information Unit. Không cần nhớ quy trình. 2 hàm chính + 1 nút duyệt.

Tạo hoặc sửa nội dung

SELECT fn_iu_save('địa-chỉ', 'nội dung', 'actor');

• Địa chỉ mới → phiên bản 1 chính thức.
• Địa chỉ đã có → nháp chờ duyệt.
• Nội dung giống → no_change.
• fn_iu_save(addr, body, actor, title, reason, 'draft') → luôn nháp.

Góp ý

SELECT fn_iu_comment('địa-chỉ', 'actor', 'comment', 'general', 'agent', '{}'::jsonb);

Tự do, không phê duyệt.

Phê duyệt nháp (reviewer)

SELECT fn_iu_apply_edit_draft('draft-id', 'reviewer', 'ghi chú');

Quy tắc

• KHÔNG ghi trực tiếp vào information_unit / unit_version.
• Nháp chưa apply ≠ bản chính.
• Mọi status trả về có guidance + next_action.
• Actor nên ổn định: gpt, opus, agent:codex, reviewer:gpt.
• Rollback policy phải qua reviewed pack. Không raw UPDATE.

Thông báo (chưa bật)

Notification inbox chưa có (chờ P3D). P3D sẽ tạo danh sách riêng cho comment mới, draft mới, apply mới. Mỗi reviewer/actor có trạng thái đã xem riêng — GPT xem rồi không mất trạng thái của Opus. Trước P3D, dùng report/draft/comment trực tiếp khi được giao.