Skip to content
Snippets Groups Projects
bur.png

bur

Conditioning, processing and preparation of bureaucracy related database requests.

virtual env

> python3 -m venv /path/to/bur
> cd /path/to/bur
> source bin/activate

install dependencies

> cd /path/to/bur
> source bin/activate
> pip install -e .

run server

> cd /path/to/bur
> source bin/activate
> ./bur

test server

If the server is running at the local computer it can be tested by:

> curl http://localhost:5000/version
{
 "version": "<current version>"
}

install daemon and start

> cd /usr/local/share/bur              # working directory
> sudo nobody
> git clone git@a75436.berlin.ptb.de:vaclab/bur.git
> cd bur
>
> ## follow instructions of chapter --> virtual env
> ## follow instructions of chapter --> install dependencies
>
> sudo systemctl daemon-reload           # if already exist
> sudo systemctl link $PWD/bur.service
> sudo systemctl enable bur.service      # make permanent
> sudo systemctl restart bur.service
> sudo systemctl status bur.service      # running?
> journalctl -f --unit bur.service       # run-time check

provide a server update via git

git describe # shows the last tag
git tag -a 'xx.yy.zz' -m 'xx.yy.zz'
git push && git push --tags

Anm.: Das automatische Server-Update via git funktioniert von gitlab1.ptb.de aus nicht mehr. Es ist daher nötig, im Verzeichnis des installierten Servers (a73434, /usr/local/share/bur) händisch

ssh root@a73434
...
cd /usr/local/share/bur
git pull
chown -R nobody.nobody .
systemctl restart bur.service
systemctl status bur.service
exit

aufzurufen. Das Vergeben der Tags (s.o.) sollte aber beibehalten werden (RN, 2023-06-21).

api

ensure bur keys

http://server:port/bur/ensure/[bur_doc_id|az-no]

planning offer (GET)

http://server:port/pla/offer/pla_doc_id

planning convert (GET)

http://server:port/pla/convert/pla_doc_id

shipping label (GET)

http://server:port/shipping/label/[bur_doc_id|az-no]

shipping form (GET)

http://server:port/shipping/form/[bur_doc_id|az-no]

dangerousgoods form (GET)

http://server:port/dangerousgoods/form/[bur_doc_id|az-no]

confirmation (GET)

http://server:port/bur/conf/[bur_doc_id|az-no]

letter1 (GET)

http://server:port/letter/one/[bur_doc_id|az-no]

letter2 (GET)

http://server:port/letter/two/[bur_doc_id|az-no]

update (POST)

http://server:port/update

pulls the latest version from origin master

version (GET)

http://server:port/version