🛡️ SENTRA AI

AI-Powered Supply Chain Risk Intelligence Platform

Built for Hackathon 2026 — Where artificial intelligence meets procurement resilience.

🏆 Hackathon Project · Built in 6 Hours · Fully Deployed · AI-Ready

📖 The Problem We Solve

Every year, companies lose $184 billion in revenue due to supply chain disruptions. The average procurement team monitors dozens of global suppliers across multiple continents — but their tools are reactive, not predictive. They find out about port congestion, financial stress, or geopolitical risks after the disruption has already hit.

SENTRA AI changes that.

We built an autonomous supply chain risk intelligence platform that:

Predicts disruptions 14–60 days before they impact operations
Quantifies financial exposure in real time
Executes mitigation playbooks autonomously
Monitors 13 suppliers across 13 countries, 24/7

🎯 Vision

"A world where no procurement team is ever blindsided by a supply chain disruption again."

SENTRA AI is the Sentinel that never sleeps — continuously scanning financial filings, port congestion data, geopolitical signals, weather events, and news feeds to surface risks before they become crises. When a risk is detected, SENTRA doesn't just alert you — it generates a full crisis response plan and executes it at the click of a button.

🚀 Live Demo

Service	URL	Status
🌐 Frontend	sentra-ai-7fpw.onrender.com	✅ Live
⚙️ Backend API	sentra-ai-hy43.onrender.com/api/health	✅ Live · AI Ready
📦 GitHub	rumaisafatima/Sentra_AI	✅ Public

Demo Credentials:

Email	Password	Role
`admin@sentra.ai`	`Sentra@2024`	Administrator
`demo@sentra.ai`	`Demo@1234`	Analyst
`rumaisa@sentra.ai`	`MyPassword123`	Procurement Manager
`analyst@sentra.ai`	`Analyst@2024`	Supply Chain Analyst

📸 Platform Screenshots

🏠 Command Center

The central intelligence dashboard showing supply chain health, disruption costs avoided, pending approvals, inventory health, and global supplier risk monitoring.

🏢 Supplier Intelligence Hub

Analyze supplier risk profiles, monitor risk trends, evaluate risk factors, and generate AI-powered supplier intelligence reports.

🤖 Sentinel Agent Console

Run AI-powered supplier scans to identify emerging threats, analyze disruption signals, and generate mitigation recommendations.

🚨 Disruption Playbook

Automatically generated response plans with disruption timelines, financial exposure analysis, and AI-driven mitigation strategies.

💬 Procurement Intelligence Chat

Ask natural language questions about suppliers, inventory, procurement spend, compliance, and supply chain risks.

📊 Risk Timeline

Visualize overlapping disruption windows, conflict zones, supplier exposure, and future supply chain risk events.

✅ Playbook Activated

Monitor autonomous mitigation execution, disruption resolution progress, financial savings, ROI, and full audit trails.

✨ Features

🏠 Command Center

The nerve center of your supply chain. See everything at a glance.

Animated Supply Chain Health Score — composite 0-100 index across 13 suppliers
$1.247M Savings Counter — animated count-up of disruptions avoided year-to-date
Pending Approvals — approve/reject AI agent actions in one click
Top 3 Risk Predictions — critical suppliers with probability scores and financial exposure
Live Agent Activity Feed — real-time stream of all 6 AI agents' actions

🌍 Global Risk Heat Map

The feature that stops judges in their tracks.

Full SVG world map with 13 animated country dots
Color-coded by risk level: 🔴 Critical · 🟡 High/Medium · 🟢 Low
Pulsing glow animations on critical-risk countries
Hover tooltips with supplier name, score, and risk level
Real geographic coordinates for all 13 countries

⚡ What-If Scenario Simulator

Model disruption impact before it happens.

5 toggleable disruption scenarios (Singapore port closure, Japan tariff, Bangladesh export ban, etc.)
Duration multiplier slider (0.5x–3x)
Safety stock buffer slider (0–60 days)
Live computed outputs: total financial exposure, SKUs at risk, inventory runout projection
Real-time Chart.js bar chart showing exposure breakdown per scenario

🔔 Notification / Alert Drawer

Bell icon with live unread count badge
Slide-in panel with 10 pre-populated alerts (Critical, Agent Actions, Approvals)
Filter by category, click to mark read, Mark All Read

🔍 Global Search

