Projecte Matrics

Aquesta pàgina fa referència al Projecte Portal de Matriculacions que es va desenvolupar durant el 2n quadrimestre del curs 2020-2021 amb els alumnes de CFGS de Desenvolupament Web (DAW) i Multiplataforma (DAM) de l'INS Esteve Terradas i Illa.

Ara tindrà el nom MATRICS a partir del moment en què ens demanen una versió funcional per a fer-se servir en producció de forma real.

Context

Podeu llegir Projecte Portal de Matriculacions amb les explicacions i primeres iteracions del projecte.

En aquesta fase del projecte partim d'un codi base ja elaborat pels alumnes, però que té una gran quantitat de deute tècnic. Els motius son el funcionament per sprints que obligava a presentar els prototips amb temporització molt justa, i algunes implementacions exigides amb AJAX per cobrir el temari del curs, que probablement tindria una implementació menys complexa en costat servidor.

Abandonem el MVP de matriculacions de 1r curs. Ara ja es podran matricular els de 1r i els de 2n, i caldrà tenir en compte les UFs dels alumnes que ha hagin superat.

L'objectiu del projecte és crear una aplicació web:

• Que compleixi uns estàndards de seguretat (OWASP com a mínim)
• Amb llicència de codi lliure.
• Que permeti configurar tots els cicles formatius del centre amb els seus MPs i UFs particularitzats a qualsevol pla d'estudi.
• Que permeti importació en massa dels alumnes admesos pel Departament d'Educació.
• Que permeti importació de dades del SAGA per conèixer les UFs aprovades de l'alumnat.
• Que permeti als ALUMNES:
  • Accedir-hi de la forma més senzilla possible (amb email/password i social login al menys).
  • Seleccionar el tipus de perfil de requeriments (documents a enviar).
  • Que permeti carregar tots els documents requerits (en PDF i/o foto amb el mòbil).
  • Que permeti seleccionar les UFs i calculi el preu de la matrícula.
  • Que permeti el pagament online de la matrícula.
  • Que impedeixi que els alumnes es puguin equivocar al seleccionar UFs ja superades.
  • Que sàpiguen en tot moment i de forma clara i inequívoca l'estat de la seva matrícula.
• Que permeti al PERSONAL d'ADMINISTRACIÓ:
  • Veure els documents carregats pels alumnes i validar-los de forma efectiva.
• Que generi alarmes via email, SMS i/o notificacions mòbils a l'alumnat.

Workflow

1. Alumnes es matriculen a la web del Departament d'Educació (DdE)
2. El centre rep un full de càlcul amb dades de matrícules d'alumnes admesos.
3. Es crea (o clona) nou curs acadèmic.
4. S'importen (afegeixen) els cicles formatius que faltin a partir del llibre .
5. El centre disposa (al SAGA) de les notes dels alumnes

Necessitats de refactoring detectades

• Treure autenticació API a les crides a funcions AJAX internes a la web. S'ha de resoldre amb el auth middleware propi de Laravel.
• Eliminar AJAX innecessari, o implementar funcionalitats preferentment en costat servidor.
• Establir llibre d'estil i bones pràctiques.
  • https://phptherightway.com/

Aplicació mòbil

Specs no funcionals

• S'implementarà amb Cordova i Materialize CSS
• Multiplataforma:
  • Disponible a Google Play (android)
  • Disponible a App Store (ios)
  • Estudiar disponibilitat a altres plataformes (macos, windows, etc.)

API

L'equip de treball de l'app mòbil haurà de sol·licitar els requeriments que necessitin per a accedir a l'aplicació web.

Hi haurà un equip de treball intermig entre app i web, on hi haurà un responsable de cada cicle:

• Juan Carlos Salines per DAW
• ??? per DAM

Backlog app: funcionalitats

• Auth:
  • Email/Password
  • Social login (Google i Microsoft com a mínim)
  • Recuperar contrasenya via email
• Tria perfil de requeriments
• Estat dels documents (uploads)
• Estat de la matrícula
• Selecció UFs i preu de la matrícula basada en perfil de requeriments + UFs seleccionades
• Visualització dades personals
• Sol·licituds de canvis dades
• Notificacions (APNS, Apple i Android)

Portal web

Partim del software desenvolupat amb els alumnes i que està al següent repositori:

https://github.com/aws2/matrics

Es faran 3 rols pels equips treball. Els alumnes rotaran el seu rol durant el desenvolupament:

• Desenvolupament de noves features.
• Debugging.
• Refactoring.

Backlog web admin

• No necessita ser responsive.
• Panell de control de Admin amb CRUDs complerts per a:
  • Admins
  • Cursos, Cicles, MPs i UFs
  • Matriculacions/Alumnes
• Importació:
  • Cicles Formatius
  • Alumnes admesos
  • Qualificacions del SAGA (per ser utilitzades a la selecció de UFs)
• Revisió i aprovació de documents i matrícules
• Visualització de documents
• Gestió de missatges de sol·licituds

Backlog web alumne

• Responsive

...tota la resta de specs funcionals que té el backlog de la app mòbil

Backlog (altres)

Aquesta part caldrà estar coordinats amb l'equip del cicle de Ciberseguretat.

• Testing
• Dockerització de l'app
• Posta en producció a: AWS, Azure, Heroku
• Gestió domini

Ciberseguretat

Els alumnes de Ciberseguretat s'ocuparan de:

• Testeig de l'aplicació.
• Creació de nous tests (menys prioritari).
• Dockerització de l'aplicació web.
• Posta en producció segura a AWS i Azure.
• Sandboxing
• Pentesting de la web.
• Proves de seguretat de la app mòbil en iOS i Android.