Code Monkey home page Code Monkey logo

coverd's Introduction

Coverd Donation Bank Manager

Coverd is an open source Symfony/Vue.js web application that manages the inventory and distribution of donated goods in a Bank -> Partner -> Client model. While this app was developed for diaper banks, our intent is for Coverd to be product agnostic.

Travis (.org) branch

Coverd Screenshot

Coverd offers the following features.

  • Product management
  • Warehouse management
  • Partner management
  • Client management (planned)
  • Warehouse and Partner Inventory
  • Full inventory transaction history
  • Partner login, ordering, and client management (planned)
  • Custom Partner and Client fields (planned)
  • Client (Recipient) record encryption (planned)
  • Support for multiple warehouses
  • Inventory transfers
  • Partner Order workflow
  • Order packing sheets
  • Fine-grained permission levels

History

Coverd comes out of the need of HappyBottoms to manage their diaper inventory and partner distribution. This app started as a Drupal (Commerce module) ordering system for distribution partners to record their distributions and place new orders. This worked for 6+ years, but due to HappyBottoms growth, the system proved unable to effectively handle the volume and lacked desired features. Additionally, HappyBottoms was able to fund the development of a warehouse inventory management app. This was developed in Laravel, Doctrine, and Vue.js and was designed to be a platform to rebuild the existing partner ordering system once complete.

Since Laravel with Doctrine is not a typical combination, a rewrite of the backend in Symfony was done for a shallower developer curve.

About HappyBottoms

HappyBottoms is Kansas City's Diaper Bank. Its mission is to collaborate with community partners to empower, connect and impact low-income families by alleviating diaper need in the Kansas City community.

HappyBottoms's vision is to positively impact the mental, physical and financial stability of a family in crisis and need through diaper assistance, education, and connection to services.

Learn More at https://www.happybottoms.org

Special Thanks

  • VMLY&R for originally sponsoring the development of the Drupal project
  • William T. Kemper Foundation for sponsoring the development of the inventory system.

Development Installation - On existing environment (with PHP and Database)

  1. composer install
  2. yarn install
  3. Create a database (mysql, postgres, sqlite)
    • There is a docker compose file that will give you a Postgres DB by running docker-compose up in the repository root (this should only be used for development and testing purposes, not for Production)
  4. Copy .env to .env.local and set the database connection
  5. bin/console doctrine:database:create
  6. bin/console doctrine:schema:create
  7. bin/console doctrine:fixtures:load

Run Development Server and Build JS App

  1. bin/console server:run or bin/console server:start (to run in background)
  2. yarn watch

Development Installation - Docker Compose

  1. docker-compose up --build
  2. Copy .env.docker to .env.localhost and set the database connection
  3. docker/composer install
  4. docker/yarn install
  5. docker/app bin/console doctrine:database:create
  6. docker/app bin/console doctrine:schema:create
  7. docker/app bin/console doctrine:fixtures:load

Run Development Server and Build JS App

  1. docker/yarn watch

You should now be able to connect to your the dev server at the address reported by console server:run

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.