Fusio(n) Research Collaboration Platform

flowchart LR
  classDef ui fill:#dceeff,stroke:#4338ca,color:#151315,stroke-width:1.5px
  classDef laravel fill:#fee2d2,stroke:#c2410c,color:#151315,stroke-width:1.5px
  classDef async fill:#dff3e7,stroke:#087f8c,color:#151315,stroke-width:1.5px
  classDef data fill:#fff7db,stroke:#b7791f,color:#151315,stroke-width:1.5px
  classDef external fill:#fffdfa,stroke:#151315,color:#151315,stroke-width:1.5px

  subgraph experience["Product experience"]
    direction TB
    react["React + Inertia UI<br/>flows / teams / hub / messages"]
    workflows["Discovery surfaces<br/>Hard / ML / Content / Team Science"]
    admin["Admin and metrics views<br/>keywords / AI health / demo tools"]
  end

  subgraph domain["Laravel domain layer"]
    direction TB
    routes["Routes + controllers<br/>validated product actions"]
    services["Service classes<br/>matching / teams / communication"]
    providers["AI provider abstraction<br/>embedding / extraction / explanation"]
  end

  subgraph realtime["Async and realtime"]
    direction TB
    jobs["Redis-backed jobs<br/>recommendations / entity processing"]
    reverb["Laravel Reverb<br/>messages / notifications / team updates"]
    octane["Octane + FrankenPHP<br/>long-running web runtime"]
  end

  subgraph storage["Data and services"]
    direction TB
    postgres[("PostgreSQL<br/>users / teams / communications")]
    vector[("pgvector<br/>entity embeddings / semantic matches")]
    redis[("Redis<br/>cache / sessions / queues")]
    mlapi["Companion FastAPI ML service<br/>heavier collaborator ranking"]
  end

  react -->|"Inertia requests"| routes
  workflows --> react
  admin --> react
  routes --> services
  services --> providers
  services --> postgres
  providers --> vector
  services --> vector
  services --> jobs
  jobs --> redis
  routes --> redis
  services --> mlapi
  services --> reverb
  reverb -.->|"Echo broadcasts"| react
  octane --> routes
  redis --> reverb

  class react,workflows,admin ui
  class routes,services,providers laravel
  class jobs,reverb,octane async
  class postgres,vector,redis data
  class mlapi external

Fusio(n) is a research collaboration platform built around the problem of helping researchers and adjacent public, industry, and civil-society participants find useful collaborators, assemble teams, and coordinate work.

The project is not only a Laravel app with a React frontend. From a technical perspective it includes multiple matching paths, a profile system, AI and semantic infrastructure, collaboration workflows, real-time communication, and operational documentation.

Product Scope

The platform supports profile-driven onboarding where users describe what they are searching for and what expertise they can offer. Those profiles feed several discovery workflows:

• Hard Flow for deterministic profile and keyword matching
• ML Flow for external workgroup API powered collaborator ranking through the Research Collaboration ML Matching API
• Content Flow for research-related recommendations
• Team Science for building teams around selected keyword coverage
• Collaboration Hub for searching users, saving content, and initiating collaboration requests
• AI Bio Matching for processing research bios into structured documents, embeddings, and semantic matches
• Unified communications for messages, collaboration requests, team notifications, and live updates

The ML Flow is separated as its own service because model inference, embedding cache, batch processing, and GPU/CPU runtime concerns are different from the Laravel product runtime. Fusio(n) carries the user-facing workflow, while the companion ML API handles heavier researcher matching behavior.

Architecture

The backend is built with Laravel 12 on PHP 8.3. Inertia.js connects the Laravel routes and controllers to a React 19 and TypeScript frontend built with Vite and Tailwind CSS.

The application separates domain behavior into controllers, jobs, models, events, providers, policies, and service classes. Important technical boundaries include:

• embedding generation, caching, storage, and vector similarity lookup
• semantic search, hybrid boost scoring, match explanation, and cached results
• companion ML service integration for heavier matching and workgroup analysis
• direct messages, collaboration requests, team threads, and realtime broadcasts
• team gap analysis and user/content recommendation workflows
• operational metrics for latency, cache behavior, usage, and match quality

AI and Matching Infrastructure

The AI layer uses a provider abstraction so embedding, structured extraction, match explanation, retry, timing, and usage accounting behavior can be handled behind one application boundary.

Semantic matching is backed by PostgreSQL with pgvector. The schema stores raw entity documents, cleaned content, structured data, embeddings, cached semantic matches, match feedback, and embedding job status. The embedding table uses a vector column and an HNSW cosine index for fast similarity search.

The matching pipeline combines vector similarity with rule-based boosts. Boosts account for discipline overlap, career-stage compatibility, keyword/topic overlap, and target-specific eligibility. This makes the result more useful than plain nearest-neighbor search alone.

Real-Time Collaboration

The communication system moved beyond basic message tables into a unified thread model. It supports direct messages, collaboration requests, team threads, hub collaboration requests, participant responses, unread counts, notifications, keyword assignment actions, replacement suggestions, and coverage analysis.

Laravel Reverb and Laravel Echo provide the real-time layer. Events such as messages, communication updates, team updates, recommendation readiness, and notification changes are broadcast to the frontend so collaboration state can update without manual refreshes.

Operational Readiness

The operational design separates web serving, realtime broadcasting, cache/session storage, and queue workloads. The public case study keeps this intentionally high-level and does not expose environment names, startup automation, private application paths, or recovery procedures.

The readiness work includes:

• cache and queue separation
• realtime broadcasting boundaries
• migration and release sequencing
• configuration caching strategy
• operational notes for observability and handoff
• post-release verification checklists

Reliability work also includes abuse-prevention controls, queue planning, AI dependency health checks, performance notes, test coverage, and operational documentation.

Quality and Reliability Work

The public page avoids exposing exact protective controls or private application paths. At a technical level, the project includes:

• gated application flows
• centralized input validation
• abuse-prevention boundaries
• AI usage controls
• data minimization in recommendation outputs
• feature tests for core product behavior
• automated formatting, linting, and build checks

Technical Perspective

This case study demonstrates full-stack technical breadth rather than isolated feature work. The visible scope includes Laravel backend development, React/Inertia frontend implementation, AI matching infrastructure, data modeling, async jobs, realtime communication, performance tuning, and operational documentation.