From 70b5d5477ae1826d294fc4b1f2024cc9b4b0f834 Mon Sep 17 00:00:00 2001
From: Angela Hudson <79058390+DaCameraGirl@users.noreply.github.com>
Date: Thu, 25 Jun 2026 21:50:03 -0400
Subject: [PATCH] docs: add language bar + 9 translated READMEs
Add clickable 10-language README navigation matching latent-observatory and other DaCameraGirl repos. Full translations for the current Compass Ultra README.
---
README.ar.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.de.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.es.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.fr.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.it.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.ja.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.ko.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.md | 13 ++
README.pt-BR.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
README.zh-CN.md | 371 ++++++++++++++++++++++++++++++++++++++++++++++++
10 files changed, 3352 insertions(+)
create mode 100644 README.ar.md
create mode 100644 README.de.md
create mode 100644 README.es.md
create mode 100644 README.fr.md
create mode 100644 README.it.md
create mode 100644 README.ja.md
create mode 100644 README.ko.md
create mode 100644 README.pt-BR.md
create mode 100644 README.zh-CN.md
diff --git a/README.ar.md b/README.ar.md
new file mode 100644
index 0000000..4b05865
--- /dev/null
+++ b/README.ar.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **ذكاء الإصدارات للفرق التي تنشر خلف أعلام الميزات.**
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+
+Compass Ultra هي غرفة تحكم للإصدارات للبرمجيات المعتمدة على أعلام الميزات. راجع حالة الأعلام، بوابات السياسات، مخاطر النشر، فروق اللقطات، تحليل المخاطر المدعوم بالذكاء الاصطناعي، وإثبات الإصدار الجاهز للتدقيق — قبل أن تدخل التغييرات الإنتاجية حيز التشغيل.
+
+[🚀 التطبيق المباشر](https://www.compassultra.com) · [🎮 جرّب العرض التوضيحي](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ لماذا Compass Ultra؟
+
+من المفترض أن تجعل أعلام الميزات الإصدارات أكثر أمانًا.
+
+لكن مع مرور الوقت، يمكن أن تصبح سطح إصدار بحد ذاتها:
+
+* 🧟 أعلام قديمة أو منتهية الصلاحية
+* 🎲 نسب نشر محفوفة بالمخاطر
+* 👤 مالكون وموافقون مفقودون
+* 🕸️ تبعيات مخفية بين الأعلام
+* 🚨 تجاوزات في الإنتاج
+* 💬 سلاسل Slack تتظاهر بأنها مسارات تدقيق
+* 🧩 قرارات إصدار مبعثرة عبر أدوات كثيرة جدًا
+
+**يحوّل Compass Ultra فوضى أعلام الميزات إلى سير عمل مراجعة إصدار قابل للتكرار.**
+
+بدلًا من السؤال:
+
+> "هل نحن جاهزون للنشر؟"
+
+يمكن لفريقك الإجابة:
+
+* ✅ ما المُفعّل؟
+* 👥 من المتأثر؟
+* 🔄 ما الذي تغيّر؟
+* 💥 ما الذي قد يتعطل؟
+* 🖊️ من وافق؟
+* 🧯 ما الذي يجب إصلاحه أولًا؟
+* 📄 ما الإثبات الذي يمكننا تقديمه لـ QA أو DevOps أو القيادة أو الامتثال؟
+
+---
+
+## ⚡ النسخة المختصرة
+
+يساعد Compass Ultra الفرق على مراجعة وإثبات جاهزية الإصدار قبل النشر.
+
+تبدو مراجعة الإصدار النموذجية هكذا:
+
+1. 📦 تحميل أو استيراد مساحة عمل إصدار.
+2. 👤 تقييم الأعلام مقابل سياق مستخدم حقيقي.
+3. 🛡️ تشغيل بوابات السياسات وتحليل المخاطر.
+4. 🔍 مقارنة لقطات الإصدار.
+5. 📄 تصدير دليل تشغيل الإصدار.
+6. 🚀 مشاركة الإثبات قبل أن تدخل التغييرات الإنتاجية حيز التشغيل.
+
+---
+
+## 🎮 العرض التوضيحي المباشر
+
+يعمل العرض التوضيحي بدون حساب:
+
+**العرض التوضيحي:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+يحاكي العرض التوضيحي إصدارًا تجاريًا محفوفًا بالمخاطر (ليلة ما قبل الجمعة السوداء، `peak-sale-2026.11`) مع:
+
+* 🏁 10 أعلام ميزات عبر LaunchDarkly وStatsig وFirebase
+* 🛒 أعلام عالية المخاطر للدفع والتخفيضات السريعة والشحن في نفس اليوم
+* 🚧 عوائق وتحذيرات سياسات (فجوات التبعيات، انتهاكات canary)
+* 🔗 فحوصات رسم التبعيات
+* 🧾 مقارنة اللقطات
+* 📄 تصدير دليل تشغيل PDF
+* 🔌 إنشاء حمولات GitHub وJira وSlack
+* 🧯 تدفق التراجع kill-switch لحالة العرض التوضيحي
+* 💰 تقدير الأثر المالي لنافذة النشر ذات الذروة
+
+---
+
+## 🧠 الميزات الأساسية
+
+### 🚦 محلل مخاطر الإصدار
+
+يراجع Compass Ultra مساحة عمل الإصدار الحالية ويعيد تقييمًا عمليًا للإصدار:
+
+* ✅ **انشر**
+* 🟡 **انتظر**
+* 🔴 **أصلح أولًا**
+
+مدعوم بخدمة ذكاء اصطناعي مباشرة مع بديل حتمي — لا يُحجب التحليل أبدًا حتى عندما تكون خدمة الذكاء الاصطناعي غير متاحة.
+
+يمكنه اكتشاف مشكلات مثل:
+
+* 🔥 أعلام نشطة عالية المخاطر
+* 🔗 تعارضات التبعيات
+* 👻 موافقون مفقودون
+* ⏰ أعلام منتهية أو بلا مالك
+* 🐤 انتهاكات نشر canary
+* 🚨 تجاوزات الإنتاج
+* 🧾 أنماط نشر حساسة للامتثال
+* 💰 تقديرات الأثر المالي لنوافذ النشر ذات الذروة
+
+---
+
+### 🎯 محرك تقييم الأعلام
+
+قيّم كل علم مقابل سياق مستخدم محدد.
+
+| الحقل | الوصف |
+| --- | --- |
+| 👤 User key | معرّف المستخدم الفريد |
+| 📧 Email | عنوان بريد المستخدم |
+| 🏢 Tenant | مستأجر العميل أو الحساب |
+| 💳 Plan | خطة التسعير أو الاستحقاق |
+| 🛂 Role | دور المستخدم أو مجموعة الصلاحيات |
+| 🌎 Region | المنطقة الجغرافية أو البنية التحتية |
+| 🏳️ Country | الاستهداف على مستوى الدولة |
+| 📱 Device | نوع الجهاز أو المنصة |
+| 🌐 Environment | التطوير أو التجهيز أو الإنتاج أو بيئة مخصصة |
+
+يعرض كل علم:
+
+* 🎚️ القيمة المُقيّمة
+* 🧠 سبب الحل (تطابق قاعدة، دلو نشر، افتراضي، أو تجاوز)
+* 🧩 القاعدة أو الشرط المطابق
+* 📌 السياق ذو الصلة المستخدم أثناء التقييم
+
+انتقل بين إعدادات السياق المحفوظة — Production admin وEU customer وMobile guest — لترى كيف تتصرف الأعلام لكل شريحة.
+
+---
+
+### 🛡️ بوابات سياسات المؤسسات (9 فحوصات)
+
+يشغّل Compass Ultra فحوصات إصدار تلقائية عند كل تغيير في حالة مساحة العمل.
+
+| 🔒 البوابة | ما تفحصه |
+| --- | --- |
+| 🎟️ تذكرة تغيير مرفقة | تذكرة CHG أو Jira موجودة قبل الإنتاج |
+| 👥 الأعلام الحرجة لها موافقون | جميع الأعلام النشطة عالية/حرجة المخاطر لها موافقون مسمّون |
+| 🧬 كل علم له قابلية تتبع | جميع الأعلام لها معرّفات Jira/تغيير |
+| ⏳ لا أعلام منتهية مُفعّلة | لا أعلام مُفعّلة تجاوزت انتهاء الصلاحية |
+| 🚫 انضباط تجاوز الإنتاج | لا تجاوزات يدوية نشطة في الإنتاج |
+| 🐤 حد نشر canary | الأعلام التي تتطلب canary تبقى ضمن 50% نشر |
+| 🔗 التبعيات مُفعّلة | لا علم مُفعّل له تبعية معطّلة |
+| 🔌 محولات مزود مباشرة مُعدّة | رمز مزود واحد على الأقل متصل |
+| 📤 خطافات DevOps صادرة مُعدّة | نقاط نهاية GitHub/Jira/Slack مضبوطة |
+
+---
+
+### 🤖 أداة دردشة AI DevOps
+
+مساعد دردشة ذكاء اصطناعي عائم يمكن تضمينه في أي صفحة بوسم script واحد:
+
+```html
+
+```
+
+* 💬 اطرح أسئلة الإصدار بلغة طبيعية
+* 🔍 يقرأ حالة مساحة العمل المباشرة تلقائيًا
+* 📊 عداد الجلسة يعرض عدد الزوار الذين استخدموه
+* ⚡ بديل أنيق عندما تكون خدمة الذكاء الاصطناعي غير متاحة
+* 🧠 يحافظ على سجل الدردشة عبر الرسائل في نفس الجلسة
+
+جرّبه مباشرة: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 تكاملات المزودين (مزامنة للقراءة فقط)
+
+استورد حالة الأعلام المباشرة من مزود الأعلام عبر رمز قراءة فقط مملوك للعميل عبر وكيل الخادم.
+
+| 🏴 المزود | النوع |
+| --- | --- |
+| 🚀 LaunchDarkly | مزامنة المزود |
+| 📊 Statsig | مزامنة المزود |
+| 🔓 Unleash | مزامنة المزود |
+| 🏳️ Flagsmith | مزامنة المزود |
+| 🔥 Firebase Remote Config | مزامنة المزود |
+
+🔒 مفاتيح API لا تغادر وكيل الخادم الخلفي أبدًا. المتصفح يستدعي فقط واجهة Compass Ultra API.
+
+---
+
+### 📤 تكاملات DevOps الصادرة
+
+نسخ الحمولة بنقرة واحدة أو POST إلى أدواتك الحالية:
+
+| 🔌 التكامل | النوع |
+| --- | --- |
+| 🐙 GitHub Issues | قضية إثبات الإصدار |
+| 🎫 Jira Change | تحديث تذكرة CHG |
+| 💬 Slack War Room | عوائق الإصدار / رسالة غنية |
+
+---
+
+### 🔍 فروق اللقطات
+
+قارن نقطتي تفتيش إصدار واعرف بالضبط ما الذي تغيّر.
+
+يمكن للفروق تحديد:
+
+* ➕ أعلام مُضافة
+* ➖ أعلام مُزالة
+* 📈 تغييرات النشر
+* 🚨 تغييرات الأهمية
+* 👤 تغييرات المالك أو الموافق
+* 🛠️ تغييرات التجاوز
+
+---
+
+### 📄 أدلة تشغيل وشهادات إصدار PDF
+
+صدّر ملفات PDF جاهزة لـ CAB لمراجعة QA أو القيادة أو DevOps أو التدقيق.
+
+تتضمن أدلة التشغيل:
+
+* 🏷️ بيانات وصفية للإصدار ونافذة النشر
+* 🎯 تقييمات الأعلام وحالات النشر
+* 🛡️ نتائج بوابات السياسات
+* 🧠 ملخص المخاطر والأثر المالي
+* 🧯 ملاحظات التراجع لكل علم
+* ✍️ قائمة توقيعات الموافقين
+* 🧾 سجل التدقيق
+
+---
+
+### 🐙 بوابة CI لـ GitHub Action
+
+احجب عمليات النشر في CI عندما تتجاوز مخاطر الإصدار عتبة مُعدّة:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 تفشل الإجراءات تلقائيًا في سير العمل عند العثور على عوائق — لا مزيد من "نسينا فحص الأعلام قبل الدمج."
+
+---
+
+### 👥 RBAC (4 أدوار)
+
+| 🎭 الدور | الصلاحيات |
+| --- | --- |
+| 🔑 Admin | وصول كامل — الأعلام والإصدار والفريق والتكاملات |
+| ✅ Approver | الموافقة على الإصدارات، عرض الكل |
+| 🛠️ Operator | تعديل الأعلام وبيانات الإصدار الوصفية |
+| 👁️ Viewer | قراءة فقط |
+
+تُسجّل جميع الإجراءات المحجوبة مع الفاعل والدور والبوابة المُفعّلة والطابع الزمني الدقيق.
+
+---
+
+## 🧭 موضع المنتج
+
+Compass Ultra **ليس** مزود أعلام ميزات.
+
+إنه **طبقة مراجعة الإصدار** حول أعلام الميزات.
+
+استخدمه عندما تحتاج إجابة واضحة على:
+
+> "هل يمكننا نشر هذا الإصدار المعتمد على أعلام الميزات بأمان، وهل يمكننا إثبات ذلك؟"
+
+---
+
+## 💸 التسعير
+
+| الخطة | السعر | المقاعد | الأنسب لـ |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | محلي فقط | تجربة مساحة العمل ومراجعة الإصدار المحلية |
+| 🧍 Solo | $49/شهر | مقعد واحد | المشغّلون المنفردون الذين يحتاجون مزامنة سحابية وتحليل مخاطر ولقطات وتصدير |
+| 🚀 Pro | $149/شهر | حتى 5 مقاعد | الفرق الصغيرة التي تحتاج مراجعة إصدار مشتركة ومقارنة |
+| 👥 Team | $299/شهر | حتى 15 مقعدًا | فرق الإصدار التي تحتاج RBAC وتصدير تدقيق وتنبيهات وسير عمل المؤسسة |
+| 🏢 Enterprise | مخصص | مخصص | مراجعة أمنية وإعداد وشروط مخصصة وتكاملات |
+
+تبدأ الخطط المدفوعة بـ **تجربة مجانية لمدة 7 أيام**.
+
+لا حاجة لبطاقة ائتمان. تتحول التجارب تلقائيًا إلى Free ما لم يشترك العميل.
+
+---
+
+## 🛠️ المكدس التقني
+
+| الطبقة | التقنية |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 الكود المصدري
+
+يحتوي هذا المستودع العام على صفحة إطلاق Compass Ultra والوثائق وأصول GitHub Pages ومواد المشروع العامة.
+
+يُصان التطبيق الإنتاجي والخادم الخلفي بشكل منفصل. يمكن للمستخدمين العامين استكشاف التطبيق المباشر والعرض التوضيحي دون الحاجة إلى الوصول إلى مستودعات التنفيذ الخاصة.
+
+---
+
+## 🔒 نموذج الأمان
+
+صُمم Compass Ultra كطبقة مراجعة إصدار.
+
+* 🧪 يعمل العرض التوضيحي المحلي بدون تسجيل دخول.
+* 🔐 تتطلب اللقطات السحابية المصادقة.
+* 🔌 تستخدم مزامنة المزود رموز قراءة فقط عبر وكيل الخادم الخلفي — مفاتيح API لا تمر عبر المتصفح أبدًا.
+* 🛡️ رؤوس أمان على جميع الاستجابات: `X-Frame-Options` و`Content-Security-Policy` و`Strict-Transport-Security` و`X-Content-Type-Options`.
+* 💳 Stripe يتعامل مع بيانات البطاقة.
+* 🪪 Auth0 هو مزود الهوية.
+* 🔗 روابط المشاركة ترمّز حالة مساحة العمل ولا ينبغي استخدامها للأسرار.
+* 🏢 يجب على عملاء المؤسسات استخدام مراجعة أمنية وشروط مخصصة قبل نشر المزود المباشر.
+
+---
+
+## 🗺️ خارطة الطريق
+
+* 🧾 حدود مقاعد مفروضة بالكامل من الخادم الخلفي
+* 🧪 أتمتة دورة حياة التجربة بدون بطاقة
+* 🚦 ضوابط إساءة التجربة حسب البريد والنطاق والاستخدام
+* 👥 تدفق دعوة الفريق
+* 🏢 مساحات عمل المؤسسة
+* 🔌 المزيد من محولات المزودين
+* 💬 سير عمل تطبيق Slack
+* 🐙 توسيع بوابة إصدار GitHub Action
+* 📤 المزيد من صيغ التصدير
+* 🔒 حزمة مراجعة أمنية للمؤسسات
+* 📊 أعداد الجلسات والرسائل المباشرة من الخادم الخلفي لأداة AI DevOps
+
+---
+
+## ✅ الحالة
+
+Compass Ultra مباشر:
+
+**الإنتاج:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**العرض التوضيحي:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 مُصمّم لـ
+
+الفرق التي تنشر بسرعة ولا تزال تحتاج إثباتًا قبل الإنتاج.
+
+**انشر بثقة. راجع بالأدلة. أثبت كل إصدار.** 🧭
\ No newline at end of file
diff --git a/README.de.md b/README.de.md
new file mode 100644
index 0000000..09086e1
--- /dev/null
+++ b/README.de.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **Release-Intelligence für Teams, die hinter Feature Flags ausliefern.**
+
+
+
+
+
+ 
+
+
+
+
+
+ 
+
+
+Compass Ultra ist ein Release-Kontrollraum für Software mit Feature Flags. Prüfen Sie Flag-Status, Policy-Gates, Rollout-Risiko, Snapshot-Diffs, KI-gestützte Risikoanalyse und auditfähige Release-Nachweise — bevor Produktionsänderungen live gehen.
+
+[🚀 Live App](https://www.compassultra.com) · [🎮 Try the Demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ Warum Compass Ultra?
+
+Feature Flags sollen Releases sicherer machen.
+
+Mit der Zeit können sie jedoch zu einer eigenen Release-Oberfläche werden:
+
+* 🧟 Veraltete oder abgelaufene Flags
+* 🎲 Riskante Rollout-Prozentsätze
+* 👤 Fehlende Owner und Approver
+* 🕸️ Versteckte Flag-Abhängigkeiten
+* 🚨 Produktions-Overrides
+* 💬 Slack-Threads als Audit-Trail-Ersatz
+* 🧩 Release-Entscheidungen über zu viele Tools verstreut
+
+**Compass Ultra verwandelt Feature-Flag-Chaos in einen wiederholbaren Release-Review-Workflow.**
+
+Statt zu fragen:
+
+> „Können wir ausliefern?“
+
+Kann Ihr Team antworten:
+
+* ✅ Was ist aktiviert?
+* 👥 Wer ist betroffen?
+* 🔄 Was hat sich geändert?
+* 💥 Was kann kaputtgehen?
+* 🖊️ Wer hat es genehmigt?
+* 🧯 Was muss zuerst behoben werden?
+* 📄 Welchen Nachweis können wir QA, DevOps, Führung oder Compliance übergeben?
+
+---
+
+## ⚡ Die Kurzfassung
+
+Compass Ultra hilft Teams, die Release-Bereitschaft vor dem Ausliefern zu prüfen und nachzuweisen.
+
+Ein typischer Release-Review sieht so aus:
+
+1. 📦 Release-Workspace laden oder importieren.
+2. 👤 Flags gegen einen echten Benutzerkontext evaluieren.
+3. 🛡️ Policy-Gates und Risikoanalyse ausführen.
+4. 🔍 Release-Snapshots vergleichen.
+5. 📄 Release-Runbook exportieren.
+6. 🚀 Den Nachweis teilen, bevor Produktionsänderungen live gehen.
+
+---
+
+## 🎮 Live-Demo
+
+Die Demo funktioniert ohne Konto:
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+Die Demo simuliert ein riskantes Retail-Release (Abend vor Black Friday, `peak-sale-2026.11`) mit:
+
+* 🏁 10 Feature Flags über LaunchDarkly, Statsig und Firebase
+* 🛒 Hochriskante Checkout-, Flash-Sale- und Same-Day-Shipping-Flags
+* 🚧 Policy-Blocker und Warnungen (Abhängigkeitslücken, Canary-Verstöße)
+* 🔗 Abhängigkeitsgraph-Prüfungen
+* 🧾 Snapshot-Vergleich
+* 📄 PDF-Runbook-Export
+* 🔌 GitHub-, Jira- und Slack-Payload-Generierung
+* 🧯 Kill-Switch-Rollback-Flow für den Demo-Zustand
+* 💰 Finanzielle Impact-Schätzung für das Peak-Traffic-Deploy-Fenster
+
+---
+
+## 🧠 Kernfunktionen
+
+### 🚦 Release-Risiko-Analysator
+
+Compass Ultra prüft den aktuellen Release-Workspace und liefert eine praktische Release-Bewertung:
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+Angetrieben von einem Live-KI-Service mit deterministischem Fallback — die Analyse wird nie blockiert, auch wenn der KI-Service nicht verfügbar ist.
+
+Er kann Probleme erkennen wie:
+
+* 🔥 Hochriskante aktive Flags
+* 🔗 Abhängigkeitskonflikte
+* 👻 Fehlende Approver
+* ⏰ Abgelaufene oder ownerlose Flags
+* 🐤 Canary-Rollout-Verstöße
+* 🚨 Produktions-Overrides
+* 🧾 Compliance-sensible Rollout-Muster
+* 💰 Finanzielle Impact-Schätzungen für Peak-Traffic-Deploy-Fenster
+
+---
+
+### 🎯 Flag-Evaluierungs-Engine
+
+Evaluieren Sie jedes Flag gegen einen spezifischen Benutzerkontext.
+
+| Feld | Beschreibung |
+| --- | --- |
+| 👤 User key | Eindeutige Benutzerkennung |
+| 📧 Email | E-Mail-Adresse des Benutzers |
+| 🏢 Tenant | Kunden- oder Account-Tenant |
+| 💳 Plan | Preis- oder Berechtigungsplan |
+| 🛂 Role | Benutzerrolle oder Berechtigungsgruppe |
+| 🌎 Region | Geografische oder Infrastruktur-Region |
+| 🏳️ Country | Länderbezogenes Targeting |
+| 📱 Device | Geräte- oder Plattformtyp |
+| 🌐 Environment | Entwicklung, Staging, Produktion oder benutzerdefinierte Umgebung |
+
+Jedes Flag zeigt:
+
+* 🎚️ Evaluierter Wert
+* 🧠 Auflösungsgrund (Regel-Treffer, Rollout-Bucket, Standard oder Override)
+* 🧩 Passende Regel oder Bedingung
+* 📌 Relevanter Kontext während der Evaluierung
+
+Wechseln Sie zwischen gespeicherten Kontext-Presets — Production admin, EU customer, Mobile guest — um zu sehen, wie sich Flags pro Segment verhalten.
+
+---
+
+### 🛡️ Enterprise Policy Gates (9 Prüfungen)
+
+Compass Ultra führt bei jeder Workspace-Statusänderung automatisierte Release-Prüfungen aus.
+
+| 🔒 Gate | Was es prüft |
+| --- | --- |
+| 🎟️ Change ticket attached | CHG- oder Jira-Ticket ist vor Produktion vorhanden |
+| 👥 Critical flags have approvers | Alle hoch/kritischen aktiven Flags haben benannte Approver |
+| 🧬 Every flag has traceability | Alle Flags haben Jira-/Change-IDs |
+| ⏳ No expired flags enabled | Keine aktivierten Flags sind über dem Ablaufdatum |
+| 🚫 Production override discipline | Keine manuellen Overrides in Produktion aktiv |
+| 🐤 Canary rollout limit | Canary-pflichtige Flags bleiben innerhalb von 50 % Rollout |
+| 🔗 Dependencies enabled | Kein aktiviertes Flag hat eine deaktivierte Abhängigkeit |
+| 🔌 Live provider adapters configured | Mindestens ein Provider-Token ist verbunden |
+| 📤 Outbound DevOps hooks configured | GitHub/Jira/Slack-Endpunkte sind konfiguriert |
+
+---
+
+### 🤖 AI DevOps Chat Widget
+
+Ein schwebender KI-Chat-Assistent, der mit einem einzigen Script-Tag auf jeder Seite eingebettet werden kann:
+
+```html
+
+```
+
+* 💬 Release-Fragen in natürlicher Sprache stellen
+* 🔍 Liest automatisch den Live-Workspace-Status
+* 📊 Sitzungszähler zeigt, wie viele Besucher es genutzt haben
+* ⚡ Graceful Fallback, wenn der KI-Service nicht verfügbar ist
+* 🧠 Behält den Chat-Verlauf über Nachrichten in derselben Sitzung bei
+
+Live ausprobieren: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 Provider-Integrationen (Read-Only Sync)
+
+Importieren Sie den Live-Flag-Status von Ihrem Flag-Provider über ein kundeneigenes Read-Only-Token über den Server-Proxy.
+
+| 🏴 Provider | Type |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 API-Schlüssel verlassen niemals den Backend-Proxy. Der Browser ruft nur die Compass Ultra API auf.
+
+---
+
+### 📤 Ausgehende DevOps-Integrationen
+
+Payload-Kopie mit einem Klick oder POST an Ihre bestehenden Tools:
+
+| 🔌 Integration | Type |
+| --- | --- |
+| 🐙 GitHub Issues | Release evidence issue |
+| 🎫 Jira Change | CHG ticket update |
+| 💬 Slack War Room | Release blocks / rich message |
+
+---
+
+### 🔍 Snapshot Diff
+
+Vergleichen Sie zwei Release-Checkpoints und sehen Sie genau, was sich geändert hat.
+
+Diffs können identifizieren:
+
+* ➕ Hinzugefügte Flags
+* ➖ Entfernte Flags
+* 📈 Rollout-Änderungen
+* 🚨 Kritikalitätsänderungen
+* 👤 Owner- oder Approver-Änderungen
+* 🛠️ Override-Änderungen
+
+---
+
+### 📄 PDF Release Runbooks & Certificates
+
+Exportieren Sie CAB-fertige PDFs für QA, Führung, DevOps oder Audit-Review.
+
+Runbooks enthalten:
+
+* 🏷️ Release-Metadaten und Deploy-Fenster
+* 🎯 Flag-Evaluierungen und Rollout-Status
+* 🛡️ Policy-Gate-Ergebnisse
+* 🧠 Risikozusammenfassung und finanzieller Impact
+* 🧯 Rollback-Notizen pro Flag
+* ✍️ Approver-Unterschriftenliste
+* 🧾 Audit-Verlauf
+
+---
+
+### 🐙 GitHub Action CI Gate
+
+Blockieren Sie Deployments in CI, wenn das Release-Risiko einen konfigurierten Schwellenwert überschreitet:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 Die Action schlägt den Workflow automatisch fehl, wenn Blocker gefunden werden — kein „wir haben vergessen, die Flags vor dem Merge zu prüfen“ mehr.
+
+---
+
+### 👥 RBAC (4 Rollen)
+
+| 🎭 Role | Permissions |
+| --- | --- |
+| 🔑 Admin | Full access — flags, release, team, integrations |
+| ✅ Approver | Approve releases, view all |
+| 🛠️ Operator | Edit flags and release metadata |
+| 👁️ Viewer | Read only |
+
+Alle blockierten Aktionen werden mit Akteur, Rolle, ausgelöstem Gate und exaktem Zeitstempel protokolliert.
+
+---
+
+## 🧭 Produktpositionierung
+
+Compass Ultra ist **kein** Feature-Flag-Provider.
+
+Es ist die **Release-Review-Schicht** um Feature Flags herum.
+
+Nutzen Sie es, wenn Sie eine klare Antwort auf diese Frage brauchen:
+
+> „Können wir dieses Feature-Flag-Release sicher ausliefern — und können wir es nachweisen?“
+
+---
+
+## 💸 Preise
+
+| Plan | Preis | Plätze | Ideal für |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | Local only | Workspace und lokale Release-Review ausprobieren |
+| 🧍 Solo | $49/mo | 1 seat | Solo-Operatoren, die Cloud-Sync, Risikoanalyse, Snapshots und Exporte brauchen |
+| 🚀 Pro | $149/mo | Up to 5 seats | Kleine Teams, die gemeinsame Release-Review und Diffs brauchen |
+| 👥 Team | $299/mo | Up to 15 seats | Release-Teams, die RBAC, Audit-Export, Alerts und Org-Workflows brauchen |
+| 🏢 Enterprise | Custom | Custom | Security Review, Onboarding, individuelle Bedingungen und Integrationen |
+
+Bezahlte Pläne starten mit einer **7-tägigen kostenlosen Testphase**.
+
+Keine Kreditkarte erforderlich. Testphasen wechseln automatisch zu Free, sofern der Kunde nicht abonniert.
+
+---
+
+## 🛠️ Tech Stack
+
+| Schicht | Technologie |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 Quellcode
+
+Dieses öffentliche Repository enthält die Compass Ultra Launch-Seite, Dokumentation, GitHub Pages Assets und öffentlich zugängliche Projektmaterialien.
+
+Die Produktionsanwendung und das Backend werden separat gepflegt. Öffentliche Nutzer können die Live-App und Demo erkunden, ohne Zugang zu privaten Implementierungs-Repositories zu benötigen.
+
+---
+
+## 🔒 Sicherheitsmodell
+
+Compass Ultra ist als Release-Review-Schicht konzipiert.
+
+* 🧪 Lokale Demo funktioniert ohne Login.
+* 🔐 Cloud-Snapshots erfordern Authentifizierung.
+* 🔌 Provider-Sync nutzt Read-Only-Tokens über den Backend-Proxy — API-Schlüssel passieren niemals den Browser.
+* 🛡️ Sicherheits-Header bei allen Antworten: `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 Stripe verarbeitet Kartendaten.
+* 🪪 Auth0 ist der Identity Provider.
+* 🔗 Share-Links kodieren den Workspace-Status und sollten nicht für Secrets verwendet werden.
+* 🏢 Enterprise-Kunden sollten Security Review und individuelle Bedingungen vor dem Live-Provider-Rollout nutzen.
+
+---
+
+## 🗺️ Roadmap
+
+* 🧾 Vollständig backend-erzwungene Sitzplatzlimits
+* 🧪 No-Card-Trial-Lifecycle-Automatisierung
+* 🚦 Trial-Missbrauchskontrollen nach E-Mail, Domain und Nutzung
+* 👥 Team-Einladungsflow
+* 🏢 Organisations-Workspaces
+* 🔌 Weitere Provider-Adapter
+* 💬 Slack-App-Workflow
+* 🐙 GitHub Action Release Gate Erweiterung
+* 📤 Weitere Exportformate
+* 🔒 Security Review Paket für Enterprise
+* 📊 Live Backend Session- und Nachrichtenzähler für das AI DevOps Widget
+
+---
+
+## ✅ Status
+
+Compass Ultra ist live:
+
+**Production:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 Gebaut für
+
+Teams, die schnell ausliefern und trotzdem Nachweise vor Produktion brauchen.
+
+**Mit Vertrauen ausliefern. Mit Nachweisen prüfen. Jeden Release belegen.** 🧭
\ No newline at end of file
diff --git a/README.es.md b/README.es.md
new file mode 100644
index 0000000..fc4af5f
--- /dev/null
+++ b/README.es.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **Inteligencia de releases para equipos que despliegan detrás de feature flags.**
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+
+Compass Ultra es una sala de control de releases para software con feature flags. Revisa el estado de los flags, las compuertas de políticas, el riesgo de despliegue, las diferencias entre snapshots, el análisis de riesgo asistido por IA y la evidencia de release lista para auditoría — antes de que los cambios en producción entren en vigor.
+
+[🚀 Live App](https://www.compassultra.com) · [🎮 Try the Demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ ¿Por qué Compass Ultra?
+
+Los feature flags deberían hacer los releases más seguros.
+
+Pero con el tiempo, pueden convertirse en una superficie de release por sí mismos:
+
+* 🧟 Flags obsoletos o caducados
+* 🎲 Porcentajes de despliegue arriesgados
+* 👤 Propietarios y aprobadores faltantes
+* 🕸️ Dependencias ocultas entre flags
+* 🚨 Overrides en producción
+* 💬 Hilos de Slack haciendo de pista de auditoría
+* 🧩 Decisiones de release dispersas en demasiadas herramientas
+
+**Compass Ultra convierte el caos de los feature flags en un flujo de revisión de release repetible.**
+
+En lugar de preguntar:
+
+> "¿Podemos desplegar?"
+
+Tu equipo puede responder:
+
+* ✅ ¿Qué está habilitado?
+* 👥 ¿A quién afecta?
+* 🔄 ¿Qué cambió?
+* 💥 ¿Qué puede romperse?
+* 🖊️ ¿Quién lo aprobó?
+* 🧯 ¿Qué hay que arreglar primero?
+* 📄 ¿Qué evidencia podemos entregar a QA, DevOps, liderazgo o cumplimiento?
+
+---
+
+## ⚡ La versión corta
+
+Compass Ultra ayuda a los equipos a revisar y demostrar la preparación del release antes de desplegar.
+
+Una revisión de release típica se ve así:
+
+1. 📦 Cargar o importar un workspace de release.
+2. 👤 Evaluar flags contra un contexto de usuario real.
+3. 🛡️ Ejecutar compuertas de políticas y análisis de riesgo.
+4. 🔍 Comparar snapshots de release.
+5. 📄 Exportar un runbook de release.
+6. 🚀 Compartir la evidencia antes de que los cambios en producción entren en vigor.
+
+---
+
+## 🎮 Demo en vivo
+
+La demo funciona sin cuenta:
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+La demo simula un release minorista de alto riesgo (víspera de Black Friday, `peak-sale-2026.11`) con:
+
+* 🏁 10 feature flags en LaunchDarkly, Statsig y Firebase
+* 🛒 Flags de alto riesgo de checkout, venta flash y envío el mismo día
+* 🚧 Bloqueadores y advertencias de políticas (brechas de dependencias, violaciones de canary)
+* 🔗 Comprobaciones del grafo de dependencias
+* 🧾 Comparación de snapshots
+* 📄 Exportación de runbook en PDF
+* 🔌 Generación de payloads para GitHub, Jira y Slack
+* 🧯 Flujo de rollback con kill-switch para el estado de la demo
+* 💰 Estimación de impacto financiero para la ventana de despliegue de tráfico pico
+
+---
+
+## 🧠 Funciones principales
+
+### 🚦 Analizador de riesgo de release
+
+Compass Ultra revisa el workspace de release actual y devuelve una evaluación práctica del release:
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+Impulsado por un servicio de IA en vivo con un fallback determinista — el análisis nunca se bloquea aunque el servicio de IA no esté disponible.
+
+Puede detectar problemas como:
+
+* 🔥 Flags activos de alto riesgo
+* 🔗 Conflictos de dependencias
+* 👻 Aprobadores faltantes
+* ⏰ Flags caducados o sin propietario
+* 🐤 Violaciones de despliegue canary
+* 🚨 Overrides en producción
+* 🧾 Patrones de despliegue sensibles al cumplimiento
+* 💰 Estimaciones de impacto financiero para ventanas de despliegue de tráfico pico
+
+---
+
+### 🎯 Motor de evaluación de flags
+
+Evalúa cada flag contra un contexto de usuario específico.
+
+| Campo | Descripción |
+| --- | --- |
+| 👤 User key | Identificador único del usuario |
+| 📧 Email | Dirección de correo del usuario |
+| 🏢 Tenant | Tenant de cliente o cuenta |
+| 💳 Plan | Plan de precios o de derechos |
+| 🛂 Role | Rol del usuario o grupo de permisos |
+| 🌎 Region | Región geográfica o de infraestructura |
+| 🏳️ Country | Segmentación a nivel de país |
+| 📱 Device | Tipo de dispositivo o plataforma |
+| 🌐 Environment | Desarrollo, staging, producción o entorno personalizado |
+
+Cada flag muestra:
+
+* 🎚️ Valor evaluado
+* 🧠 Motivo de resolución (coincidencia de regla, bucket de rollout, valor por defecto u override)
+* 🧩 Regla o condición coincidente
+* 📌 Contexto relevante usado durante la evaluación
+
+Cambia entre presets de contexto guardados — Production admin, EU customer, Mobile guest — para ver cómo se comportan los flags por segmento.
+
+---
+
+### 🛡️ Compuertas de políticas empresariales (9 comprobaciones)
+
+Compass Ultra ejecuta comprobaciones automatizadas de release en cada cambio de estado del workspace.
+
+| 🔒 Gate | Qué comprueba |
+| --- | --- |
+| 🎟️ Change ticket attached | El ticket CHG o Jira está presente antes de producción |
+| 👥 Critical flags have approvers | Todos los flags activos de alta/crítica prioridad tienen aprobadores nombrados |
+| 🧬 Every flag has traceability | Todos los flags tienen IDs de Jira/cambio |
+| ⏳ No expired flags enabled | Ningún flag habilitado ha superado su caducidad |
+| 🚫 Production override discipline | No hay overrides manuales activos en producción |
+| 🐤 Canary rollout limit | Los flags que requieren canary permanecen dentro del 50% de rollout |
+| 🔗 Dependencies enabled | Ningún flag habilitado tiene una dependencia deshabilitada |
+| 🔌 Live provider adapters configured | Al menos un token de proveedor está conectado |
+| 📤 Outbound DevOps hooks configured | Los endpoints de GitHub/Jira/Slack están configurados |
+
+---
+
+### 🤖 Widget de chat AI DevOps
+
+Un asistente de chat con IA flotante que puede incrustarse en cualquier página con una sola etiqueta script:
+
+```html
+
+```
+
+* 💬 Haz preguntas sobre releases en lenguaje natural
+* 🔍 Lee automáticamente el estado del workspace en vivo
+* 📊 El contador de sesión muestra cuántos visitantes lo han usado
+* ⚡ Fallback elegante cuando el servicio de IA no está disponible
+* 🧠 Mantiene el historial del chat entre mensajes en la misma sesión
+
+Pruébalo en vivo: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 Integraciones de proveedores (sincronización de solo lectura)
+
+Importa el estado de flags en vivo desde tu proveedor de flags mediante un token de solo lectura propiedad del cliente a través del proxy del servidor.
+
+| 🏴 Provider | Type |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 Las claves API nunca salen del proxy del backend. El navegador solo llama a la API de Compass Ultra.
+
+---
+
+### 📤 Integraciones DevOps salientes
+
+Copia de payload con un clic o POST a tus herramientas existentes:
+
+| 🔌 Integration | Type |
+| --- | --- |
+| 🐙 GitHub Issues | Release evidence issue |
+| 🎫 Jira Change | CHG ticket update |
+| 💬 Slack War Room | Release blocks / rich message |
+
+---
+
+### 🔍 Diff de snapshots
+
+Compara dos puntos de control de release y ve exactamente qué cambió.
+
+Los diffs pueden identificar:
+
+* ➕ Flags añadidos
+* ➖ Flags eliminados
+* 📈 Cambios de rollout
+* 🚨 Cambios de criticidad
+* 👤 Cambios de propietario o aprobador
+* 🛠️ Cambios de override
+
+---
+
+### 📄 Runbooks y certificados de release en PDF
+
+Exporta PDFs listos para CAB para QA, liderazgo, DevOps o revisión de auditoría.
+
+Los runbooks incluyen:
+
+* 🏷️ Metadatos de release y ventana de despliegue
+* 🎯 Evaluaciones de flags y estados de rollout
+* 🛡️ Resultados de compuertas de políticas
+* 🧠 Resumen de riesgo e impacto financiero
+* 🧯 Notas de rollback por flag
+* ✍️ Lista de firmas de aprobadores
+* 🧾 Historial de auditoría
+
+---
+
+### 🐙 Compuerta CI de GitHub Action
+
+Bloquea despliegues en CI cuando el riesgo de release supera un umbral configurado:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 La acción falla el workflow automáticamente si se encuentran bloqueadores — se acabó el "se nos olvidó revisar los flags antes de hacer merge".
+
+---
+
+### 👥 RBAC (4 roles)
+
+| 🎭 Role | Permissions |
+| --- | --- |
+| 🔑 Admin | Full access — flags, release, team, integrations |
+| ✅ Approver | Approve releases, view all |
+| 🛠️ Operator | Edit flags and release metadata |
+| 👁️ Viewer | Read only |
+
+Todas las acciones bloqueadas se registran con actor, rol, compuerta activada y marca de tiempo exacta.
+
+---
+
+## 🧭 Posicionamiento del producto
+
+Compass Ultra **no** es un proveedor de feature flags.
+
+Es la **capa de revisión de release** alrededor de los feature flags.
+
+Úsalo cuando necesites una respuesta clara a:
+
+> "¿Podemos desplegar con seguridad este release con feature flags y demostrarlo?"
+
+---
+
+## 💸 Precios
+
+| Plan | Precio | Asientos | Ideal para |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | Solo local | Probar el workspace y la revisión de release local |
+| 🧍 Solo | $49/mo | 1 seat | Operadores en solitario que necesitan sincronización en la nube, análisis de riesgo, snapshots y exportaciones |
+| 🚀 Pro | $149/mo | Up to 5 seats | Equipos pequeños que necesitan revisión de release compartida y diffs |
+| 👥 Team | $299/mo | Up to 15 seats | Equipos de release que necesitan RBAC, exportación de auditoría, alertas y flujos de trabajo organizacionales |
+| 🏢 Enterprise | Custom | Custom | Revisión de seguridad, onboarding, términos personalizados e integraciones |
+
+Los planes de pago comienzan con una **prueba gratuita de 7 días**.
+
+No se requiere tarjeta de crédito. Las pruebas bajan a Free automáticamente a menos que el cliente se suscriba.
+
+---
+
+## 🛠️ Stack tecnológico
+
+| Capa | Tecnología |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 Código fuente
+
+Este repositorio público contiene la página de lanzamiento de Compass Ultra, documentación, activos de GitHub Pages y materiales del proyecto de cara al público.
+
+La aplicación de producción y el backend se mantienen por separado. Los usuarios públicos pueden explorar la app en vivo y la demo sin necesitar acceso a repositorios de implementación privados.
+
+---
+
+## 🔒 Modelo de seguridad
+
+Compass Ultra está diseñado como una capa de revisión de release.
+
+* 🧪 La demo local funciona sin inicio de sesión.
+* 🔐 Los snapshots en la nube requieren autenticación.
+* 🔌 La sincronización de proveedores usa tokens de solo lectura a través del proxy del backend — las claves API nunca pasan por el navegador.
+* 🛡️ Cabeceras de seguridad en todas las respuestas: `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 Stripe gestiona los datos de tarjeta.
+* 🪪 Auth0 es el proveedor de identidad.
+* 🔗 Los enlaces compartidos codifican el estado del workspace y no deben usarse para secretos.
+* 🏢 Los clientes Enterprise deben usar revisión de seguridad y términos personalizados antes del despliegue en vivo con proveedores.
+
+---
+
+## 🗺️ Hoja de ruta
+
+* 🧾 Límites de asientos aplicados completamente en el backend
+* 🧪 Automatización del ciclo de vida de prueba sin tarjeta
+* 🚦 Controles contra abuso de prueba por correo, dominio y uso
+* 👥 Flujo de invitación de equipo
+* 🏢 Workspaces organizacionales
+* 🔌 Más adaptadores de proveedores
+* 💬 Flujo de trabajo de la app de Slack
+* 🐙 Expansión de la compuerta de release de GitHub Action
+* 📤 Más formatos de exportación
+* 🔒 Paquete de revisión de seguridad para Enterprise
+* 📊 Conteos de sesión y mensajes del backend en vivo para el widget AI DevOps
+
+---
+
+## ✅ Estado
+
+Compass Ultra está en vivo:
+
+**Production:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 Creado para
+
+Equipos que despliegan rápido y aún necesitan evidencia antes de producción.
+
+**Despliega con confianza. Revisa con evidencia. Demuestra cada release.** 🧭
\ No newline at end of file
diff --git a/README.fr.md b/README.fr.md
new file mode 100644
index 0000000..69b6b49
--- /dev/null
+++ b/README.fr.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **Intelligence de release pour les équipes qui livrent derrière des feature flags.**
+
+
+
+
+ 
+
+
+
+
+
+
+
+
+
+Compass Ultra est une salle de contrôle de release pour les logiciels pilotés par feature flags. Examinez l'état des flags, les portes de politique, le risque de déploiement, les diffs de snapshots, l'analyse de risque assistée par IA et les preuves de release prêtes pour l'audit — avant que les changements en production ne soient effectifs.
+
+[🚀 Live App](https://www.compassultra.com) · [🎮 Try the Demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ Pourquoi Compass Ultra ?
+
+Les feature flags sont censés rendre les releases plus sûres.
+
+Mais avec le temps, ils peuvent devenir une surface de release à part entière :
+
+* 🧟 Flags obsolètes ou expirés
+* 🎲 Pourcentages de déploiement risqués
+* 👤 Propriétaires et approbateurs manquants
+* 🕸️ Dépendances cachées entre flags
+* 🚨 Overrides en production
+* 💬 Fils Slack faisant office de piste d'audit
+* 🧩 Décisions de release dispersées dans trop d'outils
+
+**Compass Ultra transforme le chaos des feature flags en un flux de revue de release reproductible.**
+
+Au lieu de demander :
+
+> « Est-ce qu'on peut livrer ? »
+
+Votre équipe peut répondre :
+
+* ✅ Qu'est-ce qui est activé ?
+* 👥 Qui est affecté ?
+* 🔄 Qu'est-ce qui a changé ?
+* 💥 Qu'est-ce qui peut casser ?
+* 🖊️ Qui l'a approuvé ?
+* 🧯 Qu'est-ce qu'il faut corriger en premier ?
+* 📄 Quelle preuve pouvons-nous remettre à QA, DevOps, la direction ou la conformité ?
+
+---
+
+## ⚡ La version courte
+
+Compass Ultra aide les équipes à examiner et prouver la préparation au release avant la livraison.
+
+Une revue de release typique ressemble à ceci :
+
+1. 📦 Charger ou importer un workspace de release.
+2. 👤 Évaluer les flags selon un contexte utilisateur réel.
+3. 🛡️ Exécuter les portes de politique et l'analyse de risque.
+4. 🔍 Comparer les snapshots de release.
+5. 📄 Exporter un runbook de release.
+6. 🚀 Partager la preuve avant que les changements en production ne soient effectifs.
+
+---
+
+## 🎮 Démo en direct
+
+La démo fonctionne sans compte :
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+La démo simule une release retail à haut risque (veille du Black Friday, `peak-sale-2026.11`) avec :
+
+* 🏁 10 feature flags sur LaunchDarkly, Statsig et Firebase
+* 🛒 Flags à haut risque pour le checkout, les ventes flash et la livraison le jour même
+* 🚧 Bloqueurs et avertissements de politique (lacunes de dépendances, violations canary)
+* 🔗 Vérifications du graphe de dépendances
+* 🧾 Comparaison de snapshots
+* 📄 Export de runbook PDF
+* 🔌 Génération de payloads GitHub, Jira et Slack
+* 🧯 Flux de rollback kill-switch pour l'état de la démo
+* 💰 Estimation d'impact financier pour la fenêtre de déploiement à trafic de pointe
+
+---
+
+## 🧠 Fonctionnalités principales
+
+### 🚦 Analyseur de risque de release
+
+Compass Ultra examine le workspace de release actuel et renvoie une évaluation pratique du release :
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+Alimenté par un service IA en direct avec un repli déterministe — l'analyse n'est jamais bloquée même lorsque le service IA est indisponible.
+
+Il peut détecter des problèmes tels que :
+
+* 🔥 Flags actifs à haut risque
+* 🔗 Conflits de dépendances
+* 👻 Approbateurs manquants
+* ⏰ Flags expirés ou sans propriétaire
+* 🐤 Violations de déploiement canary
+* 🚨 Overrides en production
+* 🧾 Modèles de déploiement sensibles à la conformité
+* 💰 Estimations d'impact financier pour les fenêtres de déploiement à trafic de pointe
+
+---
+
+### 🎯 Moteur d'évaluation des flags
+
+Évaluez chaque flag selon un contexte utilisateur spécifique.
+
+| Champ | Description |
+| --- | --- |
+| 👤 User key | Identifiant utilisateur unique |
+| 📧 Email | Adresse e-mail de l'utilisateur |
+| 🏢 Tenant | Tenant client ou compte |
+| 💳 Plan | Plan tarifaire ou de droits |
+| 🛂 Role | Rôle utilisateur ou groupe de permissions |
+| 🌎 Region | Région géographique ou d'infrastructure |
+| 🏳️ Country | Ciblage au niveau pays |
+| 📱 Device | Type d'appareil ou de plateforme |
+| 🌐 Environment | Développement, staging, production ou environnement personnalisé |
+
+Chaque flag affiche :
+
+* 🎚️ Valeur évaluée
+* 🧠 Raison de résolution (correspondance de règle, bucket de rollout, valeur par défaut ou override)
+* 🧩 Règle ou condition correspondante
+* 📌 Contexte pertinent utilisé pendant l'évaluation
+
+Basculez entre les préréglages de contexte enregistrés — Production admin, EU customer, Mobile guest — pour voir comment les flags se comportent par segment.
+
+---
+
+### 🛡️ Portes de politique entreprise (9 vérifications)
+
+Compass Ultra exécute des vérifications de release automatisées à chaque changement d'état du workspace.
+
+| 🔒 Gate | Ce qu'elle vérifie |
+| --- | --- |
+| 🎟️ Change ticket attached | Un ticket CHG ou Jira est présent avant la production |
+| 👥 Critical flags have approvers | Tous les flags actifs haute/critique ont des approbateurs nommés |
+| 🧬 Every flag has traceability | Tous les flags ont des IDs Jira/changement |
+| ⏳ No expired flags enabled | Aucun flag activé n'est au-delà de son expiration |
+| 🚫 Production override discipline | Aucun override manuel actif en production |
+| 🐤 Canary rollout limit | Les flags nécessitant un canary restent dans une limite de rollout de 50 % |
+| 🔗 Dependencies enabled | Aucun flag activé n'a de dépendance désactivée |
+| 🔌 Live provider adapters configured | Au moins un jeton de fournisseur est connecté |
+| 📤 Outbound DevOps hooks configured | Les endpoints GitHub/Jira/Slack sont configurés |
+
+---
+
+### 🤖 Widget de chat AI DevOps
+
+Un assistant de chat IA flottant qui peut être intégré sur n'importe quelle page avec une seule balise script :
+
+```html
+
+```
+
+* 💬 Posez des questions sur les releases en langage naturel
+* 🔍 Lit automatiquement l'état du workspace en direct
+* 📊 Le compteur de session indique combien de visiteurs l'ont utilisé
+* ⚡ Repli gracieux lorsque le service IA est indisponible
+* 🧠 Conserve l'historique du chat entre les messages de la même session
+
+Essayez-le en direct : [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 Intégrations fournisseurs (synchronisation en lecture seule)
+
+Importez l'état des flags en direct depuis votre fournisseur de flags via un jeton en lecture seule appartenant au client, via le proxy serveur.
+
+| 🏴 Provider | Type |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 Les clés API ne quittent jamais le proxy backend. Le navigateur n'appelle que l'API Compass Ultra.
+
+---
+
+### 📤 Intégrations DevOps sortantes
+
+Copie de payload en un clic ou POST vers vos outils existants :
+
+| 🔌 Integration | Type |
+| --- | --- |
+| 🐙 GitHub Issues | Release evidence issue |
+| 🎫 Jira Change | CHG ticket update |
+| 💬 Slack War Room | Release blocks / rich message |
+
+---
+
+### 🔍 Diff de snapshots
+
+Comparez deux points de contrôle de release et voyez exactement ce qui a changé.
+
+Les diffs peuvent identifier :
+
+* ➕ Flags ajoutés
+* ➖ Flags supprimés
+* 📈 Changements de rollout
+* 🚨 Changements de criticité
+* 👤 Changements de propriétaire ou d'approbateur
+* 🛠️ Changements d'override
+
+---
+
+### 📄 Runbooks et certificats de release PDF
+
+Exportez des PDF prêts pour le CAB pour QA, la direction, DevOps ou la revue d'audit.
+
+Les runbooks incluent :
+
+* 🏷️ Métadonnées de release et fenêtre de déploiement
+* 🎯 Évaluations de flags et états de rollout
+* 🛡️ Résultats des portes de politique
+* 🧠 Résumé des risques et impact financier
+* 🧯 Notes de rollback par flag
+* ✍️ Liste des signatures des approbateurs
+* 🧾 Historique d'audit
+
+---
+
+### 🐙 Porte CI GitHub Action
+
+Bloquez les déploiements en CI lorsque le risque de release dépasse un seuil configuré :
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 L'action fait échouer le workflow automatiquement si des bloqueurs sont trouvés — fini le « on a oublié de vérifier les flags avant le merge ».
+
+---
+
+### 👥 RBAC (4 rôles)
+
+| 🎭 Role | Permissions |
+| --- | --- |
+| 🔑 Admin | Full access — flags, release, team, integrations |
+| ✅ Approver | Approve releases, view all |
+| 🛠️ Operator | Edit flags and release metadata |
+| 👁️ Viewer | Read only |
+
+Toutes les actions bloquées sont journalisées avec l'acteur, le rôle, la porte déclenchée et l'horodatage exact.
+
+---
+
+## 🧭 Positionnement produit
+
+Compass Ultra **n'est pas** un fournisseur de feature flags.
+
+C'est la **couche de revue de release** autour des feature flags.
+
+Utilisez-le lorsque vous avez besoin d'une réponse claire à :
+
+> « Pouvons-nous livrer en toute sécurité cette release avec feature flags, et pouvons-nous le prouver ? »
+
+---
+
+## 💸 Tarification
+
+| Plan | Prix | Sièges | Idéal pour |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | Local only | Essayer le workspace et la revue de release locale |
+| 🧍 Solo | $49/mo | 1 seat | Opérateurs solo ayant besoin de sync cloud, analyse de risque, snapshots et exports |
+| 🚀 Pro | $149/mo | Up to 5 seats | Petites équipes ayant besoin de revue de release partagée et de diffs |
+| 👥 Team | $299/mo | Up to 15 seats | Équipes de release ayant besoin de RBAC, export d'audit, alertes et workflows organisationnels |
+| 🏢 Enterprise | Custom | Custom | Revue de sécurité, onboarding, conditions personnalisées et intégrations |
+
+Les plans payants commencent par un **essai gratuit de 7 jours**.
+
+Aucune carte de crédit requise. Les essais repassent automatiquement en Free sauf si le client s'abonne.
+
+---
+
+## 🛠️ Stack technique
+
+| Couche | Technologie |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 Code source
+
+Ce dépôt public contient la page de lancement Compass Ultra, la documentation, les assets GitHub Pages et les supports publics du projet.
+
+L'application de production et le backend sont maintenus séparément. Les utilisateurs publics peuvent explorer l'app en direct et la démo sans accès aux dépôts d'implémentation privés.
+
+---
+
+## 🔒 Modèle de sécurité
+
+Compass Ultra est conçu comme une couche de revue de release.
+
+* 🧪 La démo locale fonctionne sans connexion.
+* 🔐 Les snapshots cloud nécessitent une authentification.
+* 🔌 La synchronisation fournisseur utilise des jetons en lecture seule via le proxy backend — les clés API ne transitent jamais par le navigateur.
+* 🛡️ En-têtes de sécurité sur toutes les réponses : `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 Stripe gère les données de carte.
+* 🪪 Auth0 est le fournisseur d'identité.
+* 🔗 Les liens de partage encodent l'état du workspace et ne doivent pas être utilisés pour des secrets.
+* 🏢 Les clients Enterprise doivent utiliser une revue de sécurité et des conditions personnalisées avant le déploiement fournisseur en direct.
+
+---
+
+## 🗺️ Feuille de route
+
+* 🧾 Limites de sièges entièrement appliquées côté backend
+* 🧪 Automatisation du cycle de vie d'essai sans carte
+* 🚦 Contrôles anti-abus d'essai par e-mail, domaine et utilisation
+* 👥 Flux d'invitation d'équipe
+* 🏢 Workspaces organisationnels
+* 🔌 Plus d'adaptateurs fournisseurs
+* 💬 Workflow d'application Slack
+* 🐙 Extension de la porte de release GitHub Action
+* 📤 Plus de formats d'export
+* 🔒 Package de revue de sécurité pour Enterprise
+* 📊 Compteurs de sessions et messages backend en direct pour le widget AI DevOps
+
+---
+
+## ✅ Statut
+
+Compass Ultra est en ligne :
+
+**Production:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 Conçu pour
+
+Les équipes qui livrent vite et ont encore besoin de preuves avant la production.
+
+**Livrez en confiance. Revoyez avec des preuves. Prouvez chaque release.** 🧭
\ No newline at end of file
diff --git a/README.it.md b/README.it.md
new file mode 100644
index 0000000..0945ead
--- /dev/null
+++ b/README.it.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **Intelligence sulle release per i team che rilasciano dietro feature flag.**
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+Compass Ultra è una sala di controllo delle release per software basato su feature flag. Rivedi lo stato dei flag, i gate di policy, il rischio di rollout, i diff degli snapshot, l'analisi del rischio assistita dall'AI e la prova di release pronta per l'audit — prima che le modifiche in produzione vadano live.
+
+[🚀 App live](https://www.compassultra.com) · [🎮 Prova la demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ Perché Compass Ultra?
+
+Le feature flag dovrebbero rendere le release più sicure.
+
+Ma col tempo possono diventare una superficie di release a sé stante:
+
+* 🧟 Flag obsoleti o scaduti
+* 🎲 Percentuali di rollout rischiose
+* 👤 Proprietari e approvatori mancanti
+* 🕸️ Dipendenze nascoste tra flag
+* 🚨 Override in produzione
+* 💬 Thread Slack che fanno finta di essere audit trail
+* 🧩 Decisioni di release sparse su troppi strumenti
+
+**Compass Ultra trasforma il caos delle feature flag in un flusso di revisione release ripetibile.**
+
+Invece di chiedersi:
+
+> "Possiamo rilasciare?"
+
+Il team può rispondere:
+
+* ✅ Cosa è abilitato?
+* 👥 Chi è coinvolto?
+* 🔄 Cosa è cambiato?
+* 💥 Cosa può rompersi?
+* 🖊️ Chi l'ha approvato?
+* 🧯 Cosa va corretto prima?
+* 📄 Quale prova possiamo consegnare a QA, DevOps, leadership o compliance?
+
+---
+
+## ⚡ La versione breve
+
+Compass Ultra aiuta i team a rivedere e dimostrare la readiness della release prima del deploy.
+
+Una revisione release tipica funziona così:
+
+1. 📦 Carica o importa un workspace di release.
+2. 👤 Valuta i flag rispetto a un contesto utente reale.
+3. 🛡️ Esegui gate di policy e analisi del rischio.
+4. 🔍 Confronta gli snapshot di release.
+5. 📄 Esporta un runbook di release.
+6. 🚀 Condividi la prova prima che le modifiche in produzione vadano live.
+
+---
+
+## 🎮 Demo live
+
+La demo funziona senza account:
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+La demo simula una release retail rischiosa (vigilia del Black Friday, `peak-sale-2026.11`) con:
+
+* 🏁 10 feature flag su LaunchDarkly, Statsig e Firebase
+* 🛒 Flag ad alto rischio per checkout, flash sale e spedizione in giornata
+* 🚧 Blocchi e avvisi di policy (lacune nelle dipendenze, violazioni canary)
+* 🔗 Controlli del grafo delle dipendenze
+* 🧾 Confronto snapshot
+* 📄 Esportazione runbook PDF
+* 🔌 Generazione payload GitHub, Jira e Slack
+* 🧯 Flusso di rollback kill-switch per lo stato demo
+* 💰 Stima dell'impatto finanziario per la finestra di deploy a traffico di picco
+
+---
+
+## 🧠 Funzionalità principali
+
+### 🚦 Analizzatore del rischio di release
+
+Compass Ultra rivede il workspace di release corrente e restituisce una valutazione pratica:
+
+* ✅ **Rilascia**
+* 🟡 **In attesa**
+* 🔴 **Correggi prima**
+
+Alimentato da un servizio AI live con fallback deterministico — l'analisi non viene mai bloccata anche quando il servizio AI non è disponibile.
+
+Può rilevare problemi come:
+
+* 🔥 Flag attivi ad alto rischio
+* 🔗 Conflitti di dipendenze
+* 👻 Approvatori mancanti
+* ⏰ Flag scaduti o senza proprietario
+* 🐤 Violazioni del rollout canary
+* 🚨 Override in produzione
+* 🧾 Pattern di rollout sensibili per la compliance
+* 💰 Stime dell'impatto finanziario per finestre di deploy a traffico di picco
+
+---
+
+### 🎯 Motore di valutazione dei flag
+
+Valuta ogni flag rispetto a un contesto utente specifico.
+
+| Campo | Descrizione |
+| --- | --- |
+| 👤 User key | Identificatore utente univoco |
+| 📧 Email | Indirizzo email utente |
+| 🏢 Tenant | Tenant cliente o account |
+| 💳 Plan | Piano tariffario o di entitlement |
+| 🛂 Role | Ruolo utente o gruppo di permessi |
+| 🌎 Region | Regione geografica o infrastrutturale |
+| 🏳️ Country | Targeting a livello paese |
+| 📱 Device | Tipo di dispositivo o piattaforma |
+| 🌐 Environment | Sviluppo, staging, produzione o ambiente personalizzato |
+
+Ogni flag mostra:
+
+* 🎚️ Valore valutato
+* 🧠 Motivo della risoluzione (match regola, bucket rollout, default o override)
+* 🧩 Regola o condizione corrispondente
+* 📌 Contesto rilevante usato durante la valutazione
+
+Passa tra preset di contesto salvati — Production admin, EU customer, Mobile guest — per vedere come i flag si comportano per segmento.
+
+---
+
+### 🛡️ Gate di policy enterprise (9 controlli)
+
+Compass Ultra esegue controlli automatici di release ad ogni cambiamento dello stato del workspace.
+
+| 🔒 Gate | Cosa controlla |
+| --- | --- |
+| 🎟️ Ticket di change allegato | Ticket CHG o Jira presente prima della produzione |
+| 👥 Flag critici con approvatori | Tutti i flag attivi ad alto/critico rischio hanno approvatori nominati |
+| 🧬 Ogni flag ha tracciabilità | Tutti i flag hanno ID Jira/change |
+| ⏳ Nessun flag scaduto abilitato | Nessun flag abilitato oltre la scadenza |
+| 🚫 Disciplina override in produzione | Nessun override manuale attivo in produzione |
+| 🐤 Limite rollout canary | I flag che richiedono canary restano entro il 50% di rollout |
+| 🔗 Dipendenze abilitate | Nessun flag abilitato ha una dipendenza disabilitata |
+| 🔌 Adapter provider live configurati | Almeno un token provider connesso |
+| 📤 Hook DevOps outbound configurati | Endpoint GitHub/Jira/Slack impostati |
+
+---
+
+### 🤖 Widget chat AI DevOps
+
+Un assistente chat AI flottante incorporabile in qualsiasi pagina con un singolo tag script:
+
+```html
+
+```
+
+* 💬 Fai domande sulle release in linguaggio naturale
+* 🔍 Legge automaticamente lo stato live del workspace
+* 📊 Contatore sessione mostra quanti visitatori l'hanno usato
+* ⚡ Fallback elegante quando il servizio AI non è disponibile
+* 🧠 Mantiene la cronologia chat tra i messaggi nella stessa sessione
+
+Provalo live: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 Integrazioni provider (sincronizzazione read-only)
+
+Importa lo stato live dei flag dal tuo provider tramite un token read-only di proprietà del cliente attraverso il proxy server.
+
+| 🏴 Provider | Tipo |
+| --- | --- |
+| 🚀 LaunchDarkly | Sincronizzazione provider |
+| 📊 Statsig | Sincronizzazione provider |
+| 🔓 Unleash | Sincronizzazione provider |
+| 🏳️ Flagsmith | Sincronizzazione provider |
+| 🔥 Firebase Remote Config | Sincronizzazione provider |
+
+🔒 Le chiavi API non lasciano mai il proxy backend. Il browser chiama solo l'API Compass Ultra.
+
+---
+
+### 📤 Integrazioni DevOps outbound
+
+Copia payload con un clic o POST verso i tuoi strumenti esistenti:
+
+| 🔌 Integrazione | Tipo |
+| --- | --- |
+| 🐙 GitHub Issues | Issue di evidenza release |
+| 🎫 Jira Change | Aggiornamento ticket CHG |
+| 💬 Slack War Room | Blocchi release / messaggio ricco |
+
+---
+
+### 🔍 Snapshot Diff
+
+Confronta due checkpoint di release e vedi esattamente cosa è cambiato.
+
+I diff possono identificare:
+
+* ➕ Flag aggiunti
+* ➖ Flag rimossi
+* 📈 Modifiche al rollout
+* 🚨 Modifiche alla criticità
+* 👤 Modifiche a proprietario o approvatore
+* 🛠️ Modifiche agli override
+
+---
+
+### 📄 Runbook e certificati PDF di release
+
+Esporta PDF pronti per CAB per QA, leadership, DevOps o revisione audit.
+
+I runbook includono:
+
+* 🏷️ Metadati release e finestra di deploy
+* 🎯 Valutazioni flag e stati di rollout
+* 🛡️ Risultati dei gate di policy
+* 🧠 Riepilogo rischi e impatto finanziario
+* 🧯 Note di rollback per flag
+* ✍️ Elenco firme approvatori
+* 🧾 Cronologia audit
+
+---
+
+### 🐙 Gate CI GitHub Action
+
+Blocca i deploy in CI quando il rischio di release supera una soglia configurata:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 L'action fa fallire automaticamente il workflow se vengono trovati blocker — niente più "ci siamo dimenticati di controllare i flag prima del merge."
+
+---
+
+### 👥 RBAC (4 ruoli)
+
+| 🎭 Ruolo | Permessi |
+| --- | --- |
+| 🔑 Admin | Accesso completo — flag, release, team, integrazioni |
+| ✅ Approver | Approva release, visualizza tutto |
+| 🛠️ Operator | Modifica flag e metadati release |
+| 👁️ Viewer | Solo lettura |
+
+Tutte le azioni bloccate vengono registrate con attore, ruolo, gate attivato e timestamp esatto.
+
+---
+
+## 🧭 Posizionamento del prodotto
+
+Compass Ultra **non** è un provider di feature flag.
+
+È il **layer di revisione release** intorno alle feature flag.
+
+Usalo quando ti serve una risposta chiara a:
+
+> "Possiamo rilasciare in sicurezza questa release con feature flag, e possiamo dimostrarlo?"
+
+---
+
+## 💸 Prezzi
+
+| Piano | Prezzo | Posti | Ideale per |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | Solo locale | Provare il workspace e la revisione release locale |
+| 🧍 Solo | $49/mese | 1 posto | Operatori singoli che necessitano sync cloud, analisi rischi, snapshot ed export |
+| 🚀 Pro | $149/mese | Fino a 5 posti | Piccoli team che necessitano revisione release condivisa e diff |
+| 👥 Team | $299/mese | Fino a 15 posti | Team release che necessitano RBAC, export audit, alert e workflow organizzativi |
+| 🏢 Enterprise | Personalizzato | Personalizzato | Security review, onboarding, termini personalizzati e integrazioni |
+
+I piani a pagamento iniziano con una **prova gratuita di 7 giorni**.
+
+Nessuna carta di credito richiesta. Le prove tornano automaticamente a Free a meno che il cliente non si abboni.
+
+---
+
+## 🛠️ Stack tecnologico
+
+| Layer | Tecnologia |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 Codice sorgente
+
+Questo repository pubblico contiene la pagina di lancio Compass Ultra, la documentazione, gli asset GitHub Pages e i materiali pubblici del progetto.
+
+L'applicazione di produzione e il backend sono mantenuti separatamente. Gli utenti pubblici possono esplorare l'app live e la demo senza accesso ai repository di implementazione privati.
+
+---
+
+## 🔒 Modello di sicurezza
+
+Compass Ultra è progettato come layer di revisione release.
+
+* 🧪 La demo locale funziona senza login.
+* 🔐 Gli snapshot cloud richiedono autenticazione.
+* 🔌 La sincronizzazione provider usa token read-only attraverso il proxy backend — le chiavi API non passano mai dal browser.
+* 🛡️ Header di sicurezza su tutte le risposte: `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 Stripe gestisce i dati delle carte.
+* 🪪 Auth0 è il provider di identità.
+* 🔗 I link di condivisione codificano lo stato del workspace e non vanno usati per segreti.
+* 🏢 I clienti enterprise dovrebbero usare security review e termini personalizzati prima del rollout provider live.
+
+---
+
+## 🗺️ Roadmap
+
+* 🧾 Limiti posti completamente applicati dal backend
+* 🧪 Automazione ciclo di vita prova senza carta
+* 🚦 Controlli anti-abuso prova per email, dominio e utilizzo
+* 👥 Flusso invito team
+* 🏢 Workspace organizzazione
+* 🔌 Più adapter provider
+* 💬 Workflow app Slack
+* 🐙 Espansione gate release GitHub Action
+* 📤 Più formati di export
+* 🔒 Pacchetto security review per Enterprise
+* 📊 Conteggi sessioni e messaggi backend live per widget AI DevOps
+
+---
+
+## ✅ Stato
+
+Compass Ultra è live:
+
+**Produzione:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 Pensato per
+
+Team che rilasciano velocemente e hanno comunque bisogno di prova prima della produzione.
+
+**Rilascia con fiducia. Rivedi con evidenza. Dimostra ogni release.** 🧭
\ No newline at end of file
diff --git a/README.ja.md b/README.ja.md
new file mode 100644
index 0000000..f5d0f55
--- /dev/null
+++ b/README.ja.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **フィーチャーフラグの裏でリリースするチーム向けのリリースインテリジェンス。**
+
+
+
+
+
+
+
+
+ 
+
+
+
+
+
+Compass Ultra は、フィーチャーフラグ付きソフトウェア向けのリリース管制室です。本番変更が公開される前に、フラグの状態、ポリシーゲート、ロールアウトリスク、スナップショット差分、AI 支援のリスク分析、監査対応のリリース証跡を確認できます。
+
+[🚀 ライブアプリ](https://www.compassultra.com) · [🎮 デモを試す](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ なぜ Compass Ultra か？
+
+フィーチャーフラグは、リリースをより安全にするはずです。
+
+しかし時間が経つと、それ自体がリリース面のリスクになることがあります：
+
+* 🧟 古い、または期限切れのフラグ
+* 🎲 リスクの高いロールアウト率
+* 👤 オーナーや承認者の欠如
+* 🕸️ 見えないフラグ依存関係
+* 🚨 本番環境のオーバーライド
+* 💬 Slack スレッドを監査証跡の代わりに使う
+* 🧩 リリース判断が多すぎるツールに分散
+
+**Compass Ultra は、フィーチャーフラグの混乱を、再現可能なリリースレビューワークフローに変えます。**
+
+こう聞くのではなく：
+
+> 「リリースして大丈夫？」
+
+チームは次のように答えられます：
+
+* ✅ 何が有効になっているか？
+* 👥 誰に影響するか？
+* 🔄 何が変わったか？
+* 💥 何が壊れる可能性があるか？
+* 🖊️ 誰が承認したか？
+* 🧯 先に何を修正すべきか？
+* 📄 QA、DevOps、経営層、コンプライアンスに何を証明できるか？
+
+---
+
+## ⚡ 短い説明
+
+Compass Ultra は、リリース前にリリース準備状況をレビューし、証明するのを支援します。
+
+典型的なリリースレビューは次の流れです：
+
+1. 📦 リリースワークスペースを読み込む、またはインポートする。
+2. 👤 実際のユーザーコンテキストに対してフラグを評価する。
+3. 🛡️ ポリシーゲートとリスク分析を実行する。
+4. 🔍 リリーススナップショットを比較する。
+5. 📄 リリースランブックをエクスポートする。
+6. 🚀 本番変更が公開される前に証跡を共有する。
+
+---
+
+## 🎮 ライブデモ
+
+デモはアカウント不要で利用できます：
+
+**デモ：** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+デモは、小売向けの高リスクリリース（ブラックフライデー前夜、`peak-sale-2026.11`）をシミュレートします：
+
+* 🏁 LaunchDarkly、Statsig、Firebase にまたがる 10 個のフィーチャーフラグ
+* 🛒 高リスクのチェックアウト、フラッシュセール、当日配送フラグ
+* 🚧 ポリシーブロッカーと警告（依存関係の欠落、カナリア違反）
+* 🔗 依存関係グラフのチェック
+* 🧾 スナップショット比較
+* 📄 PDF ランブックのエクスポート
+* 🔌 GitHub、Jira、Slack ペイロード生成
+* 🧯 デモ状態向けの kill-switch ロールバックフロー
+* 💰 ピークトラフィック時のデプロイウィンドウにおける財務影響の見積もり
+
+---
+
+## 🧠 コア機能
+
+### 🚦 リリースリスクアナライザー
+
+Compass Ultra は現在のリリースワークスペースをレビューし、実用的なリリース評価を返します：
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+ライブ AI サービスと決定論的フォールバックで動作 — AI サービスが利用できない場合でも、分析はブロックされません。
+
+次のような問題を検出できます：
+
+* 🔥 高リスクの有効フラグ
+* 🔗 依存関係の競合
+* 👻 承認者の欠如
+* ⏰ 期限切れ、またはオーナーのないフラグ
+* 🐤 カナリアロールアウト違反
+* 🚨 本番環境のオーバーライド
+* 🧾 コンプライアンスに敏感なロールアウトパターン
+* 💰 ピークトラフィック時のデプロイウィンドウにおける財務影響の見積もり
+
+---
+
+### 🎯 フラグ評価エンジン
+
+特定のユーザーコンテキストに対してすべてのフラグを評価します。
+
+| フィールド | 説明 |
+| --- | --- |
+| 👤 User key | 一意のユーザー識別子 |
+| 📧 Email | ユーザーのメールアドレス |
+| 🏢 Tenant | 顧客またはアカウントのテナント |
+| 💳 Plan | 料金またはエンタイトルメントプラン |
+| 🛂 Role | ユーザーロールまたは権限グループ |
+| 🌎 Region | 地理的、またはインフラ領域 |
+| 🏳️ Country | 国レベルのターゲティング |
+| 📱 Device | デバイスまたはプラットフォーム種別 |
+| 🌐 Environment | 開発、ステージング、本番、またはカスタム環境 |
+
+各フラグには次が表示されます：
+
+* 🎚️ 評価値
+* 🧠 解決理由（ルール一致、ロールアウトバケット、デフォルト、またはオーバーライド）
+* 🧩 一致したルールまたは条件
+* 📌 評価時に使用された関連コンテキスト
+
+保存済みのコンテキストプリセット — Production admin、EU customer、Mobile guest — を切り替えて、セグメントごとのフラグの挙動を確認できます。
+
+---
+
+### 🛡️ エンタープライズポリシーゲート（9 チェック）
+
+Compass Ultra は、ワークスペース状態が変わるたびに自動リリースチェックを実行します。
+
+| 🔒 ゲート | チェック内容 |
+| --- | --- |
+| 🎟️ Change ticket attached | 本番前に CHG または Jira チケットが存在する |
+| 👥 Critical flags have approvers | 高/クリティカルな有効フラグすべてに承認者が指定されている |
+| 🧬 Every flag has traceability | すべてのフラグに Jira/変更 ID がある |
+| ⏳ No expired flags enabled | 有効化された期限切れフラグがない |
+| 🚫 Production override discipline | 本番環境に手動オーバーライドがない |
+| 🐤 Canary rollout limit | カナリア必須フラグは 50% ロールアウト以内 |
+| 🔗 Dependencies enabled | 有効フラグに無効な依存関係がない |
+| 🔌 Live provider adapters configured | 少なくとも 1 つのプロバイダートークンが接続されている |
+| 📤 Outbound DevOps hooks configured | GitHub/Jira/Slack エンドポイントが設定されている |
+
+---
+
+### 🤖 AI DevOps チャットウィジェット
+
+1 つのスクリプトタグで任意のページに埋め込める、フローティング AI チャットアシスタント：
+
+```html
+
+```
+
+* 💬 自然言語でリリースに関する質問ができる
+* 🔍 ライブワークスペース状態を自動で読み取る
+* 📊 セッションカウンターで利用した訪問者数を表示
+* ⚡ AI サービスが利用できない場合の優雅なフォールバック
+* 🧠 同一セッション内でメッセージ間のチャット履歴を保持
+
+ライブで試す：[https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 プロバイダー統合（読み取り専用同期）
+
+サーバープロキシ経由で、顧客所有の読み取り専用トークンを使い、フラグプロバイダーからライブフラグ状態をインポートします。
+
+| 🏴 Provider | 種別 |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 API キーはバックエンドプロキシから出ません。ブラウザは Compass Ultra API のみを呼び出します。
+
+---
+
+### 📤 アウトバウンド DevOps 統合
+
+ワンクリックでペイロードをコピー、または既存ツールへ POST：
+
+| 🔌 Integration | 種別 |
+| --- | --- |
+| 🐙 GitHub Issues | リリース証跡 issue |
+| 🎫 Jira Change | CHG チケット更新 |
+| 💬 Slack War Room | リリースブロック / リッチメッセージ |
+
+---
+
+### 🔍 スナップショット差分
+
+2 つのリリースチェックポイントを比較し、何が変わったかを正確に確認できます。
+
+差分で識別できる内容：
+
+* ➕ 追加されたフラグ
+* ➖ 削除されたフラグ
+* 📈 ロールアウト変更
+* 🚨 クリティカル度の変更
+* 👤 オーナーまたは承認者の変更
+* 🛠️ オーバーライド変更
+
+---
+
+### 📄 PDF リリースランブックと証明書
+
+QA、経営層、DevOps、監査レビュー向けに CAB 対応の PDF をエクスポートできます。
+
+ランブックには次が含まれます：
+
+* 🏷️ リリースメタデータとデプロイウィンドウ
+* 🎯 フラグ評価とロールアウト状態
+* 🛡️ ポリシーゲート結果
+* 🧠 リスクサマリーと財務影響
+* 🧯 フラグごとのロールバックメモ
+* ✍️ 承認者サインオフ一覧
+* 🧾 監査履歴
+
+---
+
+### 🐙 GitHub Action CI ゲート
+
+リリースリスクが設定閾値を超えた場合、CI でデプロイをブロックします：
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 ブロッカーが見つかった場合、アクションはワークフローを自動的に失敗させます — 「マージ前にフラグを確認し忘れた」はもうありません。
+
+---
+
+### 👥 RBAC（4 ロール）
+
+| 🎭 Role | 権限 |
+| --- | --- |
+| 🔑 Admin | フルアクセス — フラグ、リリース、チーム、統合 |
+| ✅ Approver | リリース承認、すべて閲覧 |
+| 🛠️ Operator | フラグとリリースメタデータの編集 |
+| 👁️ Viewer | 読み取り専用 |
+
+ブロックされたすべてのアクションは、実行者、ロール、トリガーされたゲート、正確なタイムスタンプとともに記録されます。
+
+---
+
+## 🧭 プロダクトポジショニング
+
+Compass Ultra はフィーチャーフラグプロバイダー**ではありません**。
+
+フィーチャーフラグを取り巻く**リリースレビューレイヤー**です。
+
+次の問いに明確に答える必要があるときに使ってください：
+
+> 「このフィーチャーフラグ付きリリースを安全に出せるか、そしてそれを証明できるか？」
+
+---
+
+## 💸 料金
+
+| プラン | 価格 | シート | 最適な用途 |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | ローカルのみ | ワークスペースとローカルリリースレビューの試用 |
+| 🧍 Solo | $49/mo | 1 シート | クラウド同期、リスク分析、スナップショット、エクスポートが必要な個人運用者 |
+| 🚀 Pro | $149/mo | 最大 5 シート | 共有リリースレビューと差分比較が必要な小規模チーム |
+| 👥 Team | $299/mo | 最大 15 シート | RBAC、監査エクスポート、アラート、組織ワークフローが必要なリリースチーム |
+| 🏢 Enterprise | Custom | Custom | セキュリティレビュー、オンボーディング、カスタム条項、統合 |
+
+有料プランは **7 日間の無料トライアル** から始まります。
+
+クレジットカードは不要です。顧客が契約しない限り、トライアルは自動的に Free にダウングレードされます。
+
+---
+
+## 🛠️ 技術スタック
+
+| レイヤー | 技術 |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | バックエンドリポジトリの Express API |
+| 🐘 Database | バックエンド経由の PostgreSQL |
+| 🤖 AI risk analysis | 決定論的フォールバック付きバックエンド AI サービス |
+| ☁️ Hosting | Vercel（フロントエンド）· Railway（バックエンド） |
+
+---
+
+## 📦 ソースコード
+
+この公開リポジトリには、Compass Ultra のローンチページ、ドキュメント、GitHub Pages アセット、公開向けプロジェクト資料が含まれます。
+
+本番アプリケーションとバックエンドは別途管理されています。一般ユーザーは、非公開の実装リポジトリへのアクセスなしに、ライブアプリとデモを探索できます。
+
+---
+
+## 🔒 セキュリティモデル
+
+Compass Ultra はリリースレビューレイヤーとして設計されています。
+
+* 🧪 ローカルデモはログイン不要で動作します。
+* 🔐 クラウドスナップショットには認証が必要です。
+* 🔌 プロバイダー同期はバックエンドプロキシ経由の読み取り専用トークンを使用 — API キーはブラウザを通過しません。
+* 🛡️ すべてのレスポンスにセキュリティヘッダー：`X-Frame-Options`、`Content-Security-Policy`、`Strict-Transport-Security`、`X-Content-Type-Options`。
+* 💳 カードデータは Stripe が処理します。
+* 🪪 Auth0 が ID プロバイダーです。
+* 🔗 共有リンクはワークスペース状態をエンコードしており、機密情報には使用しないでください。
+* 🏢 エンタープライズ顧客は、ライブプロバイダーロールアウト前にセキュリティレビューとカスタム条項を行うべきです。
+
+---
+
+## 🗺️ ロードマップ
+
+* 🧾 バックエンドで強制されるシート制限
+* 🧪 カード不要トライアルライフサイクルの自動化
+* 🚦 メール、ドメイン、利用状況によるトライアル悪用対策
+* 👥 チーム招待フロー
+* 🏢 組織ワークスペース
+* 🔌 さらなるプロバイダーアダプター
+* 💬 Slack アプリワークフロー
+* 🐙 GitHub Action リリースゲートの拡張
+* 📤 さらなるエクスポート形式
+* 🔒 エンタープライズ向けセキュリティレビューパッケージ
+* 📊 AI DevOps ウィジェット向けのライブバックエンドセッション・メッセージ数
+
+---
+
+## ✅ ステータス
+
+Compass Ultra は稼働中です：
+
+**本番環境：** [https://www.compassultra.com](https://www.compassultra.com)
+
+**デモ：** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker：** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 対象ユーザー
+
+速くリリースしつつ、本番前に証明が必要なチーム。
+
+**自信を持ってリリース。証拠でレビュー。すべてのリリースを証明。** 🧭
\ No newline at end of file
diff --git a/README.ko.md b/README.ko.md
new file mode 100644
index 0000000..97cf231
--- /dev/null
+++ b/README.ko.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **기능 플래그 뒤에서 배포하는 팀을 위한 릴리스 인텔리전스.**
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+
+Compass Ultra는 기능 플래그 기반 소프트웨어를 위한 릴리스 컨트롤 룸입니다. 프로덕션 변경이 라이브되기 전에 플래그 상태, 정책 게이트, 롤아웃 위험, 스냅샷 diff, AI 지원 위험 분석, 감사 준비 릴리스 증빙을 검토하세요.
+
+[🚀 라이브 앱](https://www.compassultra.com) · [🎮 데모 체험](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ Compass Ultra를 선택하는 이유
+
+기능 플래그는 릴리스를 더 안전하게 만들기 위한 것입니다.
+
+하지만 시간이 지나면 그 자체가 릴리스 표면이 될 수 있습니다:
+
+* 🧟 오래되거나 만료된 플래그
+* 🎲 위험한 롤아웃 비율
+* 👤 누락된 소유자와 승인자
+* 🕸️ 숨겨진 플래그 의존성
+* 🚨 프로덕션 오버라이드
+* 💬 감사 추적을 대신하는 Slack 스레드
+* 🧩 너무 많은 도구에 흩어진 릴리스 결정
+
+**Compass Ultra는 기능 플래그 혼란을 반복 가능한 릴리스 검토 워크플로로 바꿉니다.**
+
+다음과 같이 묻는 대신:
+
+> "배포해도 괜찮을까?"
+
+팀은 다음에 답할 수 있습니다:
+
+* ✅ 무엇이 활성화되어 있나?
+* 👥 누가 영향을 받나?
+* 🔄 무엇이 변경되었나?
+* 💥 무엇이 깨질 수 있나?
+* 🖊️ 누가 승인했나?
+* 🧯 무엇을 먼저 수정해야 하나?
+* 📄 QA, DevOps, 리더십 또는 컴플라이언스에 어떤 증빙을 제공할 수 있나?
+
+---
+
+## ⚡ 요약
+
+Compass Ultra는 배포 전에 릴리스 준비 상태를 검토하고 증명하는 데 도움을 줍니다.
+
+일반적인 릴리스 검토는 다음과 같습니다:
+
+1. 📦 릴리스 워크스페이스를 로드하거나 가져옵니다.
+2. 👤 실제 사용자 컨텍스트에 대해 플래그를 평가합니다.
+3. 🛡️ 정책 게이트와 위험 분석을 실행합니다.
+4. 🔍 릴리스 스냅샷을 비교합니다.
+5. 📄 릴리스 런북을 내보냅니다.
+6. 🚀 프로덕션 변경이 라이브되기 전에 증빙을 공유합니다.
+
+---
+
+## 🎮 라이브 데모
+
+데모는 계정 없이 사용할 수 있습니다:
+
+**데모:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+데모는 위험한 리테일 릴리스(블랙 프라이데이 전날, `peak-sale-2026.11`)를 시뮬레이션합니다:
+
+* 🏁 LaunchDarkly, Statsig, Firebase에 걸친 10개의 기능 플래그
+* 🛒 고위험 체크아웃, 플래시 세일, 당일 배송 플래그
+* 🚧 정책 차단 요소 및 경고(의존성 누락, 카나리 위반)
+* 🔗 의존성 그래프 검사
+* 🧾 스냅샷 비교
+* 📄 PDF 런북 내보내기
+* 🔌 GitHub, Jira, Slack 페이로드 생성
+* 🧯 데모 상태용 킬 스위치 롤백 플로우
+* 💰 피크 트래픽 배포 윈도우에 대한 재무 영향 추정
+
+---
+
+## 🧠 핵심 기능
+
+### 🚦 릴리스 위험 분석기
+
+Compass Ultra는 현재 릴리스 워크스페이스를 검토하고 실용적인 릴리스 평가를 반환합니다:
+
+* ✅ **배포**
+* 🟡 **보류**
+* 🔴 **먼저 수정**
+
+실시간 AI 서비스와 결정론적 폴백으로 구동됩니다 — AI 서비스를 사용할 수 없을 때도 분석이 차단되지 않습니다.
+
+다음과 같은 문제를 감지할 수 있습니다:
+
+* 🔥 고위험 활성 플래그
+* 🔗 의존성 충돌
+* 👻 누락된 승인자
+* ⏰ 만료되었거나 소유자 없는 플래그
+* 🐤 카나리 롤아웃 위반
+* 🚨 프로덕션 오버라이드
+* 🧾 컴플라이언스에 민감한 롤아웃 패턴
+* 💰 피크 트래픽 배포 윈도우에 대한 재무 영향 추정
+
+---
+
+### 🎯 플래그 평가 엔진
+
+특정 사용자 컨텍스트에 대해 모든 플래그를 평가합니다.
+
+| 필드 | 설명 |
+| --- | --- |
+| 👤 사용자 키 | 고유 사용자 식별자 |
+| 📧 이메일 | 사용자 이메일 주소 |
+| 🏢 테넌트 | 고객 또는 계정 테넌트 |
+| 💳 플랜 | 가격 또는 권한 플랜 |
+| 🛂 역할 | 사용자 역할 또는 권한 그룹 |
+| 🌎 리전 | 지리적 또는 인프라 리전 |
+| 🏳️ 국가 | 국가 수준 타겟팅 |
+| 📱 디바이스 | 디바이스 또는 플랫폼 유형 |
+| 🌐 환경 | 개발, 스테이징, 프로덕션 또는 사용자 정의 환경 |
+
+각 플래그는 다음을 표시합니다:
+
+* 🎚️ 평가된 값
+* 🧠 해석 이유(규칙 일치, 롤아웃 버킷, 기본값 또는 오버라이드)
+* 🧩 일치하는 규칙 또는 조건
+* 📌 평가 중 사용된 관련 컨텍스트
+
+저장된 컨텍스트 프리셋 — Production admin, EU customer, Mobile guest — 사이를 전환하여 세그먼트별 플래그 동작을 확인하세요.
+
+---
+
+### 🛡️ 엔터프라이즈 정책 게이트 (9가지 검사)
+
+Compass Ultra는 워크스페이스 상태가 변경될 때마다 자동 릴리스 검사를 실행합니다.
+
+| 🔒 게이트 | 검사 항목 |
+| --- | --- |
+| 🎟️ 변경 티켓 첨부 | 프로덕션 전 CHG 또는 Jira 티켓 존재 |
+| 👥 중요 플래그에 승인자 있음 | 모든 고위험/중요 활성 플래그에 지정된 승인자 |
+| 🧬 모든 플래그에 추적 가능성 | 모든 플래그에 Jira/변경 ID |
+| ⏳ 만료된 플래그 비활성화 | 만료된 활성 플래그 없음 |
+| 🚫 프로덕션 오버라이드 규율 | 프로덕션에서 수동 오버라이드 없음 |
+| 🐤 카나리 롤아웃 한도 | 카나리 필수 플래그가 50% 롤아웃 이내 |
+| 🔗 의존성 활성화 | 활성화된 플래그에 비활성화된 의존성 없음 |
+| 🔌 라이브 프로바이더 어댑터 구성 | 최소 하나의 프로바이더 토큰 연결 |
+| 📤 아웃바운드 DevOps 훅 구성 | GitHub/Jira/Slack 엔드포인트 설정 |
+
+---
+
+### 🤖 AI DevOps 채팅 위젯
+
+단일 스크립트 태그로 모든 페이지에 임베드할 수 있는 플로팅 AI 채팅 어시스턴트:
+
+```html
+
+```
+
+* 💬 자연어로 릴리스 질문
+* 🔍 라이브 워크스페이스 상태 자동 읽기
+* 📊 세션 카운터로 사용 방문자 수 표시
+* ⚡ AI 서비스 불가 시 우아한 폴백
+* 🧠 동일 세션 내 메시지 간 채팅 기록 유지
+
+라이브 체험: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 프로바이더 통합 (읽기 전용 동기화)
+
+서버 프록시를 통해 고객 소유 읽기 전용 토큰으로 플래그 프로바이더에서 라이브 플래그 상태를 가져옵니다.
+
+| 🏴 프로바이더 | 유형 |
+| --- | --- |
+| 🚀 LaunchDarkly | 프로바이더 동기화 |
+| 📊 Statsig | 프로바이더 동기화 |
+| 🔓 Unleash | 프로바이더 동기화 |
+| 🏳️ Flagsmith | 프로바이더 동기화 |
+| 🔥 Firebase Remote Config | 프로바이더 동기화 |
+
+🔒 API 키는 백엔드 프록시를 벗어나지 않습니다. 브라우저는 Compass Ultra API만 호출합니다.
+
+---
+
+### 📤 아웃바운드 DevOps 통합
+
+기존 도구에 원클릭 페이로드 복사 또는 POST:
+
+| 🔌 통합 | 유형 |
+| --- | --- |
+| 🐙 GitHub Issues | 릴리스 증빙 이슈 |
+| 🎫 Jira Change | CHG 티켓 업데이트 |
+| 💬 Slack War Room | 릴리스 차단 / 리치 메시지 |
+
+---
+
+### 🔍 스냅샷 Diff
+
+두 릴리스 체크포인트를 비교하고 정확히 무엇이 변경되었는지 확인합니다.
+
+Diff는 다음을 식별할 수 있습니다:
+
+* ➕ 추가된 플래그
+* ➖ 제거된 플래그
+* 📈 롤아웃 변경
+* 🚨 중요도 변경
+* 👤 소유자 또는 승인자 변경
+* 🛠️ 오버라이드 변경
+
+---
+
+### 📄 PDF 릴리스 런북 및 인증서
+
+QA, 리더십, DevOps 또는 감사 검토를 위한 CAB 준비 PDF를 내보냅니다.
+
+런북에는 다음이 포함됩니다:
+
+* 🏷️ 릴리스 메타데이터 및 배포 윈도우
+* 🎯 플래그 평가 및 롤아웃 상태
+* 🛡️ 정책 게이트 결과
+* 🧠 위험 요약 및 재무 영향
+* 🧯 플래그별 롤백 메모
+* ✍️ 승인자 서명 목록
+* 🧾 감사 기록
+
+---
+
+### 🐙 GitHub Action CI 게이트
+
+릴리스 위험이 구성된 임계값을 초과하면 CI에서 배포를 차단합니다:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 차단 요소가 발견되면 워크플로가 자동으로 실패합니다 — 더 이상 "머지 전에 플래그 확인을 잊었다"는 일이 없습니다.
+
+---
+
+### 👥 RBAC (4가지 역할)
+
+| 🎭 역할 | 권한 |
+| --- | --- |
+| 🔑 Admin | 전체 액세스 — 플래그, 릴리스, 팀, 통합 |
+| ✅ Approver | 릴리스 승인, 전체 보기 |
+| 🛠️ Operator | 플래그 및 릴리스 메타데이터 편집 |
+| 👁️ Viewer | 읽기 전용 |
+
+모든 차단된 작업은 행위자, 역할, 트리거된 게이트, 정확한 타임스탬프와 함께 기록됩니다.
+
+---
+
+## 🧭 제품 포지셔닝
+
+Compass Ultra는 기능 플래그 **프로바이더가 아닙니다**.
+
+기능 플래그를 둘러싼 **릴리스 검토 레이어**입니다.
+
+다음에 대한 명확한 답이 필요할 때 사용하세요:
+
+> "이 기능 플래그 릴리스를 안전하게 배포할 수 있고, 증명할 수 있을까?"
+
+---
+
+## 💸 가격
+
+| 플랜 | 가격 | 시트 | 최적 대상 |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | 로컬 전용 | 워크스페이스 및 로컬 릴리스 검토 체험 |
+| 🧍 Solo | $49/월 | 1 시트 | 클라우드 동기화, 위험 분석, 스냅샷, 내보내기가 필요한 단독 운영자 |
+| 🚀 Pro | $149/월 | 최대 5 시트 | 공유 릴리스 검토 및 diff가 필요한 소규모 팀 |
+| 👥 Team | $299/월 | 최대 15 시트 | RBAC, 감사 내보내기, 알림, 조직 워크플로가 필요한 릴리스 팀 |
+| 🏢 Enterprise | 맞춤 | 맞춤 | 보안 검토, 온보딩, 맞춤 약관, 통합 |
+
+유료 플랜은 **7일 무료 체험**으로 시작합니다.
+
+신용카드 불필요. 고객이 구독하지 않으면 체험은 자동으로 Free로 다운그레이드됩니다.
+
+---
+
+## 🛠️ 기술 스택
+
+| 레이어 | 기술 |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API in the backend repo |
+| 🐘 Database | PostgreSQL through backend |
+| 🤖 AI risk analysis | Backend AI service with deterministic fallback |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 소스 코드
+
+이 공개 저장소에는 Compass Ultra 런치 페이지, 문서, GitHub Pages 자산, 공개 프로젝트 자료가 포함되어 있습니다.
+
+프로덕션 애플리케이션과 백엔드는 별도로 유지 관리됩니다. 공개 사용자는 비공개 구현 저장소에 대한 액세스 없이 라이브 앱과 데모를 탐색할 수 있습니다.
+
+---
+
+## 🔒 보안 모델
+
+Compass Ultra는 릴리스 검토 레이어로 설계되었습니다.
+
+* 🧪 로컬 데모는 로그인 없이 작동합니다.
+* 🔐 클라우드 스냅샷에는 인증이 필요합니다.
+* 🔌 프로바이더 동기화는 백엔드 프록시를 통한 읽기 전용 토큰을 사용합니다 — API 키는 브라우저를 거치지 않습니다.
+* 🛡️ 모든 응답에 보안 헤더: `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 Stripe가 카드 데이터를 처리합니다.
+* 🪪 Auth0가 ID 프로바이더입니다.
+* 🔗 공유 링크는 워크스페이스 상태를 인코딩하며 비밀에 사용해서는 안 됩니다.
+* 🏢 엔터프라이즈 고객은 라이브 프로바이더 롤아웃 전에 보안 검토 및 맞춤 약관을 사용해야 합니다.
+
+---
+
+## 🗺️ 로드맵
+
+* 🧾 백엔드 강제 시트 한도 완전 구현
+* 🧪 카드 없는 체험 라이프사이클 자동화
+* 🚦 이메일, 도메인, 사용량별 체험 남용 제어
+* 👥 팀 초대 플로우
+* 🏢 조직 워크스페이스
+* 🔌 더 많은 프로바이더 어댑터
+* 💬 Slack 앱 워크플로
+* 🐙 GitHub Action 릴리스 게이트 확장
+* 📤 더 많은 내보내기 형식
+* 🔒 엔터프라이즈용 보안 검토 패키지
+* 📊 AI DevOps 위젯용 라이브 백엔드 세션 및 메시지 수
+
+---
+
+## ✅ 상태
+
+Compass Ultra는 라이브 상태입니다:
+
+**프로덕션:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**데모:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 대상
+
+빠르게 배포하면서도 프로덕션 전에 증빙이 필요한 팀.
+
+**자신 있게 배포하세요. 증빙으로 검토하세요. 모든 릴리스를 증명하세요.** 🧭
\ No newline at end of file
diff --git a/README.md b/README.md
index fed5224..f80669c 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,19 @@
> **Release intelligence for teams that ship behind feature flags.**
+
+ 
+
+
+
+
+
+
+
+
+
+
+
Compass Ultra is a release control room for feature-flagged software. Review flag state, policy gates, rollout risk, snapshot diffs, AI-assisted risk analysis, and audit-ready release proof — before production changes go live.
[🚀 Live App](https://www.compassultra.com) · [🎮 Try the Demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
diff --git a/README.pt-BR.md b/README.pt-BR.md
new file mode 100644
index 0000000..9b01ecc
--- /dev/null
+++ b/README.pt-BR.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **Inteligência de release para equipes que entregam por trás de feature flags.**
+
+
+
+
+
+
+ 
+
+
+
+
+
+
+
+Compass Ultra é uma sala de controle de release para software com feature flags. Revise o estado das flags, portões de política, risco de rollout, diffs de snapshot, análise de risco assistida por IA e prova de release pronta para auditoria — antes que mudanças em produção entrem no ar.
+
+[🚀 App ao vivo](https://www.compassultra.com) · [🎮 Experimente a demo](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ Por que Compass Ultra?
+
+Feature flags deveriam tornar os releases mais seguros.
+
+Mas, com o tempo, elas podem virar uma superfície de release por si só:
+
+* 🧟 Flags obsoletas ou expiradas
+* 🎲 Percentuais de rollout arriscados
+* 👤 Responsáveis e aprovadores ausentes
+* 🕸️ Dependências ocultas entre flags
+* 🚨 Overrides em produção
+* 💬 Threads no Slack fingindo ser trilhas de auditoria
+* 🧩 Decisões de release espalhadas em ferramentas demais
+
+**Compass Ultra transforma o caos de feature flags em um fluxo repetível de revisão de release.**
+
+Em vez de perguntar:
+
+> "Podemos fazer o deploy?"
+
+Sua equipe pode responder:
+
+* ✅ O que está habilitado?
+* 👥 Quem é afetado?
+* 🔄 O que mudou?
+* 💥 O que pode quebrar?
+* 🖊️ Quem aprovou?
+* 🧯 O que precisa ser corrigido primeiro?
+* 📄 Que prova podemos entregar para QA, DevOps, liderança ou compliance?
+
+---
+
+## ⚡ A versão curta
+
+Compass Ultra ajuda equipes a revisar e comprovar a prontidão de release antes do deploy.
+
+Uma revisão típica de release funciona assim:
+
+1. 📦 Carregar ou importar um workspace de release.
+2. 👤 Avaliar flags com base em um contexto real de usuário.
+3. 🛡️ Executar portões de política e análise de risco.
+4. 🔍 Comparar snapshots de release.
+5. 📄 Exportar um runbook de release.
+6. 🚀 Compartilhar a prova antes que mudanças em produção entrem no ar.
+
+---
+
+## 🎮 Demo ao vivo
+
+A demo funciona sem conta:
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+A demo simula um release arriscado no varejo (véspera da Black Friday, `peak-sale-2026.11`) com:
+
+* 🏁 10 feature flags em LaunchDarkly, Statsig e Firebase
+* 🛒 Flags de alto risco em checkout, flash sale e entrega no mesmo dia
+* 🚧 Bloqueadores e avisos de política (lacunas de dependência, violações de canary)
+* 🔗 Verificações do grafo de dependências
+* 🧾 Comparação de snapshots
+* 📄 Exportação de runbook em PDF
+* 🔌 Geração de payloads para GitHub, Jira e Slack
+* 🧯 Fluxo de rollback com kill-switch para o estado da demo
+* 💰 Estimativa de impacto financeiro para janela de deploy em pico de tráfego
+
+---
+
+## 🧠 Recursos principais
+
+### 🚦 Analisador de risco de release
+
+Compass Ultra revisa o workspace de release atual e retorna uma avaliação prática:
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+Alimentado por um serviço de IA ao vivo com fallback determinístico — a análise nunca fica bloqueada, mesmo quando o serviço de IA está indisponível.
+
+Ele pode detectar problemas como:
+
+* 🔥 Flags ativas de alto risco
+* 🔗 Conflitos de dependência
+* 👻 Aprovadores ausentes
+* ⏰ Flags expiradas ou sem responsável
+* 🐤 Violações de rollout canary
+* 🚨 Overrides em produção
+* 🧾 Padrões de rollout sensíveis a compliance
+* 💰 Estimativas de impacto financeiro para janelas de deploy em pico de tráfego
+
+---
+
+### 🎯 Motor de avaliação de flags
+
+Avalie cada flag com base em um contexto específico de usuário.
+
+| Campo | Descrição |
+| --- | --- |
+| 👤 User key | Identificador único do usuário |
+| 📧 Email | Endereço de e-mail do usuário |
+| 🏢 Tenant | Tenant do cliente ou conta |
+| 💳 Plan | Plano de preço ou entitlement |
+| 🛂 Role | Papel ou grupo de permissão do usuário |
+| 🌎 Region | Região geográfica ou de infraestrutura |
+| 🏳️ Country | Segmentação por país |
+| 📱 Device | Tipo de dispositivo ou plataforma |
+| 🌐 Environment | Desenvolvimento, staging, produção ou ambiente personalizado |
+
+Cada flag mostra:
+
+* 🎚️ Valor avaliado
+* 🧠 Motivo da resolução (regra correspondente, bucket de rollout, padrão ou override)
+* 🧩 Regra ou condição correspondente
+* 📌 Contexto relevante usado durante a avaliação
+
+Alterne entre presets de contexto salvos — Production admin, EU customer, Mobile guest — para ver como as flags se comportam por segmento.
+
+---
+
+### 🛡️ Portões de política enterprise (9 verificações)
+
+Compass Ultra executa verificações automatizadas de release em cada mudança de estado do workspace.
+
+| 🔒 Portão | O que verifica |
+| --- | --- |
+| 🎟️ Change ticket attached | Ticket CHG ou Jira presente antes de produção |
+| 👥 Critical flags have approvers | Todas as flags ativas de alta/crítica têm aprovadores nomeados |
+| 🧬 Every flag has traceability | Todas as flags têm IDs Jira/change |
+| ⏳ No expired flags enabled | Nenhuma flag habilitada está expirada |
+| 🚫 Production override discipline | Nenhum override manual ativo em produção |
+| 🐤 Canary rollout limit | Flags que exigem canary permanecem dentro de 50% de rollout |
+| 🔗 Dependencies enabled | Nenhuma flag habilitada tem dependência desabilitada |
+| 🔌 Live provider adapters configured | Pelo menos um token de provider está conectado |
+| 📤 Outbound DevOps hooks configured | Endpoints GitHub/Jira/Slack estão configurados |
+
+---
+
+### 🤖 Widget de chat AI DevOps
+
+Um assistente de chat com IA flutuante que pode ser incorporado em qualquer página com uma única tag de script:
+
+```html
+
+```
+
+* 💬 Faça perguntas sobre release em linguagem natural
+* 🔍 Lê automaticamente o estado ao vivo do workspace
+* 📊 Contador de sessão mostra quantos visitantes usaram
+* ⚡ Fallback elegante quando o serviço de IA está indisponível
+* 🧠 Mantém o histórico de chat entre mensagens na mesma sessão
+
+Experimente ao vivo: [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 Integrações de providers (sincronização somente leitura)
+
+Importe o estado ao vivo das flags do seu provider via token somente leitura de propriedade do cliente, através do proxy do servidor.
+
+| 🏴 Provider | Tipo |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 Chaves de API nunca saem do proxy do backend. O navegador só chama a API do Compass Ultra.
+
+---
+
+### 📤 Integrações DevOps de saída
+
+Copie o payload com um clique ou faça POST para suas ferramentas existentes:
+
+| 🔌 Integração | Tipo |
+| --- | --- |
+| 🐙 GitHub Issues | Issue de evidência de release |
+| 🎫 Jira Change | Atualização de ticket CHG |
+| 💬 Slack War Room | Bloqueios de release / mensagem rica |
+
+---
+
+### 🔍 Diff de snapshot
+
+Compare dois checkpoints de release e veja exatamente o que mudou.
+
+Os diffs podem identificar:
+
+* ➕ Flags adicionadas
+* ➖ Flags removidas
+* 📈 Mudanças de rollout
+* 🚨 Mudanças de criticidade
+* 👤 Mudanças de responsável ou aprovador
+* 🛠️ Mudanças de override
+
+---
+
+### 📄 Runbooks e certificados de release em PDF
+
+Exporte PDFs prontos para CAB para QA, liderança, DevOps ou revisão de auditoria.
+
+Runbooks incluem:
+
+* 🏷️ Metadados de release e janela de deploy
+* 🎯 Avaliações de flags e estados de rollout
+* 🛡️ Resultados dos portões de política
+* 🧠 Resumo de risco e impacto financeiro
+* 🧯 Notas de rollback por flag
+* ✍️ Lista de assinaturas dos aprovadores
+* 🧾 Histórico de auditoria
+
+---
+
+### 🐙 Portão CI com GitHub Action
+
+Bloqueie deploys no CI quando o risco de release exceder um limite configurado:
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 A action falha o workflow automaticamente se bloqueadores forem encontrados — chega de "esquecemos de verificar as flags antes do merge".
+
+---
+
+### 👥 RBAC (4 papéis)
+
+| 🎭 Papel | Permissões |
+| --- | --- |
+| 🔑 Admin | Acesso total — flags, release, equipe, integrações |
+| ✅ Approver | Aprovar releases, visualizar tudo |
+| 🛠️ Operator | Editar flags e metadados de release |
+| 👁️ Viewer | Somente leitura |
+
+Todas as ações bloqueadas são registradas com ator, papel, portão acionado e timestamp exato.
+
+---
+
+## 🧭 Posicionamento do produto
+
+Compass Ultra **não** é um provider de feature flags.
+
+É a **camada de revisão de release** em torno de feature flags.
+
+Use quando precisar de uma resposta clara para:
+
+> "Podemos fazer o deploy com segurança deste release com feature flags e comprovar isso?"
+
+---
+
+## 💸 Preços
+
+| Plano | Preço | Assentos | Ideal para |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | Somente local | Experimentar o workspace e revisão local de release |
+| 🧍 Solo | $49/mo | 1 assento | Operadores solo que precisam de sync na nuvem, análise de risco, snapshots e exportações |
+| 🚀 Pro | $149/mo | Até 5 assentos | Equipes pequenas que precisam de revisão compartilhada de release e diffing |
+| 👥 Team | $299/mo | Até 15 assentos | Equipes de release que precisam de RBAC, exportação de auditoria, alertas e fluxos organizacionais |
+| 🏢 Enterprise | Custom | Custom | Revisão de segurança, onboarding, termos personalizados e integrações |
+
+Planos pagos começam com **7 dias de teste grátis**.
+
+Não é necessário cartão de crédito. Os testes voltam automaticamente para Free, a menos que o cliente assine.
+
+---
+
+## 🛠️ Stack tecnológica
+
+| Camada | Tecnologia |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | Express API no repositório de backend |
+| 🐘 Database | PostgreSQL via backend |
+| 🤖 AI risk analysis | Serviço de IA no backend com fallback determinístico |
+| ☁️ Hosting | Vercel (frontend) · Railway (backend) |
+
+---
+
+## 📦 Código-fonte
+
+Este repositório público contém a página de lançamento do Compass Ultra, documentação, assets do GitHub Pages e materiais públicos do projeto.
+
+A aplicação de produção e o backend são mantidos separadamente. Usuários públicos podem explorar o app ao vivo e a demo sem precisar de acesso a repositórios privados de implementação.
+
+---
+
+## 🔒 Modelo de segurança
+
+Compass Ultra foi projetado como uma camada de revisão de release.
+
+* 🧪 A demo local funciona sem login.
+* 🔐 Snapshots na nuvem exigem autenticação.
+* 🔌 A sincronização de providers usa tokens somente leitura via proxy do backend — chaves de API nunca passam pelo navegador.
+* 🛡️ Cabeçalhos de segurança em todas as respostas: `X-Frame-Options`, `Content-Security-Policy`, `Strict-Transport-Security`, `X-Content-Type-Options`.
+* 💳 O Stripe processa dados de cartão.
+* 🪪 Auth0 é o provedor de identidade.
+* 🔗 Links de compartilhamento codificam o estado do workspace e não devem ser usados para segredos.
+* 🏢 Clientes Enterprise devem fazer revisão de segurança e termos personalizados antes do rollout de providers ao vivo.
+
+---
+
+## 🗺️ Roadmap
+
+* 🧾 Limites de assentos totalmente aplicados no backend
+* 🧪 Automação do ciclo de teste sem cartão
+* 🚦 Controles contra abuso de trial por e-mail, domínio e uso
+* 👥 Fluxo de convite para equipe
+* 🏢 Workspaces organizacionais
+* 🔌 Mais adaptadores de providers
+* 💬 Fluxo de app Slack
+* 🐙 Expansão do portão de release com GitHub Action
+* 📤 Mais formatos de exportação
+* 🔒 Pacote de revisão de segurança para Enterprise
+* 📊 Contagens ao vivo de sessão e mensagens no backend para o widget AI DevOps
+
+---
+
+## ✅ Status
+
+Compass Ultra está no ar:
+
+**Produção:** [https://www.compassultra.com](https://www.compassultra.com)
+
+**Demo:** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker:** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 Feito para
+
+Equipes que entregam rápido e ainda precisam de prova antes da produção.
+
+**Faça deploy com confiança. Revise com evidências. Comprove cada release.** 🧭
\ No newline at end of file
diff --git a/README.zh-CN.md b/README.zh-CN.md
new file mode 100644
index 0000000..766982c
--- /dev/null
+++ b/README.zh-CN.md
@@ -0,0 +1,371 @@
+# 🧭 Compass Ultra
+
+> **为通过功能开关发布软件的团队提供发布情报。**
+
+
+
+
+
+
+
+ 
+
+
+
+
+
+
+Compass Ultra 是面向功能开关软件的发布控制室。在生产变更上线之前，审查开关状态、策略门禁、发布风险、快照差异、AI 辅助风险分析，以及可用于审计的发布证明。
+
+[🚀 在线应用](https://www.compassultra.com) · [🎮 试用演示](https://www.compassultra.com/app?demo=true) · [🤖 AI DevOps Checker](https://www.compassultra.com/ai-devops)
+
+
+
+---
+
+## ✨ 为什么选择 Compass Ultra？
+
+功能开关本应让发布更安全。
+
+但随着时间推移，它们本身也可能成为发布风险面：
+
+* 🧟 陈旧或过期的开关
+* 🎲 高风险的发布百分比
+* 👤 缺少负责人和审批人
+* 🕸️ 隐藏的开关依赖关系
+* 🚨 生产环境覆盖（override）
+* 💬 用 Slack 线程冒充审计记录
+* 🧩 发布决策分散在过多工具中
+
+**Compass Ultra 将功能开关的混乱转化为可重复的发布审查工作流。**
+
+不再问：
+
+> "可以发布了吗？"
+
+您的团队可以回答：
+
+* ✅ 启用了什么？
+* 👥 影响了谁？
+* 🔄 发生了什么变化？
+* 💥 什么可能会出问题？
+* 🖊️ 谁批准的？
+* 🧯 需要先修复什么？
+* 📄 我们可以向 QA、DevOps、管理层或合规团队提供什么证明？
+
+---
+
+## ⚡ 简短版
+
+Compass Ultra 帮助团队在发布前审查并证明发布就绪状态。
+
+典型的发布审查流程如下：
+
+1. 📦 加载或导入发布工作区。
+2. 👤 根据真实用户上下文评估开关。
+3. 🛡️ 运行策略门禁和风险分析。
+4. 🔍 比较发布快照。
+5. 📄 导出发布运行手册。
+6. 🚀 在生产变更上线前共享证明。
+
+---
+
+## 🎮 在线演示
+
+演示无需账户即可使用：
+
+**演示：** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+演示模拟了一个高风险的零售发布场景（黑色星期五前夕，`peak-sale-2026.11`），包含：
+
+* 🏁 跨 LaunchDarkly、Statsig 和 Firebase 的 10 个功能开关
+* 🛒 高风险的结账、闪购和当日达开关
+* 🚧 策略阻塞项和警告（依赖缺失、金丝雀违规）
+* 🔗 依赖关系图检查
+* 🧾 快照比较
+* 📄 PDF 运行手册导出
+* 🔌 GitHub、Jira 和 Slack 载荷生成
+* 🧯 演示状态的 kill-switch 回滚流程
+* 💰 高峰流量部署窗口的财务影响估算
+
+---
+
+## 🧠 核心功能
+
+### 🚦 发布风险分析器
+
+Compass Ultra 审查当前发布工作区，并返回实用的发布评估：
+
+* ✅ **Ship**
+* 🟡 **Hold**
+* 🔴 **Fix first**
+
+由实时 AI 服务驱动，并配有确定性回退机制——即使 AI 服务不可用，分析也不会被阻断。
+
+它可以检测以下问题：
+
+* 🔥 高风险的活跃开关
+* 🔗 依赖冲突
+* 👻 缺少审批人
+* ⏰ 已过期或无负责人的开关
+* 🐤 金丝雀发布违规
+* 🚨 生产环境覆盖
+* 🧾 合规敏感的发布模式
+* 💰 高峰流量部署窗口的财务影响估算
+
+---
+
+### 🎯 开关评估引擎
+
+根据特定用户上下文评估每个开关。
+
+| 字段 | 说明 |
+| --- | --- |
+| 👤 User key | 唯一用户标识符 |
+| 📧 Email | 用户电子邮件地址 |
+| 🏢 Tenant | 客户或账户租户 |
+| 💳 Plan | 定价或权益计划 |
+| 🛂 Role | 用户角色或权限组 |
+| 🌎 Region | 地理或基础设施区域 |
+| 🏳️ Country | 国家级定向 |
+| 📱 Device | 设备或平台类型 |
+| 🌐 Environment | 开发、预发布、生产或自定义环境 |
+
+每个开关显示：
+
+* 🎚️ 评估值
+* 🧠 解析原因（规则匹配、发布分桶、默认值或覆盖）
+* 🧩 匹配的规则或条件
+* 📌 评估时使用的相关上下文
+
+在已保存的上下文预设之间切换——Production admin、EU customer、Mobile guest——查看开关在不同细分人群中的行为。
+
+---
+
+### 🛡️ 企业策略门禁（9 项检查）
+
+Compass Ultra 在工作区状态每次变更时运行自动化发布检查。
+
+| 🔒 门禁 | 检查内容 |
+| --- | --- |
+| 🎟️ Change ticket attached | 生产环境前已附加 CHG 或 Jira 工单 |
+| 👥 Critical flags have approvers | 所有高/关键活跃开关均有指定审批人 |
+| 🧬 Every flag has traceability | 所有开关均有 Jira/变更 ID |
+| ⏳ No expired flags enabled | 没有已启用的过期开关 |
+| 🚫 Production override discipline | 生产环境中没有活跃的手动覆盖 |
+| 🐤 Canary rollout limit | 需要金丝雀的开关保持在 50% 发布比例以内 |
+| 🔗 Dependencies enabled | 没有已启用开关的依赖项处于禁用状态 |
+| 🔌 Live provider adapters configured | 至少连接了一个提供商令牌 |
+| 📤 Outbound DevOps hooks configured | 已配置 GitHub/Jira/Slack 端点 |
+
+---
+
+### 🤖 AI DevOps 聊天小部件
+
+一个可嵌入任意页面的浮动 AI 聊天助手，只需一个脚本标签：
+
+```html
+
+```
+
+* 💬 用自然语言提问发布相关问题
+* 🔍 自动读取实时工作区状态
+* 📊 会话计数器显示有多少访客使用过
+* ⚡ AI 服务不可用时优雅降级
+* 🧠 在同一会话中跨消息保持聊天历史
+
+在线试用：[https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+### 🔌 提供商集成（只读同步）
+
+通过服务器代理，使用客户自有的只读令牌从您的开关提供商导入实时开关状态。
+
+| 🏴 Provider | 类型 |
+| --- | --- |
+| 🚀 LaunchDarkly | Provider sync |
+| 📊 Statsig | Provider sync |
+| 🔓 Unleash | Provider sync |
+| 🏳️ Flagsmith | Provider sync |
+| 🔥 Firebase Remote Config | Provider sync |
+
+🔒 API 密钥永远不会离开后端代理。浏览器仅调用 Compass Ultra API。
+
+---
+
+### 📤 出站 DevOps 集成
+
+一键复制载荷或 POST 到您现有的工具：
+
+| 🔌 Integration | 类型 |
+| --- | --- |
+| 🐙 GitHub Issues | 发布证据 issue |
+| 🎫 Jira Change | CHG 工单更新 |
+| 💬 Slack War Room | 发布阻塞 / 富文本消息 |
+
+---
+
+### 🔍 快照差异
+
+比较两个发布检查点，精确查看发生了什么变化。
+
+差异可识别：
+
+* ➕ 新增的开关
+* ➖ 移除的开关
+* 📈 发布比例变更
+* 🚨 关键性变更
+* 👤 负责人或审批人变更
+* 🛠️ 覆盖变更
+
+---
+
+### 📄 PDF 发布运行手册与证书
+
+导出适用于 CAB 的 PDF，供 QA、管理层、DevOps 或审计审查使用。
+
+运行手册包含：
+
+* 🏷️ 发布元数据和部署窗口
+* 🎯 开关评估和发布状态
+* 🛡️ 策略门禁结果
+* 🧠 风险摘要和财务影响
+* 🧯 每个开关的回滚说明
+* ✍️ 审批人签字列表
+* 🧾 审计历史
+
+---
+
+### 🐙 GitHub Action CI 门禁
+
+当发布风险超过配置阈值时，在 CI 中阻止部署：
+
+```yaml
+- uses: ./.github/actions/compass-check
+ with:
+ compass_api_key: ${{ secrets.COMPASS_API_KEY }}
+ risk_threshold: high
+```
+
+🚦 如果发现阻塞项，该 action 会自动使工作流失败——告别"合并前忘了检查开关"。
+
+---
+
+### 👥 RBAC（4 种角色）
+
+| 🎭 Role | 权限 |
+| --- | --- |
+| 🔑 Admin | 完全访问——开关、发布、团队、集成 |
+| ✅ Approver | 批准发布，查看全部 |
+| 🛠️ Operator | 编辑开关和发布元数据 |
+| 👁️ Viewer | 只读 |
+
+所有被阻止的操作都会记录操作者、角色、触发的门禁和精确时间戳。
+
+---
+
+## 🧭 产品定位
+
+Compass Ultra **不是**功能开关提供商。
+
+它是围绕功能开关的**发布审查层**。
+
+当您需要明确回答以下问题时，请使用它：
+
+> "我们能否安全地发布这个带功能开关的版本，并且能否证明这一点？"
+
+---
+
+## 💸 定价
+
+| 计划 | 价格 | 席位 | 最适合 |
+| --- | ---: | ---: | --- |
+| 🆓 Free | $0 | 仅本地 | 试用工作区和本地发布审查 |
+| 🧍 Solo | $49/mo | 1 席位 | 需要云同步、风险分析、快照和导出的个人运营者 |
+| 🚀 Pro | $149/mo | 最多 5 席位 | 需要共享发布审查和差异对比的小型团队 |
+| 👥 Team | $299/mo | 最多 15 席位 | 需要 RBAC、审计导出、告警和组织工作流的发布团队 |
+| 🏢 Enterprise | Custom | Custom | 安全审查、入门引导、定制条款和集成 |
+
+付费计划提供 **7 天免费试用**。
+
+无需信用卡。除非客户订阅，否则试用将自动降级为 Free。
+
+---
+
+## 🛠️ 技术栈
+
+| 层级 | 技术 |
+| --- | --- |
+| ⚛️ Frontend | React, Vite |
+| 🧭 Routing | React Router |
+| ✂️ Code splitting | React.lazy + Suspense |
+| 🎨 UI icons | Lucide React |
+| 📄 PDF export | jsPDF |
+| 🔐 Auth | Auth0 |
+| 💳 Payments | Stripe |
+| 📈 Analytics | Vercel Analytics |
+| 🔒 Security headers | X-Frame-Options, CSP, HSTS, cache control |
+| 🧱 Backend | backend 仓库中的 Express API |
+| 🐘 Database | 通过 backend 使用 PostgreSQL |
+| 🤖 AI risk analysis | 带确定性回退的后端 AI 服务 |
+| ☁️ Hosting | Vercel（前端）· Railway（后端） |
+
+---
+
+## 📦 源代码
+
+此公开仓库包含 Compass Ultra 发布页、文档、GitHub Pages 资源和面向公众的项目材料。
+
+生产应用和后端单独维护。公众用户无需访问私有实现仓库即可探索在线应用和演示。
+
+---
+
+## 🔒 安全模型
+
+Compass Ultra 被设计为发布审查层。
+
+* 🧪 本地演示无需登录。
+* 🔐 云快照需要身份验证。
+* 🔌 提供商同步通过后端代理使用只读令牌——API 密钥不会经过浏览器。
+* 🛡️ 所有响应均含安全头：`X-Frame-Options`、`Content-Security-Policy`、`Strict-Transport-Security`、`X-Content-Type-Options`。
+* 💳 Stripe 处理卡片数据。
+* 🪪 Auth0 是身份提供商。
+* 🔗 分享链接编码工作区状态，不应用于传递机密信息。
+* 🏢 企业客户应在上线提供商集成前完成安全审查并签署定制条款。
+
+---
+
+## 🗺️ 路线图
+
+* 🧾 后端强制执行席位限制
+* 🧪 无需信用卡的试用生命周期自动化
+* 🚦 按邮箱、域名和使用情况的试用滥用控制
+* 👥 团队邀请流程
+* 🏢 组织工作区
+* 🔌 更多提供商适配器
+* 💬 Slack 应用工作流
+* 🐙 GitHub Action 发布门禁扩展
+* 📤 更多导出格式
+* 🔒 企业版安全审查包
+* 📊 AI DevOps 小部件的实时后端会话和消息计数
+
+---
+
+## ✅ 状态
+
+Compass Ultra 已上线：
+
+**生产环境：** [https://www.compassultra.com](https://www.compassultra.com)
+
+**演示：** [https://www.compassultra.com/app?demo=true](https://www.compassultra.com/app?demo=true)
+
+**AI DevOps Checker：** [https://www.compassultra.com/ai-devops](https://www.compassultra.com/ai-devops)
+
+---
+
+## 🚀 面向对象
+
+发布速度快、但仍需在生产前拿出证明的团队。
+
+**自信发布。有据审查。证明每一次发布。** 🧭
\ No newline at end of file