Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

A full stack web an application that allows the user to track their favourite things. API implemented using Django REST framework

License

NotificationsYou must be signed in to change notification settings

nzediegwu1/favorite-things

Repository files navigation

CircleCIMaintainabilityCoverage Status

A full stack web an application that allows the user to track their favorite things.

Table of Contents

1. Features2. Technologies3. Entity relationship diagram4. Installation and Setup5. Suggested improvement6. Documentation7. Deployment8. How To Contribute

Features

Users can perform the following actions with this application

  - Create a Category for saving favourite things  - Edit a category  - Delete a category (Soft-delete)  - View a list of categories and the count of favourites under each  - Add favourite things under a category  - Add metadata to a favourite thing  - Remove metadata from a favourite thing  - Edit an existing Favourite thing  - Delete a favourite thing (Soft-delete)  - View list of favourite things under a category  - View list of metadata under a Favourite thing  - View Audit-logs for mutations (create, update, delete) to a Favourite thing  - Veiw Audit-logs  for mutations (create, update, delete) to a Category  - Search for Favourite things under a selected Category

Technologies

1. Python 3.72. Django and Django REST Framework3. Postgres database4. pylint, pep8 and yapf for linting5. coverage and coveralls for reporting test coverage5. Postman for testing API endpoints and documentation

Entity relationship diagram

Installation and Setup

Development

1. Install Python 3.7, pipenv and Postgres SQL2. Clone this repo: "git clone https://github.com/nzediegwu1/favorite-things.git"3. Create virtual environment: `pipenv shell`4. Run `pipenv install` to install dependencies5. Create a Postgresql database6. Create a ".env" file and enter database credentials using sample file: `.env.sample` in the root directory.7. Run migrations: `python manage.py migrate`8. Start the application: `python manage.py runserver`9. Run tests: `python manage.py test`

Finally

Go to http://localhost:7000 on your browser to view app

Documentation

Deployment

This is done using AWS Fargate, with the following steps:

  1. Build docker image:docker build -t favourite-things --build-arg SECRET_KEY=<SECRET_KEY> --build-arg DB_USER=<DB_USER> --build-arg DB_PASS=<DB_PASS> --build-arg POSTGRES_DB=<POSTGRES_DB> --build-arg DB_HOST=<DB_HOST> .
  2. Run docker image:docker run -p 7000:7000 -t favourite-things:latest
  3. Go tohttp://127.0.0.1:7000/categories on your machine to confirm that docker app is running
  4. Create AWS container registry:aws ecr create-repository --repository-name favourite-things --region us-east-1
  5. Change your docker image tag to use your registry name as keyword
  6. Push docker image to your new AWS container registry
  7. Create your fargate application in AWS dashboard/console
  8. View running application using Public_IP generated in your AWS console as follows:GET <Public_IP>:7000/categories

Suggested improvement

- Implement recycle bin for deleted favourites/categories- Implement functionality to restore deleted favourites/categories from recycle bin- Implement pagination when retrieving favorites- Integrate elastic search in backend and refactor implemented search functionality correspondingly- Implement logging for keeping track of, and easier debugging of production issues when they occur

How to Contribute

To contribute to the project, follow the instructions below

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit aPull request so that I can review your changes

NOTE: Be sure to merge the latest from "upstream" before making a pull request!

Licence

  • This project is licensed under theMIT License
  • Copyright © 2019 Anaeze Nsoffor

About

A full stack web an application that allows the user to track their favourite things. API implemented using Django REST framework

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
[8]ページ先頭
©2009-2025 Movatter.jp