Giter Club home page Giter Club logo

yarn_store's Introduction

Table of Contents

  1. Brief
  2. Rules
  3. Technologies Used
  4. Running Instructions
  5. Screenshots

Brief

Shop Inventory

Build an app which allows a shopkeeper to track their shop's inventory. This is not an app which the customer will see, it is an admin/management app for the shop workers.

MVP

  • The inventory should track individual products, including a name, description, stock quantity, buying cost, and selling price.
  • The inventory should track manufacturers, including a name and any other appropriate details.
  • The shop can sell anything you like, but you should be able to create and edit manufacturers and products separately.
    • This might mean that it makes more sense for a car shop to track makes and models of cars. Or a bookstore might sell books by author, or by publisher, and not by manufacturer. You are free to name classes and tables as appropriate to your project.
  • Show an inventory page, listing all the details for all the products in stock in a single view.
  • As well as showing stock quantity as a number, the app should visually highlight "low stock" and "out of stock" items to the user.

Inspired by

eBay, Amazon (back end only), Magento

Possible Extensions

  • Calculate the markup on items in the store, and display it in the inventory
  • Filter the inventory list by manufacturer. For example, provide an option to view all books in stock by a certain author.
  • Categorise your items. Books might be categorised by genre (crime, horror, romance...) and cars might be categorised by type (SUV, coupé, hatchback...). Provide an option to filter the inventory list by these categories.
  • Mark manufacturers as active/deactivated. Deactivated manufacturers will not appear when creating new products.




Rules

It must NOT use:

  • Any Object Relational Mapper (e.g. ActiveRecord)
  • JavaScript. At all. Don't even think about it.
  • Any pre-built CSS libraries, such as Bootstrap.
  • Authentication. Assume that the user already has secure access to the app.


Technologies Used

  • HTML / CSS
  • Python
  • Flask
  • PostgreSQL and the psycopg


Running Instructions

  1. Clone and enter git repository
cd yarn_store
  1. Create and activate a virtual environment inside the cloned repository
python3 -m venv venv
source venv/bin/activate
  1. Install from requirements.txt
pip install -r requirements.txt
  1. Create database
createdb yarn_store
psql -d yarn_store -f db/yarn_store.sql

  1. Run the app with flask
flask run




Screenshots

 

View all yarns.
All Yarns View


View full details, edit or delete yarn, and add new colours. Yarn Details View


View colours, including stock level warning indicators. Order more stock. Add, edit and delete colours. All Colours View

yarn_store's People

Contributors

lisas7 avatar

Stargazers

Shaz avatar Ross Condie avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.