ProjectSILIP

SCORM Inspection & Learning Intelligence Platform — a desktop application that lets you import, play, and inspect SCORM 1.2 / 2004 learning packages with real-time telemetry, gamification triggers, and an ML-powered RAG chatbot.

Tech Stack

Layer	Technology
Frontend	React 19 + TypeScript (Vite)
Backend API	ASP.NET Core 10 (C#)
Desktop Shell	Photino.NET (cross-platform webview)
Database	SQLite (via EF Core)
ML Bot	Python 3 — FastAPI, sentence-transformers, RAG pipeline
Packaging	Velopack (auto-update installer)

Prerequisites

Tool	Version
.NET SDK	10.0+
Node.js	20.19+ or 22.12+
Python	3.11+ (only for the ML bot)
Docker	24+ (optional — for containerised run)

---

Running Locally

1. Build the React client

cd projectsilip-client
npm install
npm run build

2. Run the .NET desktop app

# From the repository root
dotnet run --project ProjectSILIP.Desktop

This starts the Photino desktop window which hosts the ASP.NET Core backend and serves the built React frontend.

Quick one-liner

cd projectsilip-client && npm run build && cd .. && dotnet run --project ProjectSILIP.Desktop

3. (Optional) Run the ML Bot separately

cd ml-bot
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python app.py

The bot starts a FastAPI server that the main app auto-discovers.

---

Running with Docker

Option A — Docker Compose (recommended)

docker compose up --build

The app will be available at http://localhost:5000.

To run in the background:

docker compose up --build -d

To stop:

docker compose down

Option B — Docker build & run manually

# Build the image
docker build -t projectsilip .

# Run the container
docker run -p 5000:5000 projectsilip

---

Project Structure

ProjectSILIP/
├── projectsilip-client/    # React + Vite frontend
├── ProjectSILIP.Api/       # ASP.NET Core Web API + SignalR hubs
├── ProjectSILIP.Core/      # Domain models, SCORM parsing, services
├── ProjectSILIP.Desktop/   # Photino desktop shell (entry-point)
├── ProjectSILIP.Core.Tests/# Unit tests for Core
├── ProjectSILIP.Tests/     # Integration tests
├── ml-bot/                 # Python ML/RAG chatbot
├── samples/                # Sample SCORM packages for testing
├── docs/                   # Documentation and pitch materials
├── Dockerfile              # Multi-stage Docker build
├── docker-compose.yml      # Compose orchestration
└── requirements.txt        # Python dependencies (ml-bot)

Development

Frontend dev server (hot-reload)

cd projectsilip-client
npm run dev

Vite dev server runs on http://localhost:5173 by default and proxies API calls to the .NET backend.

Running tests

# .NET tests
dotnet test

# Client lint
cd projectsilip-client && npm run lint

License

See LICENSE for details.