![License: AGPL-3.0](https://img.shields.io/github/license/projectcaluma/caluma
A collaborative form editing service.
Caluma Service is the core part of the Caluma project providing a GraphQL API. For a big picture and to learn what Caluma does for you, have a look at caluma.io
Requirements
- docker
- docker-compose
After installing and configuring those, download docker-compose.yml and run the following command:
docker-compose up -d
You can now access GraphiQL at http://localhost:8000/graphql which includes a schema documentation. The API allows to query and mutate form and workflow entities which are described below.
Caluma is a 12factor app which means that configuration is stored in environment variables. Different environment variable types are explained at django-environ.
You can read more about running and configuring Caluma under docs/configuration.md
Set environment variable ENV
to dev
to enable debugging capabilities. Don't use this in production as it exposes confidential information!
This enables Django Debug Middleware.
For profiling you can use ./manage.py runprofileserver
. See docker-compose.override.yml for
an example.
Code released under the MIT license.
- Installation & Configuration - Get started installing Caluma in a production context
- Contributing - If you want to help us, here's how to start with your first contribution.
- Caluma Guide - How to get up and running with Caluma
- Workflow Concepts - How to use caluma workflows
- Historical Records - Undo and audit trail functionality
- GraphQL - Further information on how to use the GraphQL interface
- Validation - Validation of user input
- Extending Caluma - Extensions: Data visibility and permissions