diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 919de90..062b2d9 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -3,6 +3,14 @@
 **Purpose:** Major infrastructure events only. Minor changes are in git commit messages.
 
 ---
+## 2026-08-07
+
+### Floorplan: photorealistic background via composite pipeline
+- **[HA]** Final "beautiful floorplan": Gemini one-shot render provided room interiors (good) with drifted geometry; a PIL compositor re-projected each room crop onto the exact plan geometry and redrew walls/doors/windows on top. Result deployed as `/local/floorplan-render.jpg`, set as Easy Floorplan floor `image` with `imageFit: stretch` (1:1 canvas mapping keeps the robot-tracker calibration). SVG furniture removed (backed up), areas made transparent, live device icons + tracker on top.
+- **[NOTE]** Reusable lesson: AI keeps either geometry or interiors, never both — composite (AI textures + coded geometry) is the deterministic path.
+
+---
+
 ## 2026-08-06
 
 ### Floorplan furnished (native SVG furniture; AI render path abandoned)