You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kompass/README.md

36 lines
1.6 KiB
Markdown

# jdav_lb_webapp
This repository has the purpose to develop a webapplication that can be used by
JDAV to send newsletters, manage user lists and keep material lists up to date.
As this repository is also meant to be a base for exchange during development, feel free
to contribute ideas in form of edits to this README, issues, landmarks, projects, wiki entries, ...
# Setup
## Development server
1. Install `virtualenv` (with pip3)
2. Create a new virtualenv with `virtualenv --no-site-packages -p python3.5`
3. Activate the environment with `source venv/bin/activate`
4. Install requirements with `pip3 install -r requirements.txt`
5. Setup a MySQL database called `jdav_db` and create a user that can access this database.
6. Create a `my.cnf` at `jdav_web/my.cnf` with username and password for the mysql database.
7. Change working directory to `jdav_web` and execute `python3 manage.py runserver`
## Deployed version
- Mostly the same as the development version
- Check the README on the server for further information.
# Useful stuff
## Reset database for certain app
The following can be useful in case that automatic migrations throw errors.
1. delete everything in the migrations folder except for __init__.py.
2. drop into my MySQL console and do: DELETE FROM django_migrations WHERE app='my_app'
3. while at the MySQL console, drop all of the tables associated with my_app.
4. re-run ./manage.py makemigrations my_app - this generates a 0001_initial.py file in my migrations folder.
5. run ./manage migrate my_app - I expect this command to re-build all my tables, but instead it says: "No migrations to apply."