Nexus Console Architecture

What is Nexus Console?

Nexus Console is a Flask-based web application that provides a unified dashboard for viewing and interacting with all Nexus environments. It's the primary client interface for the Nexus system.

URL: console.corlera.com Port: 6673 Framework: Flask (Python) Location: /opt/mcp-servers/nexus-console/

System Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Nexus Console                            │
│                  (Flask Web App)                            │
│                    Port: 6673                               │
└───────────────────────┬─────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────────┐
│              Redis Environment Connections                   │
│                                                             │
│  User (6610/6611)  │  KB (6625/6626)  │  Track (6640/6641) │
│  Session (6645/46) │  Context (6620)  │  Contact (6630/31) │
│  Chrono (6680/81)  │                                         │
└─────────────────────────────────────────────────────────────┘

Core Components

1. Flask Application (`app.py`)

Main web server
Route handlers for all pages
Redis connection management
Template rendering

2. Templates (`/templates/`)

Jinja2 HTML templates
Base layout with sidebar navigation
Environment-specific views:
track/ - Projects and tasks
kb/ - Knowledge base articles
sessions/ - Session management
notes/ - User notes from Context
contacts/ - CRM contacts
chrono/ - Calendar and reminders

3. Static Assets (`/static/`)

style.css - Dark theme styling
Uses CSS custom properties for theming
Responsive layout with collapsible sidebar

Redis Connection Pattern

Console connects to multiple Redis environments using a factory pattern:

ENV_CONFIG = {
    'user': {'vault': 6610, 'operational': 6611, 'password': ''},
    'kb': {'vault': 6625, 'operational': 6626, 'password': 'tg6ap5'},
    'track': {'vault': 6640, 'operational': 6641, 'password': 'yeaeoW'},
    'session': {'vault': 6645, 'operational': 6646, 'password': 'fy85Jm'},
    'context': {'vault': 6620, 'operational': 6621, 'password': 'D8qlcX'},
    'chrono': {'vault': 6680, 'operational': 6681, 'password': 'NF5TiD'},
    'contact': {'vault': 6630, 'operational': 6631, 'password': 'z7XGXX'},
}

def get_redis(env_name, port_type='operational'):
    """Get Redis connection for an environment"""
    # Returns redis.Redis connection

Pattern: - Reads from operational port by default (better performance) - Writes to vault port (ensures persistence) - Falls back to credentials helper for passwords

Technology Stack

Backend: Python 3.x, Flask
Database: Redis (multiple environments)
Templating: Jinja2
Frontend: HTML, CSS (custom), vanilla JavaScript
Markdown: Python-Markdown library
Timezone: pytz (America/Denver)

Key Features

✅ Multi-Environment Access - Track, KB, Sessions, Notes, Contacts, Chrono ✅ Dark Theme - GitHub-inspired dark mode ✅ Responsive Layout - Works on desktop and mobile ✅ Markdown Rendering - For KB articles and notes ✅ Global Search - Cross-environment search ✅ Session Management - View current and historical sessions ✅ Calendar Integration - FullCalendar for Chrono events ✅ CRM Features - Contact management with categories ✅ Category Filtering - For KB and Contacts

Architecture Overview