labric-technical

A lab data management backend: organizations run experiments on instruments, instruments sync files, and files can trigger processing jobs.

Setup

1. Copy .env.sample to .env.local and fill in values (any non-empty values work for dev).

2. Run make initial-setup to install dependencies, build the containers, and migrate.

3. Optionally seed example data:

   docker compose -f .compose.dev.yml exec django python manage.py load_example_data

The API is served at http://localhost:8001/api/ with interactive docs at http://localhost:8001/api/docs.

Authentication

Requests authenticate with a per-user API token and an active organization:

curl http://localhost:8001/api/jobs \
  -H "Authorization: Bearer token-maya-helios" \
  -H "X-Organization-Id: <organization id>"

User tokens for the example data are in core/management/data/users.csv. List your organizations (and their ids) with GET /api/organizations, which only requires the Authorization header.

Development

See the Makefile for common commands. Run the test suite with:

make test