Skip to content
alfinohattaPublic

About

Quorra is a high-performance Decision-Intelligence (DI) platform for Android. It transforms complex, fragmented operational data into explainable, auditable, and trustworthy recommendations using a Human-on-the-Loop (HOTL) approach.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

8 Commits

Folders and files

Repository files navigation

Quorra: Decision-Intelligence Platform

Build Status Platform Kotlin Compose

Quorra is a high-performance Decision-Intelligence (DI) platform for Android. It transforms complex, fragmented operational data into explainable, auditable, and trustworthy recommendations using a Human-on-the-Loop (HOTL) approach.

Designed for multi-facility enterprises, Quorra bridges the gap between passive Business Intelligence (dashboards) and opaque automation, providing managers with the tools to simulate, decide, and learn from operational outcomes.


πŸ“– Table of Contents

  1. Business Problem & Overview
  2. Target Users & Personas
  3. Key Features & Business Value
  4. Technology Stack
  5. System Architecture
  6. Project Structure
  7. Environment Configuration
  8. Local Development Setup
  9. Operational Best Practices
  10. Troubleshooting & FAQ
  11. Contribution & License

πŸš€ Business Problem & Overview

The Problem

Modern enterprises are "drowning in dashboards but starving for decisions." Fragmented data across ERP, CRM, and WMS systems leads to:

  • Decision Paralysis: Managers can't absorb data fast enough to act.
  • Trust Deficit: Black-box AI recommendations are ignored because they lack reasoning.
  • High Reversal Costs: Misallocated inventory or mispriced contracts are expensive to unwind.

The Quorra Solution

Quorra introduces a Reasoning Layer over enterprise data. Every recommendation comes with a plain-language justification, a dual-confidence score (Data vs. Model), and a sandbox laboratory for "What If" simulation.


πŸ‘₯ Target Users & Personas

Persona Responsibility Core Use Case
Operator P&L Owner / Facility Lead Monitors the feed for stock-outs or risk; simulates recovery paths.
Approver Audit / Finance Lead Reviews high-stakes escalations and signs off on capital commitments.
Configurer Data Manager / IT Admin Manages "Playbook" logic and monitors upstream data source health.
Admin System Administrator Sets governance rules and manages cross-facility permissions.

✨ Key Features & Business Value

  • πŸ“Š Prioritized Recommendation Feed: Actionable insights ranked by financial impact and urgency.
  • πŸ§ͺ Simulation Laboratory ("What If Room"): Sandboxed environment to test variables (e.g., "What if the shipment is 2 days late?") before committing.
  • πŸ›‘οΈ Immutable Audit Ledger: A verified "Black Box" recording every decision, persona, and reasoning for compliance.
  • πŸ“‰ Executive Analytics (Learning Loop): Real-time tracking of recommendation accuracy and net business impact.
  • πŸ—οΈ Governance Engine: Automated escalation rules based on financial thresholds or confidence deficits.
  • πŸ“‘ Data Source Integrity: Real-time monitoring of the "connective tissue" (SAP, WMS, CRM connections).

πŸ›  Technology Stack

Frontend / UI

  • πŸ“± Kotlin 2.1.0: Modern, concise language for Android development.
  • 🎨 Jetpack Compose: Declarative UI framework for the modern "Command Center" aesthetic.
  • 🌈 Material 3: Standardized design system for premium enterprise visuals.
  • πŸ“‰ Canvas API: Custom high-performance charting for trendlines and gauges.

Backend & Data

  • πŸ› Room Database: Local SQLite persistence for offline-first operational reliability.
  • πŸ›° Retrofit 2.11: Type-safe HTTP client for enterprise API synchronization.
  • 🧬 Coroutines & StateFlow: Reactive, multi-threaded state management.
  • πŸ“¦ Gson: High-performance JSON serialization for complex data models.

DevOps & Tooling

  • πŸ›  KSP (Kotlin Symbol Processing): Next-gen annotation processing for Room.
  • 🐘 Gradle (Kotlin DSL): Robust build automation.
  • πŸ§ͺ MockK & JUnit: Industry-standard unit testing.
  • πŸ”” Android Notifications: High-importance channels for critical early warnings.

πŸ— System Architecture

High-Level Component View

graph TD
    subgraph Mobile_App [Quorra Android Application]
        UI[Jetpack Compose UI]
        VM[MainViewModel]
        REPO[QuorraRepository - SSOT]
        LOCAL[(Room SQLite DB)]
    end

    subgraph External_Services [Enterprise Infrastructure]
        API[REST API Service]
        ERP[SAP ERP / WMS]
        CRM[Salesforce CRM]
    end

    UI <--> VM
    VM <--> REPO
    REPO <--> LOCAL
    REPO <--> API
    API <--> ERP
    API <--> CRM
