Skip to content

Open Source small business management software for independent developers to build on top.

License

Notifications You must be signed in to change notification settings

luisgizirian/commerce

Repository files navigation

Commerce

Español

Please note! The experiments in this repository should be considered to be in beta. Significant portions of these experiments are subject to change without warning (although accesible through repo's history). No part of this code should be considered stable.

Business Management Software for running your daily operations. Easy to deploy, operate, and integrate!

Deploy it to a Pi up to an Enterprise Server beast.

Pick the UI that suits you best. A WebApp or a console based one for those keyboard lovers out there. You can operate it as needed. Can't find your poison? BYO and share it with the community.

[Integrate]...

To keep growing your business, having organized and available information is key. What you sell, its availability, your customers, their interactions through time, how operations affect your bottom line, it is all crucial data you want at your fingertips to decide what to do next.

You will find here a Software piece that takes care of these things. You can also participate (and are encouraged to do so!) in building it by involving in key areas as: development, documentation, testing, overseeing (notifying back), engaging into conversations. You can give as little or as much time you want, as long as you put your thought to it. Become a part of the community!

[high-level-description-here]

Contributing

Post bug reports, feature requests, and questions in Issues.

Please check the Discussions area, and join us in there. It's a great way to participate too!

This project welcomes contributions and suggestions. PRs are welcome as well. Improving and translating documentation is encouraged.

As you can tell, there are many ways to participate in the project, and help on elevating its quality.


[still-editing] Mongo DB manual DB initialization (until automated comes...)

  1. Run the App (it'll create DB + Collection in MongoDB Container). No results rendered.
  2. Head your browser to http://localhost:5002
  3. Get a Console for the running MongoDB container with docker exec -it <CONTAINER> /bin/bash
> mongosh

> use cmmrcdb

> db.Catalog.insertMany([{"Name": "Albahaca", "Sku": "001", "IsEnabled": true}, {"Name": "Alcachofa", "Sku": "002"}])
  1. Reload the webpage (1 result must be rendered).
  2. Do (replacing first, <SECOND_OBJECT_ID> with the second value obtained after previous command run):
> db.Catalog.updateOne({ "_id": ObjectId("<SECOND_OBJECT_ID>") }, {$set: { "Name": "Alcachofa", "Sku": "002", "IsEnabled": true }})
  1. Reload the webpage to see 2 results listed

Now, you can stop/remove/start docker-compose with docker-compose down && docker-compose up --build command. You'll notice that heading to http://localhost:5002 gets you 2 listed results. This is because MongoDB container is using a persisted volume outside its boundaries. NOTE: this will later become be the basis for local/manual backup.

Note: if you get a permissions error next time you docker-up related to folder mongodb, cd to storage and run these commands sudo chmod ugo+rwx mongodb/* && sudo chmod ugo+rwx mongodb/diagnostic.data/* && sudo chmod ugo+rwx mongodb/journal/*. As a shortcut sh runcompose.sh from project root should do.

About

Open Source small business management software for independent developers to build on top.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published