
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)
pulls the latest version from origin master