Aposto is a 💸 free, 🌱 light, ✨ easy-to-use and 📖 open-source billing software dedicated to Swiss therapist. It allows generating invoices in compliance with new standard Tarif 590 in a few seconds.

🔥 Aposto is already online on app.aposto.ch. Find a full introduction to its features on aposto.ch.

🇫🇷 Note that Aposto is currently only available in French.

This repository contains the API server the application is using. This server is responsible for 🧾 generating the PDF invoice or 💌 sending the PDF invoice by email to the patient and the therapist using SendInBlue mailing service.

This API server is designed using Starlette lightweight framework in Python.

Link to the Web application repository

To run the Aposto API on your machine, you need:

• python3.* (download link - after installation)
• pip3.* (ensure pip is installed and up to date)

And that's it! The project will install all the Python module dependencies itself on the next step. 🤙

In the terminal of your choice, go through the following steps:

• Install the project: make install → It creates the Python virtual environment and installs all the needed Python modules.
  Note: You only have to run this command the first time.
• Start the project: make start → It launches the server on 4 workers.
• Or start the project in developer mode: make dev → It starts the project with a watcher but only 1 worker. The server automatically reloads when you edit files.

You're done! The server is now running on http://localhost:8080/. 🚀

Read the API documentation

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.