HardWhere

SEEMOO Accessories Retrieval System (HardWhere)

App + additional Functions based on [snipe-it]

This repo contains the mobile app, the required snipe-it patches and the "lent-by" backend that works in tandem with [snipe-it]

The backend daemon ist expected to handle all of the example.com/HardWhere/* requests and exposes its own API and webview at this path.

Building the daemon

install requirements: apt install libssl-dev pkg-config For other distributions see here

Get rustc and run cargo build --release

Example apache config for backend

<VirtualHost *:443>
[...]
ProxyPass "/HardWhere" http://127.0.0.1:8000
ProxyPassReverse "/HardWhere" http://127.0.0.1:8000
ProxyPreserveHost Off

Structure

• src/ contains the additional backend, referred to as HardWhere-Backend, used for
  • indexing who lent to whom
  • providing return/lent APIs for the app, so the index in the backend is updated at the same time
  • regularly making sure the default fieldset is applied to all models that have none
  • providing a webview on https:///HardWhere/ for inspecting lent assets without using the app
• static/ is part of the HardWhere-Backend, containing templates, CSS icons and other stuff for the webview
• hardwhere.patch contains code applied to snipeit to provide app login via QR code and auto-login from the snipeit menu into the HardWhere-Backend webview
• app/ contains the sourcecode for the android app
• res/ app resources

Workflow

You can open this folder as an android App in android studio and in VS Code for the HardWhere-Backend. It is recommended to use VS Code with the rust-analyzer plugin for it.

You can build the app via gradle or in android studio. HardWhere-Backend can be build using cargo build --release, --release being optional.