Popis

Web systém NFC-dance je správa jednoduchého systému pre evidenciu dochádzky na škole.

Vlastnosti:

• Správa predmetov
  • študijné skupiny
  • definovanie rozvrhu predmetu podľa študijných skupín
  • rozdelenie študentov do skupín
• Správa identifikačných predmetov (NFC tagy)
• Prehľad na úrovni učiteľa/správnu kurzu
  • dochádzka počas semestra
  • manuálne doplniť dochádzku
• Spôsob komunikácie
  • verejné API pre spracovanie udalostí z dochádzkového systému

Dochádzkový systém

Je ako samostatný projekt. Indormácie o účasti na akcii (prednáška/cvičenie/seminár) sa zaregistruje pomocou čítačky NCC tagov a odošle sa do systému NFC-dance.

Podporované NFC tagy:

• ISIC
• štandardné tagy a prístupové karty (MIFARE, NTag213, NTag2015)

Verejné API

• url adresa: http://nfcdance.nsoric.com/api/
• verzia: 1.5.0
• autentifikácia: JWT
• autorizácia: NFC ID key

Dokumentácia k API je http://apollo.nsoric.com/p/nfcdance/docs

Vývoj

Implementačné detaily

Projekt je postatný na frameworku Nette:

• PHP 8.1+
• nette/* packages
• Doctrine ORM via nettrine/*
• Symfony components via contributte/*
• codestyle checking via CodeSniffer and contributte/qa
• static analysing via phpstan and contributte/phpstan
• unit / integration tests via Nette Tester and contributte/tester

Inštalácia lokálneho vývojového prostredia

1) Stiahni si prostrerdie XAMP - https://gitlab.nsoric.com/juraj/xamp

V adresári xamp/docler_web spusti server:

   make dev

2) Otvor rozhranie phpmyadmin http://localhost:9091 (user:admin, heslo:LocalData) a vytvor databázu nfcdance. Alternatívne si môžeš vytvoriť nového používateľa (nfcdance) a nechať si vytvoriť jeho databázu (nfcdance)

3) Projekt si stiahni a rozbaľ do adresára xamp/www/nfcdance

4) Vytvor kópiu súboru nfcdance/config/local.neon.example, premenuj ho na nfcdance/config/local.neon a nastav prístupy pre databázu

   # Host Config
   parameters:
       # Database
       database:
           host: localhost
           dbname: nfcdance
           user: nfcdance
           password: xxxx #heslo k databáze

5) Pripoj sa do kontanera docker_web: V adresári xamp/docler_web spusti príkaz make attach

V termináli spusti príkazy pre inštaláci databázy a vytvorenie prého používateľa

   mkdir var
   mkdir var/log
   chmod 775 var
   chmod 775 var/log
   NETTE_DEBUG=1 bin/console migrations:migrate
   NETTE_DEBUG=1 bin/console doctrine:fixtures:load --append

Prvý používteľ má login 'admin' a heslo 'admin'.

6) Web bude na adrese http://localhost:9090/nfcdance/www.