Files
2026-10-19 16:01:27 +02:00

65 lines
1.4 KiB
Markdown

# FHDH View
## Description
Filmhuis Den Haag schedule viewer using FastAPI and SQLModel.
Ingests a ScreenWriter XML file with theater screening schedule.
Backend has an API with a main ticketing booth overview and theater hall specific endpoints.
The endpoint serves the 10 upcoming screenings for the day. The frontend automatically refreshes to update its view with the current information.
## Endpoints
* GET `/admin` - upload form protected with Basic Auth
* POST `/admin/upload` - upload endpoint protected with Basic Auth
* GET `/health` - Health check endpoint
* GET `/info` - serves desk info endpoint
* GET `/api/screenings` - serves JSON with upcoming 10 films for today
* GET `/api/screenings/prices` - serves JSON with pricing data
## Run
For development run the application locally:
```sh
poetry run uvicorn fhdhview.main:app --reload
```
## Tests
Test suite:
```sh
poetry run pytest
```
Style checks:
```sh
poetry run ruff check
```
Type checking:
```sh
poetry run mypy .
```
## Docker
Run the container with docker-compose:
```sh
docker compose -f docker/docker-compose.yml up
```
## License
The code for this repository is available under the `GNU Affero General Public License v3.0 or later`.
Figtree fonts in `fhdhview/static/fonts/` are under the `SIL Open Font License, Version 1.1`.
The logo in `fhdhview/static/Logo.svg` is copyright of `Filmhuis Den Haag` and must be replaced.