Skip to content
vmoren12Public

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PI · Pla de suport individualitzat

Eina d'elaboració, seguiment i impressió de plans de suport individualitzat (PI) per a l'educació bàsica a Catalunya —primària i ESO—, amb el currículum del Decret 175/2022 integrat i un banc de mesures i suports basat en el Decret 150/2017.

S'obre amb un enllaç o es baixa com a un sol fitxer HTML que funciona amb doble clic. En tots dos casos: sense instal·lació, sense compte d'usuari i sense connexió un cop oberta. Les dades de l'alumnat no surten mai del dispositiu.

Important

Aquesta no és una aplicació oficial del Departament d'Educació de la Generalitat de Catalunya. És una eina d'ajuda a la redacció: el currículum i el catàleg de mesures s'hi incorporen a efectes de consulta i poden contenir errors o estar desactualitzats. Reviseu sempre el contingut de cada pla abans de validar-lo, compartir-lo o imprimir-lo, i contrasteu-lo amb la normativa vigent i amb els criteris del vostre centre.


Com fer-la servir

Obriu-la al navegador

No cal baixar res, ni instal·lar res, ni registrar-se. És l'adreça que podeu passar a una companya de departament o posar en una circular de centre.

Instal·leu-la com a aplicació (recomanat). Amb l'aplicació oberta:

Chrome i Edge, a l'ordinador Icona d'instal·lació a la dreta de la barra d'adreces, o menú ⋮ → Instal·la
Android Menú del navegador → Instal·la l'aplicació / Afegeix a la pantalla d'inici
iPhone i iPad (Safari) Botó de compartir → Afegeix a la pantalla d'inici
Safari al Mac Menú Arxiu → Afegeix al Dock

A partir d'aquí té icona pròpia, s'obre sense barra d'adreces i funciona sense connexió. No cal recordar cap adreça mai més.

O baixeu el fitxer

