Tapir — Member & Shift Management System

Tapir is a web application for cooperative member and shift management used by cooperatives such as SuperCoop Berlin and Rizoma. It covers member profiles, shift scheduling and booking, automatic emails, and application workflows.

Key features

• Member management: profiles, contact details, qualifications, shopping-status, membership-fees
• Shift management: create shifts, sign up, cancel, find substitutes
• Coop statistics: track and vizualize purchases
• Mailings & notifications: automatic emails for shifts or reminders
• Application workflow: review, accept or reject applicants
• Roles & permissions: board, employees, member office, regular members
• Internationalization: multi-language support

Quickstart

1. Clone

git clone https://github.com/SuperCoopBerlin/tapir.git

2. Run docker compose up -d. The first time may take a while, following runs will be much shorter
3. Install migrations and generate test data:

docker compose exec web poetry run python manage.py migrate
docker compose exec web poetry run python manage.py generate_test_data --reset_all

Tapir should now be accessible under http://localhost:8000. You can login with username roberto.cortes and password roberto.cortes (same as the username).

Contributing

Everyone is welcome — coding skills not required.

How to contribute

• Report issues or feature requests in Issues
• Find beginner tasks with the good first issue label
• Improve docs, translate UI strings, verify workflows, test

Developer quick steps see CONTRIBUTING.md.

Code style & tooling

• Use black; pre-commit hooks recommended
• Run pytest locally before PRs
• Have a look at our wiki and in particular "Setting-up-you-development-environment" how to run Tapir on your machine and how to setup your IDE.

Non-technical contributions

• Translations: see CONTRIBUTING.md for how to add language files
• Documentation: edit the wiki
• Support & testing: help reproduce bugs, triage issues

Important links

• Wiki (setup & how-tos): https://github.com/SuperCoopBerlin/tapir/wiki
• SuperCoop members can access the system at https://members.supercoop.de
• Issues: https://github.com/SuperCoopBerlin/tapir/issues
• Contact: If you're interested in using Tapir for your own cooperative, we'd be happy to help. Create an issue in this repo or write to Théo directly.

Tapir (/ˈteɪpər/) has a trunk, but not quite such a beautiful one as Mme. l'élephan. Tapir is badass, but not quite as badass as the other animals. Let's teach Tapir some tricks!