marsien/hs3-baza-zasobow-dashboard
1
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions
Skrypt, który generuje podsumowanie Bazy Wiedzy zasobów Hackerspace Trójmiasto w formie statycznej strony internetowej. https://martasien.github.io/hs3-baza-zasobow-dashboard/
34 commits 6 branches 0 tags 4.9 MiB
Find a file
marsien 1ea09e0408
Some checks failed
MegaLinter / MegaLinter (pull_request) Has been cancelled
Details
Update website / update (pull_request) Has been cancelled
Details
Add more printer description in readme
2026-04-16 13:53:01 +00:00
.github build on every push 2026-04-16 13:42:21 +02:00
fegen feat: Add basic frontend 2026-04-16 14:59:07 +02:00
fonts feat: Add basic frontend 2026-04-16 14:59:07 +02:00
labeler feat: Add basic frontend 2026-04-16 14:59:07 +02:00
labeler_docs/brother add function for getting info about installed tape 2026-04-16 13:41:44 +02:00
tests add function for getting info about installed tape 2026-04-16 13:41:44 +02:00
.dockerignore feat: Add basic frontend 2026-04-16 14:59:07 +02:00
.gitignore Add a function to replace string in existing topics 2026-01-18 13:38:09 +01:00
docker-compose.yml support more tape widths 2026-04-16 13:43:52 +02:00
Dockerfile feat: Add basic frontend 2026-04-16 14:59:07 +02:00
img.png expand docs 2026-04-16 13:43:52 +02:00
img_1.png expand docs 2026-04-16 13:43:52 +02:00
lbot_readme.md expand docs 2026-04-16 13:43:52 +02:00
pyproject.toml feat: Add basic frontend 2026-04-16 14:59:07 +02:00
README.md Add more printer description in readme 2026-04-16 13:53:01 +00:00
uv.lock feat: Add basic frontend 2026-04-16 14:59:07 +02:00
zasoby.csv feat: Add basic frontend 2026-04-16 14:59:07 +02:00

README.md

HS3 Baza zasobów Dashboard

Skrypt, który generuje podsumowanie Bazy Wiedzy zasobów Hackerspace Trójmiasto w formie statycznej strony internetowej.

Uruchomienie połączenia z drukarką etykiet

Potrzebne, by działał przycisk w kolumnie print. Po kliknięciu, nastąpi próba połączenia się z drukarką Brother PT-E550W, pod adresem IP zdefiniowanym w PRINTER_IT, w celu wydruku naklejki z kodem QR.

uv venv --python 3.11
source .venv.bin/activate
uv sync
fastapi dev --port 31337 labeler/adapter/fastapi_srv.py
export PRINTER_IT=192.168.0.147

W razie problemów, spróbuj alternatywnych komend:

source .venv/Scripts/activate
uv run -- fastapi dev --port 31337 labeler/adapter/fastapi_srv.py

Sposób działania

  1. Baza Wiedzy znajduje się na Discourse Hackerspace Trójmiasto i jest dostępna publicznie. Projekt wykorzystuje Discourse REST API do pobrania listy zasobów.
  2. Lista zasobów zapisana jest w pliku csv zasoby.csv.
  3. Skrypt tworzy statyczną stronę internetową na podstawie pliku .csv.
  4. Strona jest hostowana przy pomocy GitHub Pages.

Możliwości generatora bazy zasobów csv

  • pobieranie listy wszystkich zasobów z wybranej kategorii
  • pobieranie ID, tagów i treści posta każdego zasobu
  • wyłuskanie z treści posta informacji:
    • nazwa przedmiotu
    • miejsce zamieszkania
    • ilość
    • opiekunowie
  • oto jak powinien wyglądać ostateczny wpis:
ID, nazwa, miejsce, ilość, opiekunowie, tagi

Automatyczna aktualizacja

Żeby działały automatyczne aktualizacje przy użyciu GitHub Actions należy w sekretach dodać sekret o nazwie PAT którego wartością jest Personal Access Token z uprawnieniami do modyfikowania repozytorium.

Możliwości dashboard'u

  • filtrowanie bazy zasobów po tagach
  • sortowanie alfabetyczne bazy zasobów po dowolnej kolumnie
  • linki do zasobu na Discourse w ID zasobu
  • łatwa zmiana ilości kolumn dashboardu

Co chcę dodać w przyszłości

  • wizualizacja statystyk z bazy zasobów
  • generowanie drugiego pliku csv służącego do wygenerowania naklejek z kodem QR

Dokumentacja