Document shared evidence schema

SCHEMA.md

@@ -0,0 +1,40 @@
+# Evidence schema (v1)
+
+This repo is coordinated across parallel sessions. Each session writes its own evidence under:
+
+- `data/ho36/`
+- `data/flaneur/`
+
+## `evidence.json`
+
+Top-level:
+
+```json
+{
+  "hostel_name": "string",
+  "collected_at": "ISO datetime",
+  "collector_session": "A|B|C",
+  "evidence": [],
+  "profile": {}
+}
+```
+
+Each evidence item (one “fact”) is a row/object with:
+
+- `target`: `"ho36"` | `"flaneur"`
+- `source`: `"official_site"` | `"google_maps"` | `"booking"` | `"hostelworld"` | `"tripadvisor"` | `"instagram"` | `"facebook"` | `"tiktok"` | `"press"` | `"other"`
+- `metric_name`: string
+- `metric_value`: string | number | null
+- `url`: string
+- `captured_at`: ISO datetime
+- `status`: `"ok"` | `"blocked"` | `"unknown"` | `"error"`
+- `confidence`: `"high"` | `"med"` | `"low"`
+- `notes`: string
+- `screenshot_path`: string | null
+
+## `evidence.csv`
+
+One row per evidence item, with the same fields:
+
+`target,source,metric_name,metric_value,url,captured_at,status,confidence,notes,screenshot_path`
+

data/flaneur/evidence.json

@@ -0,0 +1,124 @@
+{
+  "hostel_name": "Flâneur Hostel Lyon",
+  "collected_at": "2026-01-02T19:01:21+01:00",
+  "collector_session": "B",
+  "evidence": [
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_official_site",
+      "metric_value": "https://leflaneur-guesthouse.com/",
+      "url": "https://leflaneur-guesthouse.com/",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "ok",
+      "confidence": "high",
+      "notes": "Discovered via Google Maps place page (website field).",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_google_maps",
+      "metric_value": "https://www.google.com/maps/place/Le+Fl%C3%A2neur+Guesthouse/@45.7512135,4.8428045,17z/data=!3m1!5s0x47f4ea4464dcb499:0x7fbb59cd88d1026a!4m9!3m8!1s0x47f4ea446430af35:0xe27846417ed8f4f!5m2!4m1!1i2!8m2!3d45.7512135!4d4.8428045!16s%2Fg%2F11ckqn6t7v",
+      "url": "https://www.google.com/maps/search/?api=1&query=Fl%C3%A2neur%20Hostel%20Lyon",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "ok",
+      "confidence": "med",
+      "notes": "Maps search landed on place page titled “Le Flâneur Guesthouse”.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_booking_engine",
+      "metric_value": "https://booking.roomraccoon.fr/le-fl-neur-guesthouse-8346/fr/",
+      "url": "https://leflaneur-guesthouse.com/",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "ok",
+      "confidence": "high",
+      "notes": "Official site “RESERVE TA NUIT ! BOOK NOW !” CTA points to RoomRaccoon booking engine.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_instagram",
+      "metric_value": "https://www.instagram.com/leflaneur_gh/",
+      "url": "https://leflaneur-guesthouse.com/",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "ok",
+      "confidence": "high",
+      "notes": "Linked from official site footer/social icons.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_facebook",
+      "metric_value": "https://www.facebook.com/leflaneurlyon",
+      "url": "https://leflaneur-guesthouse.com/",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "ok",
+      "confidence": "high",
+      "notes": "Linked from official site footer/social icons.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_tiktok",
+      "metric_value": null,
+      "url": "https://leflaneur-guesthouse.com/",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "unknown",
+      "confidence": "low",
+      "notes": "No TikTok link found on official site homepage/footer; will attempt direct check later.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_booking_listing",
+      "metric_value": null,
+      "url": "https://www.booking.com/searchresults.html?ss=Le%20Fl%C3%A2neur%20Guesthouse%20Lyon",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "unknown",
+      "confidence": "low",
+      "notes": "Attempted Booking.com search; listing URL not yet identified (timeboxed).",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_hostelworld_listing",
+      "metric_value": null,
+      "url": "https://www.hostelworld.com/search/?searchTerm=Le%20Fl%C3%A2neur%20Guesthouse%20Lyon",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "unknown",
+      "confidence": "low",
+      "notes": "Attempted Hostelworld search URL returned “404 - Page not found”; listing URL not yet identified.",
+      "screenshot_path": null
+    },
+    {
+      "target": "flaneur",
+      "source": "other",
+      "metric_name": "canonical_url_tripadvisor_listing",
+      "metric_value": "https://www.tripadvisor.com/Hotel_Review-g187265-d8778985-Reviews-Le_Flaneur_Guesthouse-Lyon_Rhone_Auvergne_Rhone_Alpes.html",
+      "url": "https://www.tripadvisor.com/Hotel_Review-g187265-d8778985-Reviews-Le_Flaneur_Guesthouse-Lyon_Rhone_Auvergne_Rhone_Alpes.html",
+      "captured_at": "2026-01-02T19:01:21+01:00",
+      "status": "blocked",
+      "confidence": "med",
+      "notes": "TripAdvisor page did not render content in automated capture; screenshot to be stored during TripAdvisor section.",
+      "screenshot_path": null
+    }
+  ],
+  "profile": {
+    "positioning": "",
+    "target_audience": [],
+    "key_amenities": [],
+    "vibe_tags": [],
+    "booking_engine": "",
+    "languages": []
+  }
+}
+