mirror of
https://github.com/lucaspalomodevelop/eventcally.git
synced 2026-03-13 00:07:22 +00:00
90 lines
3.3 KiB
Markdown
90 lines
3.3 KiB
Markdown
# Goslar Event Prototype
|
|
|
|
 [](https://codecov.io/gh/DanielGrams/gsevpt) [](https://github.com/psf/black) 
|
|
|
|
Website prototype using Python, Flask and Postgres.
|
|
|
|
## Automatic Deployment
|
|
|
|
[](https://heroku.com/deploy)
|
|
|
|
## Docker
|
|
|
|
```sh
|
|
docker run -p 5000:5000 -e "DATABASE_URL=postgresql://postgres@localhost/gsevpt" danielgrams/gsevpt:latest
|
|
```
|
|
|
|
## Manual Installation
|
|
|
|
### Requirements
|
|
|
|
- Python 3.7
|
|
- pip
|
|
- Postgres with postgis
|
|
|
|
### Create database
|
|
|
|
```sh
|
|
psql -c 'create database gsevpt;' -U postgres
|
|
```
|
|
|
|
### Install and run
|
|
|
|
```sh
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
(venv) pip install -r requirements.txt
|
|
(venv) export DATABASE_URL='postgresql://postgres@localhost/gsevpt'
|
|
(venv) flask db upgrade
|
|
(venv) gunicorn -c gunicorn.conf.py project:app
|
|
```
|
|
|
|
## Scheduled/Cron jobs
|
|
|
|
Jobs that should run on a regular basis.
|
|
|
|
### Daily
|
|
|
|
```sh
|
|
flask event update-recurring-dates
|
|
flask dump all
|
|
```
|
|
|
|
## Administration
|
|
|
|
```sh
|
|
flask user add-admin-roles super@hero.com
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Create `.env` file in the root directory or pass as environment variables.
|
|
|
|
### Security
|
|
|
|
| Variable | Function |
|
|
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| SECRET_KEY | A secret key for verifying the integrity of signed cookies. Generate a nice key using `python3 -c "import secrets; print(secrets.token_urlsafe())"`. |
|
|
| SECURITY_PASSWORD_HASH | Bcrypt is set as default SECURITY_PASSWORD_HASH, which requires a salt. Generate a good salt using: `python3 -c "import secrets; print(secrets.SystemRandom().getrandbits(128))"`. |
|
|
|
|
### Send notifications via Mail
|
|
|
|
| Variable | Function |
|
|
| ------------------- | ------------------------------------------ |
|
|
| MAIL_DEFAULT_SENDER | see <https://pythonhosted.org/Flask-Mail/> |
|
|
| MAIL_PASSWORD | " |
|
|
| MAIL_PORT | " |
|
|
| MAIL_SERVER | " |
|
|
| MAIL_USERNAME | " |
|
|
|
|
### Misc
|
|
|
|
| Variable | Function |
|
|
| ------------------- | -------------------------------------------------------------------------------------------- |
|
|
| CACHE_PATH | Absolute or relative path to root directory for dump and image caching. Default: project/tmp |
|
|
| GOOGLE_MAPS_API_KEY | Resolve addresses with Google Maps: API Key with Places API enabled |
|
|
|
|
## Development
|
|
|
|
[Development](doc/development.md)
|