Governed analytics platform for the InteLIS Laboratory Information System. Transforms laboratory data into actionable program intelligence while maintaining strict privacy controls.
- Smart Dashboard — Predefined national indicators with interactive charts
- Saved Reports — Reusable structured analyses
- Conversational Authoring — AI-assisted query building via chat interface
- Knowledge Assistance — RAG-powered, privacy-safe document Q&A
| Layer | Technology |
|---|---|
| Backend | PHP 8.4+, Slim 4, Eloquent ORM |
| Frontend | Tailwind CSS, Alpine.js, Chart.js |
| Database | MySQL (app + InteLIS query databases) |
| RAG | Python FastAPI sidecar, Qdrant vector DB |
| LLM | Configurable via LLM sidecar (Claude, DeepSeek, etc.) |
| Migrations | Phinx |
Requires only Docker and Git.
git clone --recurse-submodules https://github.com/deforay/intelis-insights.git
cd intelis-insights
cp .env.example .env # add at least one LLM API key
make up # starts all servicesOpen http://localhost:8080 once services are healthy (make status to check).
LLM query features require the InteLIS database. Import a dump or connect to an external instance:
# Import a dump into the Docker MySQL container
make db-import FILE=path/to/intelis-dump.sql
make rag-refresh
# — or connect to an external instance via .env —
# QUERY_DB_HOST=lab-db-server.example.com
# QUERY_DB_NAME=vlsm
# QUERY_DB_USER=readonly_user
# QUERY_DB_PASSWORD=readonly_passSee the full documentation for detailed guides, concepts, and troubleshooting.
- Prerequisites — What you need before starting
- Docker Setup — Step-by-step Docker installation
- Manual Setup — Running services natively
- Architecture — How the system works
- Glossary — Key terms explained
- Troubleshooting — Common problems and fixes
├── config/ # App, DB, and business-rule configuration
├── database/ # SQL schema & seed files
├── docker/ # Docker support files (nginx, init scripts)
├── public/ # Web root (index.php, assets, views)
├── rag-api/ # Python RAG sidecar (FastAPI + Qdrant)
├── llm-sidecar/ # LLM gateway (git submodule)
├── src/
│ ├── Bootstrap/ # Database bootstrapping
│ ├── Controllers/ # Chat & Report controllers
│ ├── Models/ # Eloquent models
│ └── Services/ # LLM, RAG, Query, Chart services
├── docker-compose.yml # Full stack (MySQL, Qdrant, RAG, LLM, App)
├── Makefile # Developer convenience commands
├── composer.json
└── phinx.php # Migration config
make help # list all targets
make status # check service health
make logs # follow all service logs
make shell # open shell in PHP container
make db-shell # open MySQL CLI
make rag-refresh # re-seed RAG index
make clean # remove containers + volumesAGPL-3.0 — see LICENSE for details.