{"id":18292079,"url":"https://github.com/seemoo-lab/hardwhere","last_synced_at":"2025-04-05T10:31:08.374Z","repository":{"id":39057516,"uuid":"494209470","full_name":"seemoo-lab/Hardwhere","owner":"seemoo-lab","description":"snipeit-it based asset management app","archived":false,"fork":false,"pushed_at":"2022-08-06T14:46:03.000Z","size":784,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-21T03:05:48.802Z","etag":null,"topics":["asset-management","assets-management","itam"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seemoo-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-19T19:49:04.000Z","updated_at":"2024-08-12T20:23:24.000Z","dependencies_parsed_at":"2022-07-20T13:08:39.861Z","dependency_job_id":null,"html_url":"https://github.com/seemoo-lab/Hardwhere","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seemoo-lab%2FHardwhere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seemoo-lab%2FHardwhere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seemoo-lab%2FHardwhere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seemoo-lab%2FHardwhere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seemoo-lab","download_url":"https://codeload.github.com/seemoo-lab/Hardwhere/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247324600,"owners_count":20920679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asset-management","assets-management","itam"],"created_at":"2024-11-05T14:16:32.181Z","updated_at":"2025-04-05T10:31:06.985Z","avatar_url":"https://github.com/seemoo-lab.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HardWhere\n\nSEEMOO Accessories Retrieval System (HardWhere)\n\nApp + who-lent-to-whom functions based on [snipe-it]\n\nThis repo contains the mobile app, the required snipe-it patches and the \"lent-by\" backend that works in tandem with [snipe-it]\n\nThe backend daemon ist expected to handle all of the example.com/HardWhere/* requests and exposes its own API and webview at this path.\n\nCurrently compatible with snipeit v5.4.3\n\n[\u003cimg src=\"https://fdroid.gitlab.io/artwork/badge/get-it-on.png\"\n     alt=\"Get it on F-Droid\"\n     height=\"80\"\u003e](https://f-droid.org/packages/de.tu_darmstadt.seemoo.HardWhere/)\n\n## Building the daemon\ninstall requirements:\n`apt install libssl-dev pkg-config`\nFor other distributions [see here](https://docs.rs/openssl/0.10.35/openssl/#automatic)\n\nGet rustc and run\n`cargo build --release`\n\n[#snipe-it]: https://github.com/snipe/snipe-it\n\n## Log settings for the daemon\n\nThe `RUST_LOG` environment vairable can be set. Examples:\n`RUST_LOG=hardwhere_backend=trace` or for the full show `RUST_LOG=trace`\nYou can also specify it for multiple moduls `RUST_LOG=hardwhere_backend=debug,actix_web=trace`.\n\nPossible values are trace,debug,info,warn,error\n\n## Example apache config for backend\n\nRunning the daemon together on the same machine with snipeit.\nThe daemon is expected to be present on \u003cdomain\u003e/HardWhere for the app.\n```apache2\n\u003cVirtualHost *:443\u003e\n[...]\n  \u003cLocation /HardWhere\u003e\n      ProxyPass http://127.0.0.1:8000/HardWhere\n      ProxyPassReverse http://127.0.0.1:8000/HardWhere\n      ProxyPreserveHost On\n  \u003c/Location\u003e\n```\n\n# Structure\n- `src/` contains the additional backend, referred to as HardWhere-Backend or daemon, used for\n  - indexing who lent to whom\n  - providing return/lent APIs for the app, so the index in the backend is updated at the same time\n  - regularly making sure the default fieldset is applied to all models that have none\n  - providing a webview on https://\u003cdomain\u003e/HardWhere/ for inspecting lent assets without using the app\n- `static/` is part of the HardWhere-Backend, containing templates, CSS icons and other stuff for the webview, it's required to be relative to the daemon application\n- `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\n- `app/` contains the sourcecode for the android app\n- `res/` app resources\n\n## Workflow\nYou 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.\n\nYou can build the app via gradle or in android studio. HardWhere-Backend can be build using `cargo build --release`, `--release` being optional.\n\nFor the integration with snipeit you'll have to upgrade hardwhere.patch for new snipeit versions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseemoo-lab%2Fhardwhere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseemoo-lab%2Fhardwhere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseemoo-lab%2Fhardwhere/lists"}