imporve admin page & backend

README.md

@@ -18,7 +18,7 @@ This Hugging Face Space provides a Gradio interface to interact with the Integra
 
 - 🤖 **Autonomous MCP Agents** – Tool-aware FastAPI agent that plans across RAG, Web, Admin, and LLM actions
 - 📚 **Knowledge Base Ingestion** – Upload raw text, URLs, or documents (PDF/DOCX/TXT/MD) directly from the Gradio UI
-- 🛡️ **Admin Rules Management** – Dedicated tab to add/delete governance rules; all rules are persisted in SQLite for demo purposes
+- 🛡️ **Admin Rules Management** – Dedicated tab to add/delete governance rules; all rules are persisted in SQLite for demo purposes and enforced during every chat request
 - 📊 **Admin Analytics** – Snapshot of tenant activity, tool usage, red-flag triggers, and overall query volume
 - 🌐 **Live Web Search** – DuckDuckGo-based MCP server with English-biased results
 - 🏢 **Multi-Tenant Isolation** – Every request requires a tenant ID; backend enforces isolation for chat, ingestion, and admin ops

backend/api/services/agent_orchestrator.py

@@ -72,8 +72,12 @@ class AgentOrchestrator:
                 tool_input={"violations": [m.__dict__ for m in matches]},
                 reason="redflag_triggered"
             )
