Projecte Portal de Matriculacions

Hem iniciat un projecte de matriculacions d'alumnes per a centres educatius. Podeu veure la descripció del projecte i els primers 2 sprints al següent link:

https://scrum.ieti.cat/scrum/projecte/10

Referències

• Portal de Matriculacions - core specs al portal Scrum IETI
• Matrics - Portal de Mariculacions a Github

Descripció del projecte

Portal de matriculacions per a centres educatius de formació professional. De moment només ens ocupem de la FP i no de la ESO/BAT.

MVP: Minimum Viable Product. Cas més senzill: matricular els alumnes nous de 1r de cicles formatius (es matriculen de tot el curs sencer, o sigui, totes les UFs).

2n cas: matricular alumnes de cicles de 2n o repetidors de 1r amb UFs aprovades.

Tipus d'usuaris: administradors (PAS del centre) i alumnes que es volen matricular.

Els usuaris administradors han de poder:

• Crear (des de zero) i editar: cursos, cicles, mòduls professionals (MPs) i unitats formatives (UFs).
• Importar cicles sencers (amb MPs i UFs) de plantilles predefinides. El cas més comú és per afegir un nou cicle. Els plans d'estudi s'ajustarien després amb la funcionalitat anterior.
• Importar les dades dels nous alumnes admesos al centre per cada cicle.
• Importar els expedients acadèmics dels alumnes amb els mòduls i UFs aprovats per tal de facilitar la seva matriculació.
• Crear requeriments de documents que l'alumne ha d'aportar per formalitzar la matrícula.
• Crear perfils de requeriments per aplicar a diversos casos (CFGM, CFGS, ESO, BAT, menors d'edat, etc).
• Obrir i tancar l'accés dels alumnes al portal de matriculació.
• Enviar email d'invitació als alumnes per tal que comencin el procés de matriculació. Aquest enviament pot ser en massa (per a tots els alumnes, per cicle o per curs d'un cicle), o individualitzat.

Els usuaris alumnes han de poder:

• Accedir al portal mitjançant el correu electrònic subministrat a la inscripció. Abans requerirà que recuperin contrasenya via email.
• Rebre un email d'invitació a formalitzar la matrícula.
• Seleccionar els MPs i les UFs a matricular-se.
• Oferir un total del preu de la matrícula (pels CFGS) en base als MPs i UFs.
• Bloquejar els MPs i UFs superades per evitar que es matriculi de nou.
• Pujar els documents requerits per formalitzar la matrícula.
• Mostrar un estat de la matrícula amb una interfície adequada (tipus semàfor en vermell, taronja i verd), que faciliti l'alumne saber quins requeriments té pendents per tal de finalitzar el procés de matriculació.

Els documents requerits han de ser revisats i validats pel PAS. Només després d'aquest pas final l'alumne tindrà la llum verda final de la matrícula.

Opcionalment es contemplen les següents funcionalitats:

• Social login per als alumnes (Gmail, Hotmail/Outlook, etc.)
• Social login per als admins (xtec)
• Simulació de visualització de rol alumne per part dels admins.

Fase 1: core

Als 2 primers sprints hem implementat el projecte base en Laravel, BD, migracions, taules i les primeres funcionalitats. Tots els equips han desenvolupat totes les specs.

Ho podeu llegir a https://scrum.ieti.cat/scrum/projecte/10

BACKLOG Fase 2

Transversals

• missatges flash per TOT
• responsive TOT

Producció

• social login google+microsoft
• login estàndard amb codi d'un sol us via email
• posta en prod Heroku
• posta en prod AWS
• càrrega de docs/imatges versió DB. assegurar que carreguen imatges grans.
• càrrega de docs/imatges versió FILESYSTEM.
• documentar posta en producció

API & +

• documentar totes les API a la Wiki del projecte
• APIs per app mòbil
  • login alumne
  • selecció perfil de requeriments
  • autoritzacions/acceptació de polítiques de privacitat
  • selecció de UFs
  • càrrega d'arxius (i canvi d'estat)
  • enviament de notificacions (sol·licitud de canvi de dades personals, incidències, etc.)

