zeton_django

Zeton is an application that support behavioral therapy. Token system for the child. Allows you to earn points for your activities and exchange them for prizes.

Application goals

Developing deficit (desirable) behaviour
Reduction of undesired behaviour
Generating and maintaining therapy effects over time

Dependencies

Dependency management

Install poetry on your local machine (installation with pipx is recommended).
In order to add a new dependency and its sub-dependencies use the following command:

poetry add $dependency_name

This command will edit both pyproject.toml and poetry.lock files for you. 🙂
Install the project dependencies using the pyproject.toml file in the current directory:

poetry install
Get the latest version of all dependencies and update poetry.lock:

poetry update
Execute a command inside the project's virtual environment:

poetry run command
Spawn a shell within the project's virtual environment:

poetry shell

Contributing

Before you make any commits to this repository make sure to install [pre-commit]() hooks:

# install pre-commit on your machine using pipx if you haven't already
❯ pipx install pre-commit
# install hooks defined in .pre-commit-config.yaml (only needs to be done once)
❯ pre-commit install
# (optional) invoke pre-commit against all files
❯ pre-commit run -a

Docker and docker-compose

Install Docker

If you use Linux and need to use sudo before docker compose command just follow step below:

Manage Docker as a non-root user: Post-installation steps for Linux

We use Docker Compose V2 which is integrated into Docker Desktop versions. For more information, see Migrate to Compose V2
Commands:

If you want to build and run containers - you can do it in two ways:

Build and run containers:

docker compose up -d --build

Build the image: docker compose build

Fire up containers: docker compose up

Or fire up containers in detached mode: docker compose up -d

Database: postgres (Django, docker-compose)

To make migrations and migrate:

docker compose exec web python manage.py makemigrations
docker compose exec web python manage.py migrate

To create superuser: docker compose exec web python manage.py createsuperuser

To populate data

To populate data using fixtures: make load_data

To rebuild database

If you want rebuild database, you can use command: docker compose down -v

WARNING! This command will delete all data from the database

Register and login user in the Django app

Go to http://localhost:8000/admin and create a new user.

Access API

Auth

To run app with tokens, set .local.env ENVIRONMENT to PROD.

Go to http://localhost:8000/api/users/register/

You may use Postman for that.

As you can see below, you can fill the body form-data with info:

After that you can hit http://localhost:8000/api/users/students/ with GET method and put into Headers key and value.

Then you have access to private endpoint.

More private endpoints:

Go to http://localhost:8000/api/users/students/

You may expect this result:

[
    {
        "pk": 1,
        "email": "wojtek-zeton@mailinator.com",
        "username": "wojtek",
        "first_name": "Wojtek",
        "last_name": "",
        "total_points": 250
    },
    {
        "pk": 2,
        "email": "kuba-zeton@mailinator.com",
        "username": "kuba",
        "first_name": "Kuba",
        "last_name": "",
        "total_points": 120
    }
]

Go to http://localhost:8000/api/users/students/1

Result:

{
    "pk": 1,
    "email": "wojtek-zeton@mailinator.com",
    "username": "wojtek",
    "first_name": "Wojtek",
    "last_name": "",
    "total_points": 250
}

Go to http://localhost:8000/api/users/prizes/

[
    {
        "pk": 1,
        "student": "1",
        "name": "Puszka Coca-cola",
        "value": 10
    },
    {
        "pk": 2,
        "student": "2",
        "name": "1 godzina na basenie",
        "value": 30
    }
]

Go to http://localhost:8000/api/users/prizes/1

Result:

{
    "pk": 1,
    "student": "1",
    "name": "Puszka Coca-cola",
    "value": 10
}

Similarly, tasks:

Go to http://localhost:8000/api/users/tasks/ http://localhost:8000/api/users/tasks/1

Points endpoints

There are currently several enpoints responsible for managing student points available:

api/users/points/ accesible with a GET request and followed by a query string pointing to a student primary key. For example: api/users/points/?studentId=2 should return Point instances assigned to the student with pk=2
api/users/points/ accessible with POST request, payload in a given format is required:

{
    "value": 40,
    "assigner": 1,
    "student": 1,
}

As a result you should receive a response similar to the following:

{
    "pk": 5,
    "value": 40,
    "assigner": 1,
    "student": 1,
    "assignment_date": "2021-01-26T21:41:04.952509Z"
}

Tests

There are also some tests, checking above endpoints, available in the users/tests/users/test_points.py module.

To execute the tests simply call docker compose exec web pytest (you can add the -v flag for a verbose ouput).

Planned endpoints

GET /api/students / DONE

List all students for logged in caregiver

POST /api/students (future)

Add new student for a caregiver

GET /api/students/ / DONE

Retrieve information about student with given ID:

...
total_points

PATCH /api/students/ / DONE

Update student

GET /api/students//points / DONE

List history of points received by student

POST /api/students//points (no longer needed)

~~Add new points to student~~ Points should be automatically added when completing a task (another endpoint) (session012)

GET /api/students//tasks | DONE

List of tasks assigned to student

POST /api/students//tasks | DONE

Add new task for student

PATCH /api/students//tasks/

Edit existing task + soft delete

GET /api/students//prizes / DONE

List of prizes assigned to student

POST /api/students//prizes / DONE

Add new prize for student

PATCH /api/students//prizes/

Edit existing prize + soft delete

POST /api/students//tasks//reward

Add points to student for a completed task

POST /api/students//prizes//claim

Exchange points for prize

POST /api/caregivers (future)

Add new caregiver

POST /api/roles (future)

Add new role (association between student and caregiver)

Swagger ui

Our project supports a minimal swagger UI setup for Django Rest Framework, described here. You can access it with http://localhost:8000/swagger-ui endpoint. Openapi compliant text documentation: http://localhost:8000/openapi

zetonteam / zeton_django

readme