+            summary = "; ".join(
+                f"{m.description or m.pattern} [severity: {m.severity}]"
+                for m in matches
+            ) or "Policy violation detected"
             return AgentResponse(
-                text="Your request has been blocked due to policy.",
+                text=f"⚠️ Request blocked by Admin Plan: {summary}. Please review your governance rules or contact an administrator.",
                 decision=decision,
                 tool_traces=[{"redflags": [m.__dict__ for m in matches]}],
                 reasoning_trace=reasoning_trace

backend/api/services/redflag_detector.py

@@ -11,6 +11,7 @@ Enterprise RedFlagDetector
 - Sends notifications to Admin MCP or a webhook
 """
 
+import hashlib
 import os
 import re
 import time
@@ -19,16 +20,25 @@ from typing import List, Dict, Any, Optional
 import httpx
 
 from ..models.redflag import RedFlagRule, RedFlagMatch
+from ..storage.rules_store import RulesStore
 from .semantic_encoder import embed_text, cosine_similarity
 
 
 class RedFlagDetector:
 
-    def __init__(self, supabase_url: Optional[str] = None, supabase_key: Optional[str] = None, admin_mcp_url: Optional[str] = None, cache_ttl: int = 300):
+    def __init__(
+        self,
+        supabase_url: Optional[str] = None,
+        supabase_key: Optional[str] = None,
+        admin_mcp_url: Optional[str] = None,
+        cache_ttl: int = 300,
+        rules_store: Optional[RulesStore] = None,
+    ):
         self.supabase_url = supabase_url or os.getenv("SUPABASE_URL")
         self.supabase_key = supabase_key or os.getenv("SUPABASE_SERVICE_KEY")
         self.admin_mcp_url = admin_mcp_url or os.getenv("ADMIN_MCP_URL")
         self.cache_ttl = cache_ttl
+        self.rules_store = rules_store or RulesStore()
         self._rules_cache: Dict[str, Dict[str, Any]] = {}  # tenant_id -> {"fetched_at":ts, "rules":[...]}
         self._rule_embeddings: Dict[str, Dict[str, List[float]]] = {}
         self._client = httpx.AsyncClient(timeout=15)
@@ -84,7 +94,18 @@ class RedFlagDetector:
         if entry and now - entry["fetched_at"] < self.cache_ttl:
             return entry["rules"]
 
-        rules = await self._fetch_rules_from_supabase(tenant_id)
+        rules: List[RedFlagRule] = []
+        remote_rules: List[RedFlagRule] = []
+        if self.supabase_url and self.supabase_key:
+            try:
+                remote_rules = await self._fetch_rules_from_supabase(tenant_id)
+            except Exception:
+                remote_rules = []
+
+        local_rules = self._fetch_local_rules(tenant_id)
+        rules.extend(remote_rules)
+        rules.extend(local_rules)
+
         self._rules_cache[tenant_id] = {"fetched_at": now, "rules": rules}
         # Pre-compute embeddings for semantic scoring
         embed_map: Dict[str, List[float]] = {}
@@ -99,6 +120,30 @@ class RedFlagDetector:
         self._rule_embeddings[tenant_id] = embed_map
         return rules
 
+    def _fetch_local_rules(self, tenant_id: str) -> List[RedFlagRule]:
+        if not self.rules_store:
+            return []
+
+        rows = self.rules_store.get_rules(tenant_id)
+        rules: List[RedFlagRule] = []
+        for raw in rows:
+            text = (raw or "").strip()
+            if not text:
+                continue
+            rule_id = hashlib.sha1(f"{tenant_id}:{text}".encode()).hexdigest()
+            rules.append(
+                RedFlagRule(
+                    id=rule_id,
+                    pattern=text,
+                    description=text,
+                    severity="high",
+                    source="admin_local",
+                    enabled=True,
+                    keywords=[text.lower()] if len(text.split()) <= 6 else [],
+                )
+            )
+        return rules
+
     async def check(self, tenant_id: str, text: str) -> List[RedFlagMatch]:
         """Return structured matches for the given tenant and text."""
         if not text:

frontend/app/admin-rules/page.tsx

@@ -0,0 +1,32 @@
+import Link from "next/link";
+
+import { AdminRulesPanel } from "@/components/admin-rules-panel";
+import { Footer } from "@/components/footer";
+
+export default function AdminRulesPage() {
+  return (
+    <main className="mx-auto flex min-h-screen max-w-5xl flex-col gap-10 px-4 pb-16 pt-12 sm:px-6 lg:px-8">
+      <header className="flex flex-col gap-4 rounded-2xl border border-white/10 bg-white/5 px-6 py-6 text-slate-100 shadow-lg shadow-slate-950/40">
+        <div className="flex items-center justify-between gap-3">
+          <div className="flex items-center gap-3 text-base font-semibold">
+            <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
+              IC
+            </span>
+            IntegraChat · Admin Rule Ingestion
+          </div>
+          <Link href="/" className="text-xs font-semibold uppercase tracking-[0.3em] text-cyan-300 hover:text-white">
+            ← Back Home
+          </Link>
+        </div>
+        <p className="text-sm text-slate-300">
+          Push governance policies, compliance workflows, and red-flag patterns to the backend&apos;s persistent rules
+          store using the MCP admin services.
+        </p>
+      </header>
+
+      <AdminRulesPanel />
+      <Footer />
+    </main>
+  );
+}
+

frontend/app/analytics/page.tsx

@@ -0,0 +1,32 @@
+import Link from "next/link";
+
+import { AnalyticsPanel } from "@/components/analytics-panel";
+import { Footer } from "@/components/footer";
+
+export default function AnalyticsPage() {
+  return (
+    <main className="mx-auto flex min-h-screen max-w-5xl flex-col gap-10 px-4 pb-16 pt-12 sm:px-6 lg:px-8">
+      <header className="flex flex-col gap-4 rounded-2xl border border-white/10 bg-white/5 px-6 py-6 text-slate-100 shadow-lg shadow-slate-950/40">
+        <div className="flex items-center justify-between gap-3">
+          <div className="flex items-center gap-3 text-base font-semibold">
+            <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
+              IC
+            </span>
+            IntegraChat · Analytics
+          </div>
+          <Link href="/" className="text-xs font-semibold uppercase tracking-[0.3em] text-cyan-300 hover:text-white">
+            ← Back Home
+          </Link>
+        </div>
+        <p className="text-sm text-slate-300">
+          Inspect tenant-wide metrics including tool usage, red-flag violations, and overall activity—all powered by the
+          FastAPI analytics endpoints.
+        </p>
+      </header>
+
+      <AnalyticsPanel />
+      <Footer />
+    </main>
+  );
+}
+

frontend/app/chat/page.tsx

@@ -0,0 +1,32 @@
+import Link from "next/link";
+
+import { ChatPanel } from "@/components/chat-panel";
+import { Footer } from "@/components/footer";
+
+export default function ChatPage() {
+  return (
+    <main className="mx-auto flex min-h-screen max-w-5xl flex-col gap-10 px-4 pb-16 pt-12 sm:px-6 lg:px-8">
+      <header className="flex flex-col gap-4 rounded-2xl border border-white/10 bg-white/5 px-6 py-6 text-slate-100 shadow-lg shadow-slate-950/40">
+        <div className="flex items-center justify-between gap-3">
+          <div className="flex items-center gap-3 text-base font-semibold">
+            <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
+              IC
+            </span>
+            IntegraChat · Chat Bot
+          </div>
+          <Link href="/" className="text-xs font-semibold uppercase tracking-[0.3em] text-cyan-300 hover:text-white">
+            ← Back Home
+          </Link>
+        </div>
+        <p className="text-sm text-slate-300">
+          Experience the MCP agent orchestration layer with multi-tool reasoning, tenant isolation, and red-flag aware
+          responses.
+        </p>
+      </header>
+
+      <ChatPanel />
+      <Footer />
+    </main>
+  );
+}
+

frontend/app/ingestion/page.tsx

@@ -0,0 +1,32 @@
+import Link from "next/link";
+
+import { KnowledgeBasePanel } from "@/components/knowledge-base-panel";
+import { Footer } from "@/components/footer";
+
+export default function IngestionPage() {
+  return (
+    <main className="mx-auto flex min-h-screen max-w-5xl flex-col gap-10 px-4 pb-16 pt-12 sm:px-6 lg:px-8">
+      <header className="flex flex-col gap-4 rounded-2xl border border-white/10 bg-white/5 px-6 py-6 text-slate-100 shadow-lg shadow-slate-950/40">
+        <div className="flex items-center justify-between gap-3">
+          <div className="flex items-center gap-3 text-base font-semibold">
+            <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
+              IC
+            </span>
+            IntegraChat · Data Ingestion
+          </div>
+          <Link href="/" className="text-xs font-semibold uppercase tracking-[0.3em] text-cyan-300 hover:text-white">
+            ← Back Home
+          </Link>
+        </div>
+        <p className="text-sm text-slate-300">
+          Upload raw text, URLs, or documents to feed the tenant-specific RAG index. All inputs flow into the FastAPI +
+          MCP ingestion pipeline.
+        </p>
+      </header>
+
+      <KnowledgeBasePanel />
+      <Footer />
+    </main>
+  );
+}
+

frontend/app/page.tsx

@@ -1,3 +1,6 @@
+import Link from "next/link";
+
+import { AdminRulesPanel } from "@/components/admin-rules-panel";
 import { AnalyticsPanel } from "@/components/analytics-panel";
 import { ChatPanel } from "@/components/chat-panel";
 import { FeatureGrid } from "@/components/feature-grid";
@@ -5,26 +8,60 @@ import { Footer } from "@/components/footer";
 import { Hero } from "@/components/hero";
 import { KnowledgeBasePanel } from "@/components/knowledge-base-panel";
 
+const navItems = [
+  { label: "Data Ingestion", href: "/ingestion" },
+  { label: "Chat Bot", href: "/chat" },
+  { label: "Analytics", href: "/analytics" },
+  { label: "Admin Rule Ingestion", href: "/admin-rules" },
+];
+
 export default function Home() {
   return (
     <main className="mx-auto flex min-h-screen max-w-6xl flex-col gap-10 px-4 pb-16 pt-12 sm:px-6 lg:px-8">
-      <header className="flex flex-wrap items-center justify-between gap-3 rounded-2xl border border-white/10 bg-white/5 px-6 py-4 text-sm text-slate-100 shadow-lg shadow-slate-950/40">
-        <div className="flex items-center gap-3 text-base font-semibold">
-          <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
-            IC
-          </span>
-          IntegraChat Operator Console
-        </div>
-        <div className="flex flex-wrap items-center gap-3 text-xs uppercase tracking-[0.4em] text-slate-400">
-          FastAPI · MCP Servers · Celery · Next.js
+      <header className="flex flex-col gap-6 rounded-2xl border border-white/10 bg-white/5 px-6 py-6 text-slate-100 shadow-lg shadow-slate-950/40">
+        <div className="flex flex-wrap items-center justify-between gap-3 text-sm">
+          <div className="flex items-center gap-3 text-base font-semibold">
+            <span className="inline-flex h-10 w-10 items-center justify-center rounded-2xl bg-gradient-to-br from-sky-400 to-cyan-500 text-slate-950">
+              IC
+            </span>
+            IntegraChat Operator Console
+          </div>
+          <div className="flex flex-wrap items-center gap-3 text-xs uppercase tracking-[0.4em] text-slate-400">
+            FastAPI · MCP Servers · Celery · Next.js
+          </div>
         </div>
+        <nav className="flex flex-wrap gap-2">
+          {navItems.map((item) => (
+            <Link
+              key={item.href}
+              href={item.href}
+              className="rounded-full border border-white/15 px-4 py-2 text-xs font-semibold uppercase tracking-[0.2em] text-slate-200 transition hover:border-cyan-400 hover:text-white"
+            >
+              {item.label}
+            </Link>
+          ))}
+        </nav>
       </header>
 
       <Hero />
       <FeatureGrid />
-      <KnowledgeBasePanel />
-      <ChatPanel />
-      <AnalyticsPanel />
+
+      <section id="data-ingestion" className="scroll-mt-28">
+        <KnowledgeBasePanel />
+      </section>
+
+      <section id="chat-bot" className="scroll-mt-28">
+        <ChatPanel />
+      </section>
+
+      <section id="analytics" className="scroll-mt-28">
+        <AnalyticsPanel />
+      </section>
+
+      <section id="admin-rules" className="scroll-mt-28">
+        <AdminRulesPanel />
+      </section>
+
       <Footer />
     </main>
   );

frontend/components/admin-rules-panel.tsx

@@ -0,0 +1,57 @@
+export function AdminRulesPanel() {
+  const highlights = [
+    {
+      title: "Bulk Upload",
+      description: "Paste multiple compliance rules at once and push them to the MCP backend.",
+    },
+    {
+      title: "Governance Timeline",
+      description: "Track when each rule was last updated for audit-readiness.",
+    },
+    {
+      title: "Rule Severity",
+      description: "Tag entries as advisory, warning, or block-listed for automated enforcement.",
+    },
+    {
+      title: "Tenant Isolation",
+      description: "Rules are scoped per tenant, ensuring zero data leakage.",
+    },
+  ];
+
+  return (
+    <div className="rounded-3xl border border-slate-800/80 bg-slate-900/60 p-8 shadow-2xl shadow-slate-950/40">
+      <div className="flex flex-col gap-4">
+        <div>
+          <p className="text-sm font-semibold uppercase tracking-[0.3em] text-cyan-400">Admin Controls</p>
+          <h2 className="mt-3 text-3xl font-semibold text-white">Admin Rule Ingestion</h2>
+          <p className="mt-3 text-base text-slate-300">
+            Upload governance policies, red-flag keywords, and compliance workflows directly into the IntegraChat admin
+            service. Rules are stored in the backend&apos;s SQLite demo store and enforced across all MCP toolchains.
+          </p>
+        </div>
+
+        <div className="grid gap-4 md:grid-cols-2">
+          {highlights.map((item) => (
+            <div
+              key={item.title}
+              className="rounded-2xl border border-white/5 bg-white/5 p-4 text-slate-200 transition hover:border-cyan-400/40"
+            >
+              <p className="text-sm font-semibold text-cyan-300">{item.title}</p>
+              <p className="mt-2 text-sm text-slate-300">{item.description}</p>
+            </div>
+          ))}
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <button className="rounded-full bg-gradient-to-r from-cyan-400 to-blue-500 px-6 py-2 text-sm font-semibold text-slate-950 shadow-lg shadow-cyan-500/30">
+            Launch Admin Console
+          </button>
+          <button className="rounded-full border border-white/20 px-6 py-2 text-sm font-semibold text-white hover:border-cyan-400/60">
+            View Rule Templates
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+