• social login per mobile app
• test APIs
• versió amb taules separades per admins i alumnes

Admin panel

• CRUD complert alumnes (sense AJAX)
• CRUD complert admins (sense AJAX)
• CRUD complert de Perfils de requeriments i requeriments (sense AJAX)

• llistat alumnes amb filtres per: cicle, nom, cognom1, cognom2, estat matrícula

• ordenar per diferents criteris
• visualització de documents carregats
• panell de revisió de documentació carregada
  • Quan un alumne carrega TOTS els documents, es visualitza en el panell de matrícules a revisar.
  • Es podrà canviar l'estat de doc a OK (verd) o ERROR (vermell) amb COMENTARIS.
  • Quan tota la doc estigui OK s'activarà un botó d'estat total de la matrícula a FINALITZADA

• gestió de notificacions/incidències
  • panell de control on es mostren incidències a resoldre
  • Ha d'estar integrat amb el panell de revisió de la documentació

• enviament emails: (alumnes)
  • canvi estat doc
  • nova incidència
  • nova sol·licitud de canvi de dades
  • noves respostes

Alumne frontend

per tot: RESPONSIVE

• selecció perfil de requeriments
• càrrega de Documentació
  • versió FILESYSTEM
  • versió DB
• visualització de documentació i UX clara d'estat de cada Doc i de la matrícula general
  • q s'entengui q és un semàfor

• enviament de notificacions
  • sol·licitud de canvi de dades personals
  • incidències
  • ...?
• autoritzacions/acceptació de polítiques de privacitat
• càlcul cost matrícula
• selecció d'UFs
• pasarel·la de pagament (simulació)

Importació i testing

• tancar importació alumnes admesos
• importació dades SAGA (UFs superades)
• gestió errors (log/consultable)
• tests browser site
• documentació testing
• CI amb Jenkins

Fase 2: Desenvolupament avançat

Es tria el millor projecte de la Fase 1, i s'utilitza com a base per al desenvolupament posterior.

Cada equip desenvoluparà una part diferent del projecte, per tal d'avançar més ràpid i cobrir més funcionalitats.

Es refaran els equips depenent de les preferències de l'alumnat.

Equips i backlog fase 2

UI + Social Login + posta producció

• social login Google + Microsfot
• posta en producció Heroku
• assegurar càrrega d'imatges
• disseny frontend web alumne
• disseny frontend app mòbil
• disseny backend administració
• missatges flash

API

• implementar funcionalitats que demanin els altres grups
• documentació
• testing
• autenticació API(token)
• CRUDs cursos, cicles, mps, ufs
• CRUD alumnes/matrícules
• CRUD admin users
• Preparar controlador para enviar el mail
• Preparar migracion para añadir columna de estado a los req_enrolments
• Preparar migracion para añadir columna active en las mps y ufs

Dashboard per a l'administrador de l'aplicació (back-of-the-frontend)

• Un admin ha de poder filtrar per: curs (1r/2n, desplegable), cicle (autocompletar), cognom1, cognom2, nom, estat matrícula (tots els docs estan pujats o no, vàlids o no...)
• Ordenar/invertir ordre per un sol criteri
• Un admin ha de poder editar o actualitzar dades d'un alumne de les que vénen del SAGA. Només PUT y UPDATE, no podrà mai fer un DELETE
• Perfils de requeriments: en funció de si un alumne marca que es eligible a beques o altres ajudes, se li desbloquejarà en el seu dashboard la posibilitat de penjar els documents pertinents.
  • Monoparental: hauria de presentar, per exemple, tres documents
  • Discapacitat: hauria de presentar, per exemple, 4 documents, una imatge y un identificador digital
  • etc

> Aquest documents, després, es validaran en el dashboard de l'admin. Es mostraran totes les dades de l'usuari, a més de l'estat de cada document pujat. Els documents pujats varien en funció del perfil de requeriment seleccionat desde el dashboard d'alumne. Per a això:

