haldis/README.md

44 lines
1.3 KiB
Markdown
Raw Normal View History

Haldis
2015-03-31 18:15:22 +00:00
=======
Haldis is your friendly neighbourhood servant. He exists so lazy fucks like you and me don't need to keep tabs of who is ordering what from where.
2015-03-31 18:15:22 +00:00
Start an order and let people add items with a simple mouse-click!
No more calculating prices and making lists!
Be lazier today!
2018-03-08 22:23:02 +00:00
2019-04-05 00:04:46 +00:00
## Local setup
There is a special script to get started with the project. Just run it in the root of the project.
2019-04-05 00:05:54 +00:00
./first-setup.sh
2019-04-05 00:04:46 +00:00
This will create a virtual environment, install the necessary dependencies and will give you the option to seed the database.
If you are using a database other then sqlite you will first need to configure the correct uri to the database in the generated 'config.py' file.
Afterwards upgrade the database to the latest version using
python app/haldis.py db upgrade
2019-04-05 00:04:46 +00:00
You can now still seed the database by running
./populate-db.sh
in the root folder of the project.
Activate the virtual environment using
source venv/bin/activate
Finally run the webserver with
python app/haldis.py runserver
2019-04-05 00:04:46 +00:00
## Development
### Changing the database
1. Update models located in 'app/models.py'
2. Run `python app/haldis.py db migrate` to create a new migration.
3. Apply the changes to the database using `python app/haldis.py db upgrade`