docs(products): DOC-2 column reference served at /api/products/columns.md (SLICE-8)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 02:24:05 -07:00
parent 0aeccf7d2c
commit 60a06de302
4 changed files with 117 additions and 1 deletions
@@ -95,6 +95,17 @@ def test_sample_csv_imports_clean(fresh_db_url):
        assert body["summary"]["errors"] == 0 and body["summary"]["adds"] == 2


+def test_columns_md_served(fresh_db_url):
+    """DOC-2 column reference is app-served, unauthenticated documentation (§6.4)."""
+    with TestClient(create_app(database_url=fresh_db_url)) as client:
+        resp = client.get("/api/products/columns.md")
+        assert resp.status_code == 200
+        assert "text/markdown" in resp.headers["content-type"]
+        body = resp.text
+        assert "Body (HTML)" in body  # Shopify dialect notes present
+        assert "`Handle`" in body  # canonical columns present
+
+
 def test_export_returns_canonical_csv(fresh_db_url):
    with _merchant_client(fresh_db_url) as client:
        draft = _upload(client).json()