• L'admin ha de poder descarregar-se una còpia dels documents adjuntats.
  • Després, revisarà manualment la validesa dels documents.
    • Després, marcarà quins estan OK i quins no. Guardarà els canvis.
      • Llavors s'enviarà un mail automatitzat donant un OK o un KO. En cas de KO, agafarà de manera automàtica els camps que estiguin malament, i ho escriurà en el cos del mail.

En el dashboard, hi haurá una sèrie de pistes visuals que indicaran a l'admin l'estat de la solicitud de matrícula de cada alumne.

• gris: no enviat cap document enviat
• taronja: document(s) enviat(s) pendent de revisió. Cap la possibiltat que l'usuari només hagi pujat una part de tots els documents!!
• verd: revisat ok
• vermell: revisat error

Documents que s'hauran d'adjuntar, en funció dels perfil triat:

• Obligatoris: DNI/NIE, targeta sanitaria, resguard del títol, pagament
• Menor: DNI pares, llibre de família / partida naixement
• Perfils pagament superior:
  • Família nombrosa: carnet de família nombrosa
  • Família monoparental
  • Beca
  • Discapacitat
  • Alumne tutelat
  • Beneficiari de la RMI

alumne frontend

• dashboard
• selecció UFs
• selecció perfil de req.
• càlcul cost matrícula
• estat dels docs enviats
• estat de la matrícula
• correcció dades personals
  • ???? POT CANVIAR: direcció, telèfons,
  • NO POT CANVIAR: DNI, NIE, Nom, Cognoms
• sol·licitud de canvis de dades
• versió mòbil
• simulació pasarela de pagament

• Autoritzacions (radio button, obligatori):
  • autorització drets d'imatge (tots)
  • autorització sortides (menors)
  • sortides extraescolars (menors)

Càlcul preu de la matrícula:

• CFGM (curs sencer)
  • >28 : assegurança a part de l'escolar 105,38€
  • <28 : 86,50€
• CFGM (per MPs)
  • 10€/MP + asseg. escolar (<28 1,12€, >28 20€)
• CFGS
  • curs sencer:
    • <28 anys: 360,00 € + 65 (material) + 1,12 € (asseg.)
    • >28 anys: 360,00 € + 65 (material) + 20 € (asseg.)
  • bonificació 50% (fam. nombrosa/monoparental/beca)
    • <28 anys: 180 € + 66,12 €
    • >28 anys: 180 € + 85 €
  • exempció: (fam. nombrosa/minusvalia/víctimas terr./privats de llibertat/...)
    • <28 anys: 66,12 €
    • >28 anys: 85 €
  • CFGS per UFs:
    • 25 €/UFs (sin bonif.)
    • 12,5 €/UFs (con bonif.)
    • 1,12 €/20€ assegurança
    • 10€ material si només son UFs de 1 MP
    • 65 € material si son UFs de >1 MPs

Pagament fraccionat CFGS:

• 1a fracció 1/2 del preu públic (360/180) + material+asseg. (66,12/85)
• 2a fracció 1/2 del preu públic

importació i testing

• importació alumnes admesos (manteniment)
• importació dades SAGA (UFs superades)
• gestió dels errors d'importació:
  • fitxer de sortida amb registre d'errors (per a ser corregits i reimportats)
  • matrícules duplicades: es sobreescriuen si son del mateix any i mateix cicle
  • importació cicles duplicats: preguntar
• testing de la site

Apèndix

Ramas:

• x Pre
• x Pro
• x Integración
  • Una rama por cada alummno
  • Una rama por cada funcionalidad
  • Una rama para CRUD
  • Una rama para CSS

Proceso de dailys

1 Daily de cada equipo 2 Daily de representantes de equipos, con dudas de los dailys de cada equipo 3 Se solucionan dudas (y nuevas preguntas) a los equipos otra vez 4 Última resolución, idealmente...

Nomenclatura de los JSON cuando se estén intercambiando datos

• Cuando se pidan datos a API, y API los devuelva, enviará un array de JSON, cuyas claves serán los nombres de las columnas
• Cuando se envíen datos a API desde el frontend, por ahora hay que hablar con el equipo de API y pactar la convención de nombres. Quizás en el futuro bastará con los nombres de las columnas también a la hora de enviar datos.
  • Recordar usar verbos HTTP adecuados