Live dropdown searching 24 indexed items
Searches suppliers, active risks, SKUs, and pages
Keyword matching (search "karachi", "bosphorus", "hormuz" — finds the right supplier)
Keyboard navigation (↑↓ Enter Esc), highlighted match text

🏢 Supplier Intelligence Hub

Full table of all 13 suppliers with search + risk-level filters
Click any row → animated detail panel with:
- Risk score gauge (Chart.js doughnut)
- 7-day risk trend chart (Chart.js line)
- Risk factors with color-coded indicators
- Certification expiry status
AI Analysis button — real GPT-4o-mini powered risk brief with typewriter effect

🤖 Agent Console

Your AI procurement analyst, available 24/7.

Sentinel Agent scans any of 13 suppliers
Quick Scan (30-day) or Deep Scan (90-day) modes
6-step animated progress with real-time status
Returns: risk score, confidence %, 3 risk drivers, intelligence summary, recommended action
13 unique supplier-specific fallback profiles (works without backend)
Session audit log

📋 Disruption Playbook

From crisis detection to mitigation in one click.

Active disruption alert with pulsing animation
6-milestone disruption timeline (Day 0 to Day 18) with urgency color coding
3 alternative supplier cards with risk score bars, cost premiums, net savings
Cost vs Risk comparison chart (Chart.js) — updates live as you switch selections
ROI calculation per mitigation option (e.g. "11.5x return on mitigation cost")
Pre-activation outcome panel showing exact financial impact
5-step autonomous playbook execution animation with PO reference numbers and audit trail

💬 Procurement Chat

Ask your supply chain anything in plain English.

Natural language interface — no backend required for core functionality
Local intelligence engine with 13-supplier knowledge base
10+ query categories: risk, inventory, spend, certifications, delivery, geography, actions
Responses include formatted tables, metric cards, risk badges, and direct action links
Suggestion chips, follow-up chips, recent topics sidebar

📊 Risk Timeline / Gantt View

See when disruptions collide.

14 risk events plotted across all suppliers
4 zoom levels: 30 / 60 / 90 / 180 days
Automatic conflict detection — finds overlapping high/critical risk windows
Filter by All / Critical / High / Medium / Low / Conflicts only
Hover tooltips, click-to-select detail panel
Conflict analysis panel listing simultaneous risks with combined exposure

🔐 Authentication System

Login with email/password validation and error handling
Register with live password strength meter (4 criteria, animated)
Role-based accounts (Administrator, Analyst, Procurement Manager, etc.)
"Keep me signed in" (localStorage) vs session-only (sessionStorage)
Synchronous auth guard — zero page flash before redirect
User avatar with initials, role badge, dropdown with sign out

💡 What Makes SENTRA AI Unique

1. Zero-Backend Demo That Feels Real

Every AI feature has an intelligent local fallback. Each supplier has a unique risk profile baked in — so Pacific Freight Co always returns a Singapore port congestion scan, SwissPharm AG returns low-risk Swiss compliance data. Not generic placeholders. Real supply chain intelligence.

2. Conflict Detection on the Timeline

No supply chain tool shows you when two disruptions overlap. SENTRA automatically identifies when Pakistan and Singapore both hit high-risk windows simultaneously — because that's when procurement capacity gets strained and costs compound.

3. Autonomous Playbook Execution

The playbook doesn't just show information. It executes: routes POs, places emergency reorders, sends notifications, sets monitoring intervals — all with reference numbers and an audit trail. One click replaces 4 hours of crisis management.

4. Natural Language Procurement Intelligence

Type "what should I do first?" and get a prioritised 7-item action list with exact dollar values. Type "tell me about Pakistan" and get the full KarachiTex Mills risk profile with risk factors, certifications, and recommended actions.

5. 13-Country Geographic Coverage

Most supply chain demos show 3-5 suppliers. SENTRA covers Singapore, Japan, Pakistan, Bangladesh, China, India, Türkiye, Mexico, Germany, UAE, USA, Monaco, Switzerland — with real geopolitical and macroeconomic narratives for each.

6. Production-Quality Auth on Pure Frontend

Full login/register flow, password strength validation, session management, per-page auth guard, role-based user profiles — all without a database. Built entirely on browser storage, production-ready for demos.

💼 Business Plan & Market Opportunity

The Problem

Global supply chain disruptions cost businesses $184B annually
73% of procurement teams still use spreadsheets and email for risk management
Average time to detect a supply chain risk: 73 days
Average time SENTRA detects it: Real-time

Target Market

