EduTicTac Vídeos

EduTicTac Vídeos és un visor net i una col·lecció docent de vídeos per a l'aula. Permet preparar vídeos de YouTube sense comentaris, recomanacions ni altres distraccions externes, i guardar una biblioteca local amb categories i etiquetes.

El projecte forma part de l'ecosistema EduTicTac Commons i és una adaptació de Digiview, creat per La Digitale. Conserva l'atribució corresponent i es distribueix sota la llicència GNU AGPL-3.0.

El reproductor oficial de YouTube continua sent qui serveix el vídeo i la seua publicitat. EduTicTac Vídeos no és un bloquejador d'anuncis.

Estat actual

La primera iteració inclou:

• reproducció de vídeos de YouTube en una interfície neta;
• configuració del títol, la descripció i els intervals de reproducció;
• consentiment abans de carregar el contingut de YouTube;
• biblioteca local al navegador, sense compte ni sincronització;
• categories, etiquetes, cerca i eliminació de vídeos guardats;
• visor local per a la biblioteca;
• backend PHP amb SQLite o MySQL/MariaDB per als enllaços compartibles generats pel flux original de Digiview.

La biblioteca local utilitza IndexedDB mitjançant Dexie.js. La migració des de la primera versió basada en localStorage es fa automàticament quan s'obri la biblioteca per primera vegada.

Requisits

Per al desenvolupament del frontend:

• Node.js 20 o posterior;
• npm.

Per al flux complet amb enllaços compartibles:

• PHP 8 o posterior;
• extensió PDO SQLite, o una base de dades MySQL/MariaDB;
• extensió cURL de PHP.

La biblioteca local no necessita PHP ni una base de dades externa.

Instal·lació

git clone https://codeberg.org/Edutictac/edutictac-videos.git
cd edutictac-videos
npm ci

Si el repositori d'EduTicTac encara no està publicat en una forja pròpia, utilitza la URL del repositori de treball corresponent.

Desenvolupament

Per iniciar Vite:

npm run dev

Per provar també els endpoints PHP, inicia el frontend i, en una altra terminal, el servidor PHP:

php -S 127.0.0.1:8000

La configuració de Vite redirigeix les peticions /inc cap al servidor PHP local durant el desenvolupament.

Compilació

npm run build

El resultat queda en dist/ i es pot servir amb nginx, Apache, PHP o un altre servidor web estàtic compatible amb l'aplicació compilada.

La còpia de .env.production és opcional. No cal crear cap fitxer d'entorn per a provar la biblioteca local.

Configuració

Les variables opcionals del frontend són:

AUTHORIZED_DOMAINS=*
VITE_GOOGLE_API=
VITE_UMAMI_SCRIPT_URL=
VITE_UMAMI_WEBSITE_ID=

Les variables de base de dades només són necessàries quan es vol utilitzar MySQL o MariaDB:

DB_DRIVER=sqlite
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=edutictac_videos
DB_USER=
DB_PASSWORD=

No s'han de publicar contrasenyes, claus d'API ni fitxers .env en Git.

Privacitat i consentiment

• La biblioteca personal es guarda inicialment en el dispositiu de l'usuari.
• Els vídeos guardats no s'envien automàticament a EduTicTac Commons.
• El contingut de YouTube només es carrega després d'un consentiment explícit en el visor local.
• La futura sincronització amb Authentik serà opcional.
• No es demanen ni es necessiten dades personals de l'alumnat.

Quan el reproductor oficial de YouTube es carrega, s'apliquen les condicions i la política de privacitat de YouTube.

Arquitectura i full de ruta

La base actual combina:

• Vue 3 i Vue Router;
• Vite;
• PHP per als enllaços compartibles i la persistència del flux original;
• SQLite per defecte, amb suport opcional de MySQL/MariaDB;
• IndexedDB mitjançant Dexie.js per a la biblioteca local.

Pròximes iteracions:

1. gestió avançada de conflictes i duplicats en la importació;
2. metadades educatives, col·leccions i filtres avançats;
3. completar la internacionalització en valencià, català, castellà, anglés i francés;
4. integració opcional amb EduTicTac Commons i Authentik/OIDC;
5. sincronització local-first sense bloquejar el treball offline.

La visió funcional està documentada en el pla 4D d'EduTicTac Commons: visor net de vídeos i col·lecció docent.

Contribuir

Les propostes i incidències són benvingudes. Abans d'obrir una contribució:

1. revisa la llicència i l'atribució a Digiview;
2. no inclogues secrets, dades personals ni contingut amb drets no verificats;
3. prova npm run build;
4. descriu els canvis i les proves realitzades;
5. mantín una interfície accessible i usable en dispositius mòbils.

Llicència i atribucions

El codi es distribueix sota GNU AGPL-3.0. EduTicTac Vídeos és una adaptació de Digiview de La Digitale. Les fonts i les biblioteques de tercers conserven les seues llicències originals, indicades en els seus projectes o en la documentació corresponent.

EduTicTac Vídeos — projecte lliure de l'ecosistema EduTicTac Commons.