Resilience Assessment Platform

A comprehensive maturity assessment platform for organizational resilience, built with Next.js 16 and Supabase.

Overview

This platform provides self-service maturity assessments across 12 resilience domains:

• Operational Resilience (ISO 22301)
• Financial Resilience (ISO 22301)
• Cyber Resilience (ISO 27001, NIST CSF)
• Supply Chain Resilience (ISO 28001)
• Incident Management (ISO 22320)
• Crisis Management (ISO 22361)
• Resilience by Design (ISO 31000)
• Business Continuity (ISO 22301)
• Disaster Recovery (ISO 27031)
• Data Privacy (ISO 27701, GDPR)
• Third-Party Risk Management (ISO 27036)
• Physical & Environmental Security (ISO 27001)

Tech Stack

• Framework: Next.js 16 (App Router + Turbopack)
• Database: Supabase (PostgreSQL with Row Level Security)
• Styling: Tailwind CSS
• UI Components: Custom components + shadcn/ui
• Language: TypeScript
• Deployment: Vercel

Getting Started

Prerequisites

• Node.js 18.x or higher
• npm 9.x or higher
• Supabase account (for database)

Installation

1. Clone the repository:

git clone https://github.com/SS2608-dev/Resilience.git
cd Resilience

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env.local

4. Configure .env.local with your Supabase credentials:

NEXT_PUBLIC_SUPABASE_URL=https://[your-project].supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=[your-anon-key]
NEXT_PUBLIC_APP_URL=http://localhost:3000
NODE_ENV=development

5. Set up the database:

   • Run the SQL migrations in database/migrations/ in Supabase SQL Editor
   • Migrations are numbered and should be run in order

6. Start the development server:

npm run dev

Open http://localhost:3000 in your browser.

Project Structure

.
├── app/                    # Next.js App Router pages & API routes
│   ├── api/               # API endpoints
│   ├── assessments/       # Assessment pages
│   └── ...
├── components/            # React components
│   ├── assessment/        # Assessment-specific components
│   ├── layout/           # Layout components
│   └── ui/               # Reusable UI components
├── database/             # Database schema & migrations
│   └── migrations/       # SQL migration files
├── docs/                 # Documentation
│   ├── deployment/       # Deployment guides
│   ├── development/      # Development guides
│   └── security/         # Security documentation
├── lib/                  # Shared utilities & configuration
│   ├── assessment/       # Assessment calculation logic
│   ├── config/           # Application configuration
│   ├── data/             # Data access layer
│   ├── questions/        # Legacy hardcoded questions
│   ├── supabase/         # Supabase clients
│   └── types/            # TypeScript types
└── src/                  # Source components
    └── components/       # Canonical component locations

Available Scripts

# Development
npm run dev          # Start development server with hot reload

# Production
npm run build        # Create production build
npm start           # Start production server

# Code Quality
npm run lint        # Run ESLint
npm run type-check  # Run TypeScript compiler check

Database Setup

The platform uses Supabase with the following main tables:

• assessment_types - Assessment type definitions
• assessment_sections - ISO clause sections
• assessment_questions - Individual questions
• assessment_sessions - User assessment progress
• assessment_results - Completed assessment results

All tables have Row Level Security (RLS) enabled. See database/migrations/ for schema details.

Documentation

• Environment Setup
• Deployment Guide
• Security Review
• Architecture Decisions
• Agent Context

Contributing

1. Create a feature branch from Resilience_Dec2025
2. Make your changes
3. Run npm run build to verify no errors
4. Submit a pull request

Security

• Environment variables are excluded from Git via .gitignore
• Supabase RLS policies protect all database tables
• See Security Review for details

License

Proprietary - ASI24 Ventures

---

Maintained by: ASI24 Ventures Last Updated: January 2026