Segment	Size	Pain Point
Enterprise Manufacturing	$2.1T market	Complex multi-tier supplier networks
Retail & Consumer Goods	$1.4T market	Seasonal demand + global sourcing
Pharmaceutical	$890B market	Regulatory compliance + quality risk
Automotive	$2.8T market	Just-in-time supply chain vulnerability

Total Addressable Market: $8.2B (Supply Chain Risk Management Software)

Revenue Model

Tier	Price	Included
Starter	$499/month	Up to 25 suppliers, basic AI scanning
Professional	$1,999/month	Up to 100 suppliers, full playbook automation
Enterprise	Custom	Unlimited suppliers, custom integrations, dedicated support

Go-to-Market Strategy

Hackathon → Pilot — convert hackathon exposure into 3-5 beta customers
Industry Events — Supply Chain conferences, Procurement summits
Partner Channel — ERP integrations (SAP, Oracle, NetSuite)
Content Marketing — Weekly supply chain risk reports (free tier lead generation)

Competitive Advantage

Feature	SENTRA AI	Resilinc	Riskmethods	Coupa
AI-generated playbooks	✅	❌	❌	❌
Natural language queries	✅	❌	❌	❌
Zero-backend demo mode	✅	❌	❌	❌
Conflict detection timeline	✅	❌	❌	❌
Deploy in 30 seconds	✅	❌	❌	❌

3-Year Vision

Year 1: Launch SaaS product, acquire 50 paying customers, $600K ARR
Year 2: Enterprise integrations (SAP, Oracle), 200 customers, $3.2M ARR
Year 3: Expand to Tier-2 supplier monitoring, predictive procurement AI, $12M ARR

🛠️ Tech Stack

Layer	Technology
Frontend	HTML5 + Alpine.js + Tailwind CSS (CDN)
Charts	Chart.js
Icons	Lucide Icons
Backend	Python FastAPI + Uvicorn
AI Provider	OpenAI GPT-4o-mini (auto-detects Anthropic/Grok too)
Auth	localStorage / sessionStorage (client-side)
Deployment	Render (Static Site + Web Service)
Version Control	GitHub

🗂️ Project Structure

sentra-ai/
├── 📄 index.html          → Command Center (main dashboard)
├── 📄 suppliers.html      → Supplier Intelligence Hub
├── 📄 agent.html          → Agent Console (Sentinel AI scanner)
├── 📄 playbook.html       → Disruption Playbook & Crisis Response
├── 📄 chat.html           → Procurement Chat (NLP interface)
├── 📄 timeline.html       → Risk Timeline (Gantt view)
├── 📄 login.html          → Authentication
├── 📄 register.html       → Account Creation
├── 📄 auth.js             → Session guard (runs before Alpine)
├── 📁 data/
│   ├── suppliers.json     → 13 supplier records with full profiles
│   ├── agents.json        → AI agent activity feed
│   └── risks.json         → Risk event data
└── 📁 backend/
    ├── main.py            → FastAPI app (3 endpoints)
    ├── requirements.txt   → Python dependencies
    └── .env.example       → Environment variable template

🌐 Suppliers Monitored

Flag	Supplier	Country	Category	Risk Level
🇸🇬	Pacific Freight Co	Singapore	Logistics	🔴 Critical (77)
🇯🇵	Fujikura Corp	Japan	Electronics	🔴 Critical (71)
🇵🇰	KarachiTex Mills	Pakistan	Textiles	🔴 High (68)
🇧🇩	GlobalTex Ltd	Bangladesh	Textiles	🟡 High (64)
🇨🇳	PolyPak Industries	China	Packaging	🟡 Medium (58)
🇮🇳	NovaCast Foundry	India	Castings	🟡 Medium (55)
🇹🇷	Istanbul Steel Works	Türkiye	Raw Materials	🟡 Medium (52)
🇲🇽	Apex Fasteners	Mexico	Components	🟡 Medium (44)
🇩🇪	ChemSource GmbH	Germany	Chemicals	🟢 Low (31)
🇦🇪	Gulf Logistics FZE	UAE	Logistics	🟢 Low (29)
🇺🇸	Metro Metals Inc	USA	Raw Materials	🟢 Low (23)
🇲🇨	Monaco Precision Parts	Monaco	Components	🟢 Low (18)
🇨🇭	SwissPharm AG	Switzerland	Chemicals	🟢 Low (15)

🚀 Getting Started

Option 1 — Open directly (no setup needed)

# macOS — just double-click index.html or:
open login.html

