household / household Goto Github PK

HouseHold is self-hosted web-based application to manage your home.
HouseHold is in Alpha and expirencing heavy development
Pre-Alpha coming 1st of June

Report Bug · Request Feature

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Roadmap
• Contributing
• License

HouseHold is a management system for home. Manage stock of your home food supplies and many other.

At this stage this is fork Grocy. To be exact, this started due Grocy code being a mess according to me and it doesnt support any other database than sqlite at time of writing this.

This project aims only providing same functionality as Grocy does. There is no code borrowed or copied or anything from Grocy. This is pure rewrite.

After basic functionality have been implemented HouseHold and Grocy paths will separate HouseHold will start developing it own features. This meaning some features added to Grocy after HouseHold release 1.0 will not maybe added automatically into HouseHold.

• PHP 7.4
• Vue
• Symfony

This is not production ready. Do not use this is production, until 1.0.0 is released. When 1.0.0 is released, there will be docker package available. For now there is nothing.

Please make sure following packages are installed:

• make
• docker
• docker-compose

sudo apt-get install make docker docker-compose -y
== OR ==
sudo yum install make docker docker-compose -y
== OR ==
sudo apk add make docker docker-compose

1. Clone the repo

git clone --recurse-submodules -j8 https://github.com/HouseHold/HouseHold.git

2. Install dependencies.

make start

Notice: This is development guide and might not be up-to-date.

See the open issues for a list of proposed features (and known issues).

For now development progress can be seen here in simple steps.

• Create CQRS, DDD, EventSourcing Core.
• Setup Vue frontend.
• Stock Management Backend (API).
• Stock Management Frontend.

Contributions are what make the community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. However, please follow following rules to contribute so we can keep code clean.

In order to submit a pull request, you will need to fork the project and obtain a fresh copy of the source code.

• I am submitting a bugfix for a stavle release.
  • Please target lowest possible active stable branch.
• I am submitting a new feature.
  • Please target master branch.
• I am submitting a BC change.
  • Please target master branch.
  • Please provide deprecation for lowest possible active stable branch.

Please always create a new branch for your changes (i.e. do not commit directly into master in your fork), otherwise you would run into troubles with creating multiple pull requests.

Always follow the previous coding standard applied in the code. You will get it, if you just read it trough. Please also always run the phpcsfixer. Fixer can be run with command make cs.

Please always add tests for your changes.

• If you are fixing a bug, create test file into tests/{Functional,Unit,Integration}/Ticket/GHxxxxxTest.php. Part with xxx should be the ID of the ticket.
• If you are adding a feature, please provide a tests to cover it fully.

Distributed under the BSL 1.1 License. See LICENSE.md for more information.

License might be change in future, but for now it will go under BSL 1.1 to support single contributor effort develop the software.