Skip to content
Snippets Groups Projects

Cicer

Cicer is a web based software to manage the stock, purchases and balance of a consumer association. It has being created for the needs of the Garbanzo Negro.

Requirements

  • Golang >= 1.12
  • Node.js

Deployment

Build a copy using make:

make build

Create a secret for the authentication tokens:

head -c 21 < /dev/urandom | base64

Now you can copy the build folder and the cicer binary to your server and run it like:

./cicer -assets 'path/to/build' -secret 'scret' -addr ':8000'

Instead of flags all the params can be passed as env variables. See the names between { and } in:

./cicer -h

Running it for development

To run Cicer in development mode, build and run the backend:

go build
./cicer

And then run the frontend with npm:

npm start

The backend API will be listening on port 8080, while the frontend will be on port 3000.

Open a browser and visit http://localhost:3000. You will be able to see any changes you do in the javascript side as you go (the backend side needs recompilation).

Initialize data

When you run cicer, it will print an authentication token. Use this token to seed some initial data (such a few users and products):

./setup.sh the.token.string