All features work via intelligent local fallbacks. No internet required.

Option 2 — Local HTTP server (recommended)

cd sentra-ai
python3 -m http.server 3000
# Open: http://localhost:3000/login.html

Option 3 — With real AI backend

cd backend
pip install -r requirements.txt

# Create .env file:
echo "OPENAI_API_KEY=sk-..." > .env

# Start backend:
uvicorn main:app --reload --port 8000

# Then open the frontend in your browser

🏗️ API Endpoints

Method	Endpoint	Description
`GET`	`/api/health`	Health check + AI provider status
`POST`	`/api/agent-scan`	Run Sentinel Agent risk scan on any supplier
`POST`	`/api/supplier-summary`	Generate 3-sentence AI risk brief for a supplier

Example: Agent Scan

curl -X POST https://sentra-ai-hy43.onrender.com/api/agent-scan \
  -H "Content-Type: application/json" \
  -d '{"supplier": "Pacific Freight Co", "scan_depth": "deep"}'

👥 Team

Rumaisa Fatima
_{Lead Developer & Product Designer}

M. Maaz Khan
_{Backend Engineer & AI Integration}

Laiba Kashif
_{Frontend Developer & UX Design}

🏆 Hackathon Context

SENTRA AI was conceived, designed, and built as a hackathon project — demonstrating what a small, focused team can ship in a compressed timeline when AI tools are used effectively.

What we built in the hackathon:

8 fully functional HTML pages with complex Alpine.js state
13-supplier intelligence knowledge base
Real AI integration (GPT-4o-mini via FastAPI)
Full authentication system
Production deployment on Render
60+ interactive components across all pages

The goal: Show that an AI-first supply chain platform doesn't require a 50-person engineering team and 18 months to build. With the right tools and architecture, a small team can ship something genuinely impressive.

📋 Roadmap

Real-time supplier news feed integration (NewsAPI)
Email/Slack alert notifications for risk escalations
CSV/PDF export for supplier scorecards
Multi-company tenant support
Mobile-responsive layout
Tier-2 supplier mapping (suppliers' suppliers)
Historical risk trend analytics (12-month view)
Integration with SAP Ariba / Oracle Procurement

📄 License

MIT License — free to use, modify, and distribute.

Built with ❤️ by Team SENTRA · Hackathon 2026

"Don't just monitor your supply chain — command it."

Name		Name	Last commit message	Last commit date
backend		backend
data		data
images		images
.gitignore		.gitignore
DEPLOY.md		DEPLOY.md
README.md		README.md
agent.html		agent.html
auth.js		auth.js
chat.html		chat.html
index.html		index.html
login.html		login.html
playbook.html		playbook.html
register.html		register.html
suppliers.html		suppliers.html
timeline.html		timeline.html

Latest commit

History

Folders and files

Repository files navigation

🛡️ SENTRA AI

AI-Powered Supply Chain Risk Intelligence Platform

📖 The Problem We Solve

🎯 Vision

🚀 Live Demo

📸 Platform Screenshots

🏠 Command Center

🏢 Supplier Intelligence Hub

🤖 Sentinel Agent Console

🚨 Disruption Playbook

💬 Procurement Intelligence Chat

📊 Risk Timeline

✅ Playbook Activated

✨ Features

🏠 Command Center

🌍 Global Risk Heat Map

⚡ What-If Scenario Simulator

🔔 Notification / Alert Drawer

🔍 Global Search

🏢 Supplier Intelligence Hub

🤖 Agent Console

📋 Disruption Playbook

💬 Procurement Chat

📊 Risk Timeline / Gantt View

🔐 Authentication System

💡 What Makes SENTRA AI Unique

1. Zero-Backend Demo That Feels Real

2. Conflict Detection on the Timeline

3. Autonomous Playbook Execution

4. Natural Language Procurement Intelligence

5. 13-Country Geographic Coverage

6. Production-Quality Auth on Pure Frontend

💼 Business Plan & Market Opportunity

The Problem

Target Market

Revenue Model

Go-to-Market Strategy

Competitive Advantage

3-Year Vision

🛠️ Tech Stack

🗂️ Project Structure

🌐 Suppliers Monitored

🚀 Getting Started

Option 1 — Open directly (no setup needed)

Option 2 — Local HTTP server (recommended)

Option 3 — With real AI backend

🏗️ API Endpoints

Example: Agent Scan

👥 Team

🏆 Hackathon Context

📋 Roadmap

📄 License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages