Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sondregronas/feideutstyrbase
WIP - Åpen utstyrsbase applikasjon med Feide innlogging til utlån og registrering av utstyr
https://github.com/sondregronas/feideutstyrbase
Last synced: 8 days ago
JSON representation
WIP - Åpen utstyrsbase applikasjon med Feide innlogging til utlån og registrering av utstyr
- Host: GitHub
- URL: https://github.com/sondregronas/feideutstyrbase
- Owner: sondregronas
- License: agpl-3.0
- Created: 2023-03-08T19:38:00.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-18T18:49:04.000Z (9 days ago)
- Last Synced: 2024-12-18T19:41:05.661Z (8 days ago)
- Language: Python
- Homepage: https://sondregronas.github.io/FeideUtstyrbase/docs
- Size: 9.14 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://sondregronas.github.io/FeideUtstyrbase/)
[](https://sondregronas.github.io/FeideUtstyrbase/docs)
[](https://github.com/sondregronas/FeideUtstyrbase)
[](https://github.com/sondregronas/FeideUtstyrbase/pkgs/container/feideutstyrbase)
[](https://codecov.io/gh/sondregronas/FeideUtstyrbase)
[](https://github.com/sondregronas/FeideUtstyrbase/blob/main/LICENSE)
For Vågen VGS, might be possible to use for other schools with some modifications. (Work in progress, this is not plug
and play)
## Dev setup
Recommended `.env` file for development:
```
DEBUG=True
MOCK_DATA=True # Uses mock data instead of real data
KIOSK_FQDN=127.0.0.1:5000 # Automatically logs in as Kiosk user when visiting this domain
```
> If both `DEBUG` and `MOCK_DATA` are set to true you can also log in as an admin by visiting `/demo-login`, which is
> slightly different from logging in as kiosk.
## Setup
1. Register an app at Dataporten (must be approved by your Feide Administrator) with the scopes `email`, `groups-org`
and `userinfo-name`
2. Set the callback url to `https:///login/feide/callback`
3. Install the labelprinter/service https://github.com/VaagenIM/EtikettServer (currently a requirement)
4. The application sends notifications using Teams Incoming Webhooks, they need to be comma separated in
the `TEAMS_WEBHOOKS` environment variable. (see cron examples in docs for how to automatically send reports to teams)
5. Run the `docker-compose.yml` file after setting up the environment variables.
> The application must be configured to run through a reverse proxy, such
> as [NginxProxyManager](https://nginxproxymanager.com/) - don't run in production without SSL.
To configure a kiosk, set up a separate reverse proxy with proper access controls (limit to specified IP) and
set `KIOSK_FQDN` to the FQDN of the kiosk proxy. (Remember to restrict access further by setting up a firewall rule)
## Overrides
You can change any of the files inside `BookingSystem` by putting them in `/overrides`, should you need to. Files of
interest are `/overrides/templates/user/globals.html` and those found in `/overrides/static/*`
## TODO:
- [ ] Find a way to implement included_batteries (and possibly other accessories) in a way that makes sense (omitted
entirely them for now)
- [ ] Code cleanup / refactoring, it's a bit inconsistent
- [ ] New UI / UX (In progress)
- [ ] Reduce coupling between modules (database, api, etc.)
- [ ] Add the possibility to limit access to specific Dataporten groups and limit administrator access to specific email
addresses or something similar, currently every employee can access the admin panel.