Loading

Responsibilities:

  • UI Layer: Declarative components that observe StateFlow and render based on the current Persona/Facility context.
  • ViewModel: Manages UI state, navigation logic, and triggers repository refreshes.
  • Repository (SSOT): The Single Source of Truth. Manages the logic between local persistence (Room) and remote synchronization.
  • Local DB: Ensures the platform remains functional in low-connectivity facility environments.

Data Flow Lifecycle

sequenceDiagram
    participant U as User
    participant V as ViewModel
    participant R as Repository
    participant D as Room DB
    participant N as Network (API)

    U->>V: Trigger Decision (Approve)
    V->>V: Show Reasoning Dialog
    U->>V: Provide Reasoning
    V->>R: makeDecision(id, notes)
    R->>D: Insert AuditLog & Update Status
    R->>N: Sync Decision to Backend
    D-->>V: Flow Emit Updated State
    V-->>U: Update Feed (Success)
Loading

πŸ“‚ Project Structure

com.example.quorra
β”œβ”€β”€ data
β”‚   β”œβ”€β”€ local          # Room Database, DAOs, and Type Converters
β”‚   β”œβ”€β”€ model          # Core Domain Entities (Recommendation, Playbook, etc.)
β”‚   β”œβ”€β”€ remote         # Retrofit API definitions and HTTP Client
β”‚   └── repository     # Single Source of Truth (SSOT) logic
β”œβ”€β”€ ui
β”‚   β”œβ”€β”€ components     # Reusable UI Atoms (ConfidenceMeter, Badges, etc.)
β”‚   β”œβ”€β”€ theme          # Modern Navy/Teal Color System & Typography
β”‚   β”œβ”€β”€ util           # Notification and Helper utilities
β”‚   └── *Screen.kt     # High-level Screen definitions (Feed, Lab, Analytics)
└── MainActivity.kt    # Entry point & Global Navigation Controller

βš™οΈ Environment Configuration

Quorra requires specific environment variables for backend integration. Duplicate .env.example to .env (or configure local.properties):

# Example local.properties config
QUORRA_API_BASE_URL="https://api.example.com/v1/"
ENABLE_CRITICAL_NOTIFICATIONS=true

πŸ›  Local Development Setup

Prerequisites

  • Android Studio Ladybug (or newer)
  • JDK 17
  • Android SDK 34+
  • Kotlin 2.1.0

Installation

  1. Clone the repository:
    git clone https://github.com/alfinohatta/quorra.git
  2. Open the project in Android Studio.
  3. Sync Gradle and ensure all dependencies are resolved.

Build & Run

  • Debug Build: Use the app:assembleDebug task or press Run in Android Studio.
  • Unit Tests:
    ./gradlew test

πŸ›‘ Security & Compliance

  • Data Isolation: All recommendations are filtered by companyId to support multi-tenancy.
  • Audit Integrity: Decision logs are designed to be append-only (immutable) in the production backend.
  • Persona Restrictions: UI elements (e.g., "Approve" buttons) are reactively disabled based on the UserRole of the active session.

❓ Troubleshooting & FAQ

Q: Why am I not seeing recommendations? A: Ensure your active Persona is set correctly and the "Facility Switcher" is targeting a region with active data.

Q: How are confidence scores calculated? A: Data Confidence measures input signal health; Model Confidence measures prediction stability. See RecommendationItem.kt for visual thresholds.


🀝 Contribution & License

Contribution Guidelines

  1. Fork the repo and create your branch from main.
  2. Ensure all UI components follow the navy/teal theme in Theme.kt.
  3. Document all new DAOs in the QuorraDao interface.

License

Distributed under the License. See LICENSE for more information.


πŸ“ˆ Operational Best Practices

  • Human-on-the-Loop: Never automate "Approved" status for items with RiskLevel.HIGH.
  • Reasoning Requirement: Always enforce the reasoning dialog for overrides to maintain ledger integrity.
  • Early Warnings: Use the high-importance notification channel for UrgencyLevel.CRITICAL alerts only.

About

Quorra is a high-performance Decision-Intelligence (DI) platform for Android. It transforms complex, fragmented operational data into explainable, auditable, and trustworthy recommendations using a Human-on-the-Loop (HOTL) approach.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages