Skip to content

Z3DDIEZ/KRISIS

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

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

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors