Skip to content

Repository files navigation

KRISIS - Strategic Intelligence Protocol v4.0

KRISIS is a premium, high-fidelity AI-augmented intelligence platform engineered for elite job search orchestration. It transforms traditional job tracking into a tactical decision protocol, prioritizing architectural calm, high-contrast clarity, and senior-grade engineering precision.


🏛️ Project Identity: "Polished Calm"

The platform has transitioned from legacy experimental designs to a unified, production-ready aesthetic.

✅ Core Capabilities

  • Strategic Command: A high-density dashboard for real-time pipeline visualization.
  • Intelligent Ingestion: Automated sector-wide job search via deep-learning integration.
  • Decision Protocols: Tactical urgent-action grids and asymmetric intelligence layouts with "Daily Tactical Briefs".
  • Browser Extension: KRISIS CLIPPER for one-click job ingestion from LinkedIn/Indeed.
  • High-Fidelity Reporting: Strategic PDF generation for regional pipeline analysis.
  • Global Readiness: Standardized i18n architecture for multi-market deployment.

🛠️ Technical Stack (The Senior Stack)

Frontend Engine

  • Framework: React 18 + Vite (Atomic Performance)
  • Styling: Tailwind CSS v4 + Design Token Architecture (Pure CSS Variables)
  • State Orchestration: Zustand (Persistent) + TanStack Query (Server State)
  • Language: Strict TypeScript 5.2+ (Total Type Safety)
  • Validation: Zod (Neural Schema Validation)
  • Animation: Framer Motion + Performance-optimized CSS transitions

Infrastructure & Intelligence

  • BaaS: Firebase (Auth/Firestore/Functions)
  • AI: Google Gemini 2.5 Flash (Strategic Ingestion & Behavioral Analysis)
  • SDK: @google/genai (Latest Native Integration)
  • Observability: Standardized Error Handling (Sentry-ready)

📁 System Architecture

krisis/
├── docs/                    # High-Level Specifications & Architecture Decision Records
├── frontend/                # The Strategic Command Center
│   ├── src/
│   │   ├── components/      # UI Primitives & Complex Organisms (StatCards, AsymmetricGrid)
│   │   ├── lib/             # Core Utilities & Firebase Ingestion Engines
│   │   ├── styles/          # Unified Design System (Tailwind Tokens)
│   │   └── pages/           # Strategic Pipeline Views
├── functions/               # Serverless Edge Logic (Intelligence Processing)

🏎️ Deployment Protocol

Prerequisites

  • Node.js 20+
  • Firebase CLI (npm install -g firebase-tools)
  • Gemini API Key (for Intelligence Engines)

Initialization

# Clone the protocol
git clone <repository-url>
cd krisis/frontend

# Install dependencies
npm install

# Setup Intelligence Environment
cp .env.example .env # Inject your secure tokens

Execution

cd frontend   # Navigate to the frontend directory
npm run dev   # Initiate Local Command Center
npm run build # Compile Production-Grade Artifacts

📊 Data Management & Intelligence Protocols

Strategic Demo Data

Populate the system with high-fidelity mock data for stress testing and demonstration:

  1. Navigate to Data Management.
  2. Trigger the Initialize Demo Protocol action.
  3. Observe real-time status propagation across the Analytics engine.

Tactical Exports

Generate intelligence reports for stakeholder review:

  1. Access the Analytics or Data Management suite.
  2. Select Export Intelligence Report.
  3. Download the high-fidelity PDF/CSV artifact for local analysis.

🏗️ Senior Engineering Documentation

Individual technical deep-dives are available in the docs/ directory:


Engineered by Zawadi MC Nyachiya | 2026

About

Decision intelligence platform for job applications, using structured data and constrained AI to evaluate role alignment.

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages