From 9455bc865a3b953c5e62d93155dfd7bc1d6a835f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Ren=C3=A9=20White=20Enciso?=
 <jrenewhite@gmail.com>
Date: Tue, 24 Feb 2026 05:26:54 -0600
Subject: [PATCH] docs(furniture-dal): add domain boundary notes

---
 docs/architecture/dal-domain-alignment.md | 13 +++++++++++++
 docs/migration/dal-port-alignment-map.md  |  6 ++++++
 docs/migration/technical-mapping-rules.md |  6 ++++++
 3 files changed, 25 insertions(+)
 create mode 100644 docs/architecture/dal-domain-alignment.md
 create mode 100644 docs/migration/dal-port-alignment-map.md
 create mode 100644 docs/migration/technical-mapping-rules.md

diff --git a/docs/architecture/dal-domain-alignment.md b/docs/architecture/dal-domain-alignment.md
new file mode 100644
index 0000000..1288d1c
--- /dev/null
+++ b/docs/architecture/dal-domain-alignment.md
@@ -0,0 +1,13 @@
+# Furniture DAL Domain Alignment
+
+## Goal
+Align DAL with furniture-domain abstractions while keeping DAL technical.
+
+## DAL Responsibilities
+- Persistence and retrieval
+- Technical data translation
+- Provider/repository boundaries
+
+## Prohibited
+- Domain decision ownership
+- Service orchestration concerns
diff --git a/docs/migration/dal-port-alignment-map.md b/docs/migration/dal-port-alignment-map.md
new file mode 100644
index 0000000..d234c3d
--- /dev/null
+++ b/docs/migration/dal-port-alignment-map.md
@@ -0,0 +1,6 @@
+# DAL Port Alignment Map
+
+## Alignment Areas
+- DAL read/write ports map to domain contracts.
+- Technical DTO translation remains in DAL adapters.
+- Domain invariants are not reimplemented in DAL.
diff --git a/docs/migration/technical-mapping-rules.md b/docs/migration/technical-mapping-rules.md
new file mode 100644
index 0000000..f7cff99
--- /dev/null
+++ b/docs/migration/technical-mapping-rules.md
@@ -0,0 +1,6 @@
+# Technical Mapping Rules
+
+## Rules
+- Mapping logic must remain technical and deterministic.
+- No business branching in DAL mapping layer.
+- Correlation and metadata pass-through remains unchanged.