Memoria GameDEX Projecte 3

El nostre objectiu amb aquesta app, és fer un llistat de videojocs dividit entre les seves diferents categories (Acció, aventura, simulació, estratègia…), on els usuaris puguin afegir al seu perfil els jocs dividint-los en diferents apartats d’estat: Re-Jugat, Acabat, Jugant, Pendent o Rebutjat. I a més d’afegir-los al seu perfil, ho puguin afegir amb una qualificació del que els ha semblat el joc i afegir un comentari destinat a la comunitat.

Amb això el que volem aconseguir és, que els jugadors puguin tenir un seguiment dels videojocs que tenen pendents o acabats, que tinguin una opció eficaç per portar una organització i que a la vegada fomenti la socialització dels usuaris mitjançant un sistema que els permeti compartir les seves experiències i opinions amb la resta de jugadors.

Al mercat d’aplicacions ja existeixen diverses opcions similars a la nostra app, però amb temàtiques diferents. Per exemple, MyAnimeList o AnimePlanet són aplicacions amb característiques similars, però centrades en anime i manga, així com GoodReads i TheStoryGraph on podem trobar el mateix concepte aplicat a llibres.

L’objectiu de la nostra aplicació és portar aquest concepte al món dels videojocs, ja que per a aquesta temàtica no existeix cap aplicació globalitzada de qualitat. A més en altres aplicacions amb aquest concepte es fomenta molt la socialització, i amb el cas dels videojocs això pot ser molt beneficiós perquè pot permetre no tan sols que les persones trobin més gent amb qui comparteixen gustos sinó que també podran trobar companys amb qui jugar unes partides als videojocs que ho permetin.

La nostra aplicació està pensada per a un públic de totes les edats amb la motivació de compartir amb altres persones allò que gaudeixen, els videojocs. També pot estar orientada a persones que simplement volen portar un registre d’aquells videojocs que vol jugar o que ja ha jugat. Tot i que no hi ha gaires restriccions d’ús, l’aplicació només està disponible en tres idiomes, català, castellà i anglès i per usuaris d’Android.

En el cas de la nostra aplicació i entenent el terme “Categoria” com a un diferencial entre els ítems amb l’única finalitat de poder-los agrupar per a un filtratge previ o per a una fàcil navegació per l’aplicació. L’identifiquem com “els tipus de videojoc”, com ja hem esmentat, un videojoc pot ser d’aventures, d’acció, de simulació, etc.

En el cas d'"Item", per nosaltres és l’especificació d’un videojoc per exemple si la categoria és “Simulació”, trobaríem ítems com per exemple "Sims 4" o "Sims 3".

Per tal de deixar més clara la relació entre ambdós, cada videojoc (ítem), pot pertànyer a un tipus de videojoc (categoria), i les categories poden tenir cap, un o més videojocs.

En el cas de la nostra proposta d’aplicació, alguns exemples de processos de negoci que podem justificar des del principi, són els següents:

Primer de tot, qualsevol usuari pot afegir videojocs nous a la pàgina, això podria desencadenar en els usuaris creant jocs repetits, que vulnerin la legalitat o la llibertat d’altres persones, etc., per a combatre això hem decidit implementar un sistema on hi ha un administrador que valida els videojocs manualment.

La segona proposta de procés de negoci és que a l’hora de què un usuari vulgui afegir una puntuació/valoració al joc, haurà de primer haver afegit el joc a la seva biblioteca personal i haver-lo guardat com “Acabat”, així evitarem que qualsevol usuari que encara no hagi jugat ni acabar un videojoc pugui afegir una puntuació per a obtenir una mitjana de valoració més realista.

(Dilluns 10/02) L’Héctor, la Yaiza i l’Anna han estat molta estona intentant resoldre problemes amb l’Android Studio. Havíem de fer un pull de l’estructura i ens dónava molts problemes, començant pels “fetch” que no acabaven, documents creats al visual que no havíem creat nosaltres i que ens dónaven problemes per a poder fer el pull. A les 8:55, l’Anna havia pogut fer el pull, però l’IDE posava que “Kotlin index are corrupted” i no podia continuar. A les 9:10 hem decidit esborrar la carpeta “caches” motivats pel ChatGPT. A l’Anna li ha començat a funcionar l’Android Studio a les 9:29.

(Dilluns 10/02) A les 10:17 hem sapigut que havíem de crear tot el projecte de nou perquè havíem entès que havíem de fer servir la plantilla del Bottom Navigation. Sembla ser que és una versió antiga i que no ens serveix, i és ara que ho sabem.

(Dimarts 11/02 - Dijous 13/02) Problemes amb l’api. Hem treballat mes de 15 hores a l’api i continua sin funcionar. No terminem de entre el funcionament de l’api i en demanar ajuda al professor nos ens ha pogut ajudar.

La principal incidència que hem tingut aquest sprint és que dels 4 membres del grup hi ha 2 que no poden fer ús de l’emulador del android studio. Hem descobert aquesta setmana que atès que la API només es pot utilitzar en local, ja que no està publicada en cap servidor, no es pot fer l’execució del android studio des del mòbil i, per tant, tot el testatge de funcionalitats i el treball en general s’ha vist afectat significativament.

Aquest sprint la principal incidència que hem trobat ha sigut que no podíem treballar adequadament com que dos membres de l’equip tenen ordinadors que no suporten bé l’android Studio i, per tant, això ens ha endarrerit molt.

En el meu cas no he tingut gaires incidències, tot i això, alguns petits problemes sí que he trobat al llarg del projecte. En primer lloc, he trobat dificultats a fer les pantalles amb android studio, ja que tot i que no era un procés gaire difícil, al començament no quedava tot com m’agradava, però després vaig aprendre a fer millor les pantalles. També vaig trobar moltes dificultats amb les imatges perquè no sabíem com gestionar correctament les imatges i amb molt de temps i de recerca a internet vaig aconseguir que funcionessin com volíem. Per últim, l’API va costar molt de gestionar al començament, ja que els exemples de connexió amb API que havíem fet a classe eren molt més senzills que el que es requeria al projecte.

Aquest projecte ha estat tot un repte, doncs no he pogut treballar des de l’institut. Quan vam començar el segon Sprint i vam haver de començar a provar funcionalitats en l’emulador d’Android Studio, ja no vaig poder continuar fent servir el portàtil per a fer feina i per tant vaig haver de dedicar-li el doble d’hores, doncs vaig haver de fer tota la meva feina a casa. També vaig tenir molts problemes amb l’API doncs vaig estar treballant paral·lelament amb el Mario per aconseguir que funcionés i vam haver-li de dedicar moltes hores.

Les incidències que he trobat per la meva part ha estat per part dels requisitsdel sistema, ja que no podia treballar molt a classe i no podia comprovar si la pantalla o l’aplicació funcionava correctament, això feia que despenges dels meus companys i no avancin per culpa meva, ja que no tenia el sistema que es requeria per fer aquest projecte.

La incidència del sistema ha sigut la incidència que més m’ha perjudicat perquè per no tenir els requisits de la màquina he anat molt atabalat a més que era un projecte curt i que al principi em va costar posar-me amb el projecte, ja que no entenia res.

Durant el projecte, he tingut diverses dificultats tècniques, sobretot per connectar el Frontend amb el Backend. Al principi, vaig voler evitar l’ús d’IA per demostrar que podia desenvolupar el projecte sense dependre d’això, però la falta de temps i els errors amb l’API em van obligar a buscar ajuda per no frenar l’equip. Vaig perdre dos dies intentant solucionar un problema i, finalment, vaig recórrer a suport extern per arribar a l’entrega.
Un dels principals entrebancs va ser el desplegable de categories, que vaig implementar de manera poc eficient en un principi. En comptes de connectar correctament l’entitat Categoria amb Videojoc, vaig afegir un camp extra per gestionar-les manualment, cosa que va generar errors i inconsistències que em van fer perdre molt de temps quan dies després vaig voler posar-me amb això.
També vaig tenir dificultats amb la pantalla de modificació. Al començament no sabia com abordar-la i la vaig haver de deixar per avançar en altres tasques. Quan la vaig reprendre, encara em donava molts problemes fins que, després de diversos intents, va acabar funcionant.

Grupalment, hem trobat un gran problema al llarg de tot el projecte que ens ha endarrerit molt. La principal incidència que hem trobat a escala grupal és amb les eines de treball, els requisits de sistema per a l’ús d’emuladors a l’Android Studio són molt exigents i no coincideixen amb els requisits de sistema mínims que se’ns van demanar de cara a tenir un portàtil per a poder començar el grau. Això ens ha portat a tenir dos portàtils en el nostre grup que no podien provar les funcionalitats que s’anaven fent. A més, feien els portàtils anar amb molt de lag i s’acabaven congelant tota l’estona.

En iniciar sessió a la nostra aplicació trobarem dues barres horitzontals, una a la part superior i una a la part inferior. La barra a la part superior tindrà a l’esquerra la foto de perfil del nostre usuari, clicant aquí podrem anar a visualitzar el nostre perfil. A la part dreta es troba un botó que tancarà la sessió a l’aplicació.
La barra inferior ens permet accedir a les diferents parts de l’aplicació. Les diferents icones, per ordre, ens portaran al llistat de categories, el llistat de videojocs, el llistat d’usuaris, el perfil d’usuari i a la nostra llibreria respectivament.

Aquesta és la pantalla d’inici de sessió, on l’usuari ha d’introduir el seu nom d’usuari i contrasenya per a poder accedir a l’aplicació.
L’usuari també tindrà l’opció d’enregistrar-se si no té un compte o de recuperar la seva contrasenya en cas d’haver-la oblidat.
En clicar el botó de "confirmar", si les credencials son correctes, l’usuari serà redirigit a la pantalla principal de l’aplicació.

En aquesta pantalla trobem en la part superior el logo de l’aplicació. A l’esquerra hi ha un botó per tornar a la pantalla d’Iniciar Sessió. Seguit d’això trobem un formulari que l’usuari ha d’omplir per a poder registrar-se. Els camps que el componen són: nom d’usuari, nom, cognom, contrasenya, correu electrònic, telèfon, data de naixement i hi ha un camp per afegir una imatge de la galeria del telèfon. L’usuari ha de tenir en compte què no podrà iniciar sessió fins que el seu compte no hagi estat validat per un administrador.

Si l’usuari vol canviar la contrasenya, haurà d’haver clicat en el botó “Has oblidat la contrasenya?” que hi ha a la pantalla d’iniciar Sessió. Una vegada que l’usuari es troba en aquesta pantalla veurà en la part superior un botó per a tornar enrere i un formulari de dos camps, nom d’usuari i correu electrònic. En el cas de voler canviar la contrasenya, l’usuari ha d’omplir el formulari i clicar en Confirmar. Aleshores apareixerà un missatge de confirmació en el cas que les credencials siguin correctes juntament amb una contrasenya provisional que es recomana canviar immediatament després de l’inici de sessió.

En la pantalla de llistar categories, l’usuari pot observar tots els tipus de videojoc que s’han afegit a l’aplicació. A sota de la capçalera, trobem un buscador que ens permet filtrar pel nom de la categoria, l’usuari pot escriure el nom complet de la categoria o només una part i se li mostraran tots els resultats obtinguts. A sota hi ha la llista de categories, cada categoria és un ítem clicable que ens porta a visualitzar més informació sobre la categoria corresponent.

En la pantalla de consultar categoria podem veure més informació de la categoria seleccionada. Trobem el nom de la categoria, una imatge descriptiva, i una descripció sobre aquesta categoria.

En la pantalla de llistar videojocs l’usuari pot accedir a un llistat dels videojocs que existeixen a la base de dades de la nostra aplicació. A sota del títol, trobem un buscador que ens permet trobar més fàcilment el videojoc que estem buscant, podem escriure el nom complet i ens mostrarà només aquell resultat o, podem escriure només una part i ens mostrarà tots els resultats que coincideixin. Seguidament, trobem un menú desplegable que ens permet filtrar els videojocs per categoria. A sota trobem la llista de videojocs disponibles per als filtres que hem aplicat, si no posem cap filtre, trobarem tots els videojocs. Per cada resultat de videojoc, podem veure la seva imatge, el nom del videojoc, la categoria a la qual pertany i també tenim una icona clicable d’un ull que ens porta a la pàgina d’aquest videojoc. A la part inferior, trobem una icona amb un símbol “+”, clicant aquí, l’usuari pot accedir a presentar una nova proposta de videojoc.

En la pantalla de visualitzar videojoc trobem la informació detallada del videojoc corresponent i un apartat de comentaris on trobem les ressenyes que han deixat els usuaris sobre aquest videojoc. La pantalla està dividida en dues parts, la zona superior és la dels detalls del videojoc. Aquí podem veure la imatge, el nom, la puntuació mitjana dels usuaris, el PEGI (edat recomanada), l’any de llançament, la categoria a la qual pertany, l’empresa creadora del videojoc, i una descripció del videojoc. A la zona superior dreta, trobem una icona en forma de cor que ens permet afegir aquest videojoc a la nostra biblioteca personal i, per tant, desar una ressenya. A la zona inferior de la pantalla, trobem el llistat de comentaris per aquest videojoc. Al costat del títol de “COMENTARIS”, trobem una icona amb el símbol “+”, el qual ens porta a afegir un videojoc a la biblioteca, és la mateixa funcionalitat que el botó amb el símbol del cor de la part superior. A sota del títol, trobem el llistat de comentaris on per cada comentari podem veure el nom de l’usuari que l’ha escrit, la puntuació que li ha posat i un comentari.

En la pantalla d’afegir videojoc trobem un formulari amb la informació necessària perquè l’usuari pugui presentar una proposta de videojoc als administradors. Qualsevol proposta ha de ser validada per un administrador. El formulari consta dels camps següents: nom del videojoc, any de llançament, edat recomanada, empresa creadora del videojoc, un menú desplegable per a escollir la categoria a la qual pertany el videojoc, una descripció i una imatge descriptiva. Finalment, per a poder enviar la proposta hi ha un botó de confirmació.

En la pantalla de llistar usuaris, l’usuari pot trobar una llista de tots els usuaris independentment que hagin estat validats o no. A sota del títol, trobem un espai per a realitzar una cerca personalitzada segons el nom d’usuari, en aquest espai podem escriure el nom d’usuari complet o només una part i l’aplicació ens mostrarà els resultats obtinguts. A sota d’aquest espai, està la llista d’usuaris, on cada ítem té la imatge de perfil (si l’usuari en té), el nom d’usuari i una icona clicable que ens permet navegar al perfil de l’usuari corresponent.

En la pantalla de consultar el perfil de l’usuari, podem trobar informació de l’usuari corresponent. Els camps que podem veure són la imatge de perfil, el nom d’usuari i el recompte de videojocs filtrats per acabats, jugant, aquells que es volen jugar i aquells que no s’han finalitzat. Al costat de la imatge de perfil a l’esquerra, hi ha un botó amb un llapis (nomes si ens trobem al nostre perfil), que ens portarà a la pantalla de modificar el perfil de l’usuari. A sota del recompte de videojocs, trobem un botó que ens portarà a la llibreria de l’usuari.

En la pantalla de modificar el perfil de l’usuari, podem modificar les dades introduïdes de l’usuari, que són les mateixes que en la pantalla de registre: contrasenya, nom, cognom, correu electrònic, telèfon, data de naixement i imatge de perfil. L’únic camp que no és editable és el nom d’usuari. Si l’usuari no vol canviar la contrasenya, haurà de deixar el camp buit. A sota de la imatge, hi ha el botó de confirmar, el qual guardarà l’usuari actualitzat i ens portarà a la pantalla de visualitzar el perfil.

En aquesta pantalla l’usuari trobarà un llistat de tots els jocs que ha afegit a la seva llibreria. Cada entrada mostrarà el nom del videojoc, la seva categoria i l’estat en què l’usuari ha guardat el videojoc (Finalitzat, Pendent, Jugant, o Abandonat). També trobarà dos botons a la dreta, un vermell que eliminarà el videojoc de la seva llibreria i un fúcsia que ens permetrà editar l’entrada a ala llibreria.

Aquesta pantalla permet a l’usuari afegir un videojoc a la seva llibreria personal. Podrem introduir un estat, una puntuació i un comentari. Només serà necessari afegir l’estat, on l’usuari podrà escollir entre Finalitzat, Pendent, Jugant o Abandonat.

Aquesta pantalla permet a l’usuari modificar un videojoc de la seva llibreria personal. Podrem modificar l’estat, la puntuació i el comentari.

En iniciar sessió a la nostra aplicació trobarem dues barres horitzontals, una a la part superior i una a la part inferior. La barra a la part superior tindrà a l’esquerra la foto de perfil del nostre usuari, clicant aquí podrem anar a visualitzar el nostre perfil. A la part dreta es troba un botó que tancarà la sessió a l’aplicació.
La barra inferior ens permet accedir a les diferents parts de l’aplicació. Les diferents icones, per ordre, ens portaran al llistat de categories, el llistat de videojocs, el llistat d’usuaris, el perfil d’usuari i a la nostra llibreria respectivament.

En la pantalla de llistar categories, l’usuari pot observar tots els tipus de videojoc que s’han afegit a l’aplicació. A sota de la capçalera, trobem un buscador que ens permet filtrar pel nom de la categoria, l’usuari pot escriure el nom complet de la categoria o només una part i se li mostraran tots els resultats obtinguts. A sota hi ha la llista de categories, cada categoria és un ítem clicable que ens porta a visualitzar més informació sobre la categoria corresponent. L’administrador a més podrà afegir noves categories amb el botó amb la icona d’un “+” a l’esquena inferior dreta de la pantalla.

La pantalla d’afegir categoria és una pantalla exclusiva per l’Administrador, i el seu objectiu és poder afegir noves categories per a després assignar-li videojocs. Per poder crear-la hem d’afegir el nom de la categoria, una descripció per la categoria que vols afegir i una imatge sobre la categoria que vols crear.

En la pantalla de consultar categoria podem veure més informació de la categoria seleccionada. Trobem el nom de la categoria, una imatge descriptiva, i una descripció sobre aquesta categoria. L’administrador a més trobarà al costat del nom de la categoria, un botó vermell amb una icona d’una brossa on podrà eliminar la categoria corresponent i a sota de la informació, hi ha un botó rosa per a poder modificar la informació de la categoria: la descripció i la imatge.

Per la pantalla de modificar categoria el que podrà fer l’administrador és modificar la descripció i la imatge de la categoria visualitzada anteriorment.

En la pantalla de llistar videojocs l’usuari pot accedir a un llistat dels videojocs que existeixen a la base de dades de la nostra aplicació. A sota del títol, trobem un buscador que ens permet trobar més fàcilment el videojoc que estem buscant, podem escriure el nom complet i ens mostrarà només aquell resultat o, podem escriure només una part i ens mostrarà tots els resultats que coincideixin. Seguidament, trobem un menú desplegable que ens permet filtrar els videojocs per categoria. A sota trobem la llista de videojocs disponibles per als filtres que hem aplicat, si no posem cap filtre, trobarem tots els videojocs. Per cada resultat de videojoc, podem veure la seva imatge, el nom del videojoc, la categoria a la qual pertany i també tenim una icona clicable d’un ull que ens porta a la pàgina d’aquest videojoc. A la part inferior, trobem una icona amb un símbol “+”, clicant aquí, l’usuari pot accedir a presentar una nova proposta de videojoc.
A més l’administrador trobarà un botó a la part inferior esquerra amb un tic, que el permetrà anar al llistat de videojocs per verificar.

En la pantalla de visualitzar videojoc trobem la informació detallada del videojoc corresponent i un apartat de comentaris on trobem les ressenyes que han deixat els usuaris sobre aquest videojoc. La pantalla està dividida en dues parts, la zona superior és la dels detalls del videojoc. Aquí podem veure la imatge, el nom, la puntuació mitjana dels usuaris, el PEGI (edat recomanada), l’any de llançament, la categoria a la qual pertany, l’empresa creadora del videojoc, i una descripció del videojoc. A la zona superior dreta, trobem una icona en forma de cor que ens permet afegir aquest videojoc a la nostra biblioteca personal i, per tant, desar una ressenya. A la zona inferior de la pantalla, trobem el llistat de comentaris per aquest videojoc. Al costat del títol de “COMENTARIS”, trobem una icona amb el símbol “+”, el qual ens porta a afegir un videojoc a la biblioteca, és la mateixa funcionalitat que el botó amb el símbol del cor de la part superior. A sota del títol, trobem el llistat de comentaris on per cada comentari podem veure el nom de l’usuari que l’ha escrit, la puntuació que li ha posat i un comentari. L’administrador a més, té diverses opcions més. A la part superior a sota de la descripció, té un botó rosa per a poder modificar la informació del videojoc. A sota hi ha un botó vermell amb l’icona d’una brossa, aquí pot esborrar el videojoc.
En la secció de comentaris, l’administrador pot esborrar qualsevol comentari.

En la pantalla de llistat de videojocs per validar, l’administrador pot veure una llista de totes les propostes de videojocs que els usuaris han fet. Aquesta llista es troba a sota del títol. Per a cada proposta podem trobar una imatge, el nom del videojoc i la seva categoria. A la dreta d’aquesta informació trobem una icona amb un ull, en clicar-la, anirem a la pantalla de verificar videojoc.

En la pantalla de verificar videojoc, l’administrador pot acceptar o eliminar la proposta feta per un usuari. Primer trobarà tota la informació: el nom, una imatge, l’edat recomanada, l’any de llançament, l’empresa que ha creat el videojoc, la categoria a la qual pertany i una descripció. A la part inferior hi ha dos botons, un verd per acceptar la proposta i un vermell per a eliminar-la.

En la pantalla de llistar usuaris, l’usuari pot trobar una llista de tots els usuaris independentment que hagin estat validats o no. A sota del títol, trobem un espai per a realitzar una cerca personalitzada segons el nom d’usuari, en aquest espai podem escriure el nom d’usuari complet o només una part i l’aplicació ens mostrarà els resultats obtinguts. A sota d’aquest espai, està la llista d’usuaris, on cada ítem té la imatge de perfil (si l’usuari en té), el nom d’usuari i una icona clicable que ens permet navegar al perfil de l’usuari corresponent. Si accedim com a Administrador a sota de la barra de recerca trobarem dos botons, un per crear un usuari administrador i l’altre per verificar els nous usuaris que s’han registrat.

En aquesta pantalla trobem un formulari que l’administrador ha d’omplir per a poder registrar nous administradors. Els camps que el componen són: nom d’usuari, nom, cognom, contrasenya, correu electrònic, telèfon, data de naixement i hi ha un camp per afegir una imatge de la galeria del telèfon.

En aquesta pantalla es mostrarà una llista de tots els usuaris que s’han registrat en la nostra aplicació i encara no han estat validats. Es mostrarà el nom de l’usuari i el seu avatar. Podrem accedir a la informació d’aquell usuari fent clic a la icona del costat dret de la targeta de l’usuari.

En la pantalla de validar un usuari, l’administrador pot acceptar la validació d’un usuari o eliminar-lo. En aquesta pantalla trobem les dades de l’usuari registrat, una imatge de perfil, el nom d’usuari, nom, cognom, telèfon, data de naixement, tipus d’usuari (usuari o administrador) i l’estat del registre de l’usuari. A sota hi ha dos botons, validar usuari per acceptar el registre i un per eliminar a l’usuari.

En la pantalla de consultar el perfil de l’usuari, podem trobar informació de l’usuari corresponent. Els camps que podem veure són la imatge de perfil, el nom d’usuari i el recompte de videojocs filtrats per acabats, jugant, aquells que es volen jugar i aquells que no s’han finalitzat. Al costat de la imatge de perfil a l’esquerra, hi ha un botó amb un llapis, que ens portarà a la pantalla de modificar el perfil de l’usuari. A sota del recompte de videojocs, trobem un botó que ens portarà a la llibreria de l’usuari.
L’administrador a més podra esborrar tots els perfils que no siguin el seu.