See preview here: https://myexpenses-service.herokuapp.com/
- User: demo
- Password: myexpenses
Find yourself here
MYExpenses is a web app to manage earnings and expenses, view earnings and expenses data in dynamic graphs, generate reports and receive reminders about monthly expenses.
- PostgreSQL
- Redis
- Python
- Django framework
- Celery (Task Queue)
- Celery Beat
- Crontab
- HTML5
- CSS3
- Materialize css
- SASS
- username
- password
- confirm password
- email confirmation
- It is possible to log in using username and password, Google or GitHub account
- Change your profile photo and description
- Reset your password
- Update your data including username and email
- Darkmode option
- You can recover your access typing your e-mail used when you register
- Supports more than 100 currencies
- You can add monthly or single earnings and expenses
- You can update and delete earnings and expenses
- It is possible to filter by category, interval date, currency or monthly earnings or expenses
- if you have a lot of earnings and expenses you can search by title, description or value
- See your earnings and expenses on interactive charts dynamically including:
- Earnings and Expenses from January to December in the current year
- First to fourth week of the current month
- View the amount of your earnings and expenses by category
- See the amount in the last five years
- View your earnings and expenses by currency including:
- Total in the current year, last three months, current month
- Earnings or Expenses per currency in the current year
- Earnings or Expenses per currency in the current month
- Earnings or Expenses per currency in the last three months
- Current Earanings or Expenses per currency
- When adding monthly expenses you receive emails on the 1st and 15th every month.
- You can export your report data in pdf format
git clone https://github.com/GiovannaK/MYExpenses.gitpython -m venv venv
venv\Scripts\activate.bat
python -m pip install --upgrade pip setuptools wheel --user
pip install -r requirements.txt
python manage.py migratepython3 -m venv venv
. venv/bin/activate
pip install -r requirements.txt
python manage.py migratepython -m venv venv
. venv/bin/activate
pip install -r requirements.txt
python manage.py migrateDATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql_psycopg2',
'NAME': 'db_name',
'USER': 'name',
'PASSWORD': '',
'HOST': 'localhost',
'PORT': '',
}
}- This application uses celery and redis as storage and broker, include your redis credentials to start celery in settings.py.
REDIS_URI is an environment variable, in case you want to add a service like heroku redis.
CELERY_BROKER_URL = os.environ.get("REDIS_URI", "redis://redis:6379/0")
CELERY_RESULT_BACKEND = os.environ.get("REDIS_URI", "redis://redis:6379/0")- Assuming you already have the docker installed and properly configured run the following command build the image and start the container. This application has four containers including web for Django, Celery, Celery beat and redis.
docker-compose up- Stop it all running
docker-compose down- In case you change something in docker-compose.yml
docker-compose build- In case you need to build only one container
docker-compose build containernameS3 bucket was used to store static files and images you can create an account in AWS, create a bucket and setup the credentials in settings.py
AWS_ACCESS_KEY_ID = config('AWS_ACCESS_KEY_ID')
AWS_SECRET_ACCESS_KEY = config('AWS_SECRET_ACCESS_KEY')
AWS_STORAGE_BUCKET_NAME = config('AWS_STORAGE_BUCKET_NAME')
AWS_S3_FILE_OVERWRITE = False
AWS_DEFAULT_ACL = None
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
STATIC_URL = 'http://' + AWS_STORAGE_BUCKET_NAME + '.s3.amazonaws.com/'
ADMIN_MEDIA_PREFIX = STATIC_URL + 'admin/'If you don't want to use the S3 bucket, delete the credentials, remove ADMIN_MEDIA_PREFIX and change STATIC_URL to
STATIC_URL = '/static/'docker-compose exec web python manage.py migratedocker-compose exec web python manage.py createsuperuserdocker-compose exec web python manage.py runserverMIT License
Copyright (c) [2020]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
- Linkedin - Giovanna Cunha