sndurkin / contractor-mgmt

Contractor management system written in Go that uses politeiad as a backend

contractor-mgmt

This is a contractor management system written in Go that uses politeiad as a backend. It stores invoices, which are submitted by contractors and then approved and paid by administrators.

Components

Core components

• cmswww - Web server; depends on politeiad.

Tools and reference clients

• cmswwwcli - Command-line tool for interacting with cmswww.
• cmswwwdbutil - Tool for debugging and creating admin users within the cmswww database.
• cmswwwdataload - Tool using cmswwwcli to load a basic dataset into cmswww.

Note: cmswww does not provide HTML output. It strictly handles the JSON REST RPC commands only.

Development

1. Install Go version 1.11 or greater, and Git.

Make sure each of these are in the PATH.

2. Setup and start CockroachDB.

CockroachDB is used by cmswww as storage for users, invoices and other data. Some data, such as invoices, are pulled from politeiad when cmswww starts and are added to the database.

To set up CockroachDB for use with cmswww, follow these steps:

1. Install CockroachDB.

2. Create the root and cmswwwuser clients, the cmswww database, and a node on localhost.

   Replace <install dir> with the installation location for CockroachDB on your machine:

   cd <install dir>
   mkdir ~/.cmswww/data/testnet3/cockroachdb
   
   cockroach cert create-ca --certs-dir="~/.cmswww/data/testnet3/cockroachdb" --ca-key="<install dir>/ca.key" --allow-ca-key-reuse
   
   cockroach cert create-client root --certs-dir="~/.cmswww/data/testnet3/cockroachdb" --ca-key="<install dir>/ca.key"
   
   cockroach cert create-node localhost --certs-dir="~/.cmswww/data/testnet3/cockroachdb" --ca-key="<install dir>/ca.key"
   
   cockroach start --host=localhost --http-host=localhost --certs-dir="~/.cmswww/data/testnet3/cockroachdb"
   
   cockroach user set cmswwwuser --certs-dir="~/.cmswww/data/testnet3/cockroachdb"
   
   cockroach cert create-client cmswwwuser --certs-dir="~/.cmswww/data/testnet3/cockroachdb" --ca-key="<install dir>/ca.key"
   
   cockroach sql --certs-dir="~/.cmswww/data/testnet3/cockroachdb" -e 'CREATE DATABASE cmswww'
   
   cockroach sql --certs-dir="~/.cmswww/data/testnet3/cockroachdb" -e 'GRANT ALL ON DATABASE cmswww TO cmswwwuser'
   
   cockroach sql --user=cmswwwuser --certs-dir="~/.cmswww/data/testnet3/cockroachdb" -e 'GRANT ALL ON DATABASE cmswww TO cmswwwuser'
   

3. Start CockroachDB.

   cd <install dir>
   cockroach start --host=localhost --http-host=localhost --certs-dir="~/.cmswww/data/testnet3/cockroachdb"
   

2. Clone this repository and decred/politeia.

3. Setup configuration files:

Both politeiad and cmswww have configuration files that you should set up to make execution easier. You should create the configuration files under the following paths:

• macOS

  /Users/<username>/Library/Application Support/Politeiad/politeiad.conf
  /Users/<username>/Library/Application Support/Cmswww/cmswww.conf
  

• Windows

  C:\Users\<username>\AppData\Local\Politeiad/politeiad.conf
  C:\Users\<username>\AppData\Local\Cmswww/cmswww.conf
  

• Ubuntu

  ~/.politeiad/politeiad.conf
  ~/.cmswww/cmswww.conf
  

Copy and change the sample-cmswww.conf and sample-politeiad.conf files.

You can also use the following default configurations:

politeiad.conf:

rpcuser=user
rpcpass=pass
testnet=true

cmswww.conf:

rpchost=127.0.0.1
rpcuser=user
rpcpass=pass
rpccert="/Users/<username>/Library/Application Support/Politeiad/https.cert"
testnet=true

Things to note:

• The rpccert path is referencing a macOS path. See above for more OS paths.

• cmswww uses an email server to send verification codes for things like new user registration, and those settings are also configured within cmswww.conf. The current code should work with most SSL-based SMTP servers (but not TLS) using username and password as authentication.

4. Build the programs:

cd $GOPATH/src/github.com/decred/politeia
GO111MODULE=on go mod vendor && go install -v ./...
cd $GOPATH/src/github.com/decred/contractor-mgmt
GO111MODULE=on go mod vendor && go install -v ./...

5. Start the politeiad server by running on your terminal:

politeiad

6. Download politeiad's identity to politeiawww:

cmswww --fetchidentity

Accept politeiad's identity by pressing Enter.

The result should look something like this:

2018-08-01 22:48:48.468 [INF] CWWW: Identity fetched from politeiad
2018-08-01 22:48:48.468 [INF] CWWW: Key        : 331819226de0270d0c997749ce9f2b56bc5aed110f57faef8d381129e7ee6d26
2018-08-01 22:48:48.468 [INF] CWWW: Fingerprint: MxgZIm3gJw0MmXdJzp8rVrxa7REPV/rvjTgRKefubSY=
2018-08-01 22:48:48.468 [INF] CWWW: Save to /Users/<username>/Library/Application Support/Cmswww/identity.json or ctrl-c to abort

2018-08-01 22:49:53.929 [INF] CWWW: Identity saved to: /Users/<username>/Library/Application Support/Cmswww/identity.json

7. Start the cmswww server by running on your terminal:

cmswww

At this point, you can:

• Use the cmswwwcli tool to interact with cmswww.
• Use the politeia tool to interact directly with politeiad.
• Use any other tools or clients that are listed above.

Further information

Library and interfaces

• cmswww/api/v1 - JSON REST API for cmswww clients.