Si preferiu la còpia de sempre —o si la xarxa del centre filtra dominis externs— baixeu dist/pi-eso.html (botó dret → Desa l'enllaç com a…), preneu-lo de la darrera versió publicada a Releases, o feu servir el botó rodó de baix a la dreta de la mateixa aplicació, que ofereix les dues opcions —instal·lar-la o baixar el fitxer— amb la diferència explicada. Obriu-lo amb qualsevol navegador modern i ja està.

El fitxer es pot desar en un llapis de memòria, enviar per correu o deixar en una carpeta compartida del centre. Cada còpia és independent.

Important

Trieu-ne una i quedeu-vos-hi. Els plans es desen al navegador i van lligats a on s'obre l'aplicació: els que feu a l'adreça web no es veuen a la còpia baixada, ni al revés, igual que no es veuen entre dos ordinadors. Per traslladar-los, exporteu la còpia de seguretat des de Dades i còpies i importeu-la a l'altra banda.

Què hi ha a dins

Tauler Estat de tots els plans, alertes de seguiment pendent i indicadors de qualitat.
Alumnat Fitxes de l'alumnat, perfils de necessitat específica i importació/exportació en CSV.
Editor Els vuit passos del model oficial, del full d'identitat a la conformitat de la família.
Seguiment Valoració trimestral dels objectius amb escala d'assoliment i historial.
Banc de mesures 114 mesures i suports dels tres nivells d'intensitat i 131 estratègies metodològiques breus, tot editable pel centre.
Currículum Explorador de les matèries de l'ESO i les àrees de primària del Decret 175/2022.
Dades i còpies Còpia de seguretat, restauració, fusió i historial intern d'instantànies.

Privadesa

Tot es desa a l'emmagatzematge local del navegador del dispositiu on s'obre l'aplicació. No fa cap petició de xarxa amb dades: no hi ha analítica, ni telemetria, ni compte. La suite de proves ho comprova a cada canvi (tests/test_aplicacio.py).

Això val igual per a la versió web. El servidor entrega l'aplicació i prou: és una pàgina estàtica i pública, i cap pla hi arriba mai. L'única cosa que hi ha de més respecte del fitxer baixat és el que té qualsevol pàgina web: el proveïdor de l'allotjament veu l'adreça IP de qui hi entra.

La contrapartida és que les còpies de seguretat són responsabilitat de qui la fa servir: buidar les dades del navegador esborra els plans. Vegeu docs/privadesa.md.


El dipòsit

├── src/                  codi font de l'aplicació
│   ├── index.html          estructura del document i marques de construcció
│   ├── styles/             18 fulls d'estil, en ordre de cascada
│   └── app/                36 mòduls de JavaScript, en ordre d'execució
├── data/                 dades: currículum, mesures, estratègies, plantilles
├── web/                  manifest, service worker i icones de la versió web
├── tools/                construcció, validació i extracció dels PDF oficials
├── tests/                suite de proves (pytest)
├── docs/                 arquitectura, decisions, manteniment de les dades
├── dist/pi-eso.html      l'aplicació, generada — és el que es distribueix
└── referencies/          PDF oficials de la normativa (no versionats)

El que es publica a l'adreça web és exactament dist/pi-eso.html, byte a byte. web/ només hi afegeix el que un fitxer únic no pot portar a dins: el manifest que el fa instal·lable, el service worker que el fa funcionar sense connexió i les icones. Vegeu docs/adr/0006-versio-web-i-pwa.md.

Per què hi ha un pas de construcció

L'aplicació ha de funcionar oberta des del disc (protocol file://). En aquest context el navegador bloqueja els mòduls ES i la lectura de fitxers JSON del costat, de manera que el que es distribueix ha de ser un sol fitxer. Però un sol fitxer de 5.900 línies no és mantenible, així que el codi viu partit i tools/build.py el cus.

dist/pi-eso.html està versionat a propòsit: és l'artefacte que baixa la gent, i ha de ser accessible sense clonar el dipòsit ni tenir Python. La integració contínua comprova a cada canvi que correspon exactament al que hi ha a src/ i data/.

Vegeu docs/arquitectura.md i les decisions de disseny a docs/adr/.

Construir-la

Cal Python 3.9 o superior. No cal cap dependència per construir.

python -m tools.build              # genera dist/pi-eso.html
python -m tools.build --verifica   # comprova que dist/ correspon a src/ i data/
python -m tools.valida             # valida les dades sense construir res
python -m tools.pagines            # munta el lloc publicat a _site/

Per veure la versió web tal com la veurà qui hi entri —amb el manifest, el service worker i el botó de descàrrega, que amb file:// no s'activen— serviu _site/ per http:

python -m tools.pagines
python -m http.server -d _site 8000   # i obriu http://localhost:8000

El service worker només s'instal·la en un origen segur, i localhost compta com a tal: l'aplicació es pot instal·lar i provar sense connexió des d'aquí.

Provar-la

python -m pip install -r requirements-dev.txt
python -m pytest

Les proves comproven, entre altres coses, que la construcció sigui determinista, que dist/ estigui al dia, que cap atribut onclick de la interfície cridi una funció inexistent, que el document no carregui cap recurs extern, que el fitxer únic no referenciï res del que només existeix al servidor, que el service worker no enviï dades enlloc i que les dades del currículum no arrosseguin glifs corromputs de l'extracció dels PDF del DOGC.


Contribuir

Les aportacions més útils són correccions al banc de mesures i al currículum: hi ha 114 mesures i milers de criteris d'avaluació extrets de PDF, i cada error acaba en un document que signa un centre.

Autoria i llicència

Aplicació creada per Víctor Moreno de la Torre, psicòleg i orientador educatiu, amb l'assistència de Claude (Anthropic).

Publicada sota Creative Commons Reconeixement 4.0 Internacional (CC-BY-4.0): ús, còpia, modificació i distribució lliures i gratuïts, inclòs l'ús comercial, sempre que se'n reconegui l'autoria. Vegeu LICENSE.

El currículum i els textos normatius que s'hi incorporen provenen de publicacions oficials de la Generalitat de Catalunya; la seva autoria és del Departament d'Educació. Vegeu referencies/README.md.

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages