Wiki Local - Contribuciones del usuario [es]

Manual d'usuari de Gestió Monedes

2026-04-15T20:37:17Z

Admin: Ampliació del manual: arquitectura MVC, instal·lació, dependències i integracions CMS

__TOC__
= Manual d'usuari de Gestió Monedes =

'''Versió PDF del manual:''' [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari de Gestió Monedes (PDF)]

'''Aplicació web:''' [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]

'''Documentació tècnica:''' [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]

== 1. Presentació del projecte ==

'''Gestió de Monedes''' (v1.1.0) és una aplicació web per administrar una col·lecció de monedes des del navegador. Permet crear registres nous, consultar-los, editar-los, eliminar-los, gestionar imatges i importar/exportar dades en format XML i CSV.

L'objectiu del projecte és oferir una eina clara, funcional i fàcil de desplegar per a entorns acadèmics o personals, sense dependre de cap framework extern.

{| class="wikitable"
! Recurs
! Enllaç
! Finalitat
|-
| Aplicació web
| [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]
| Ús diari de l'aplicació
|-
| Manual PDF
| [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari en PDF]
| Consulta i impressió
|-
| Documentació tècnica
| [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]
| Instal·lació, arquitectura i dependències
|-
| Extensió MediaWiki
| [https://fmehmood.cat/mediawiki/index.php/Special:GestioMonedes Special:GestioMonedes]
| Catàleg integrat a la wiki
|}

== 2. Arquitectura i tecnologies ==

L'aplicació segueix el patró '''Model-Vista-Controlador (MVC)''' i s'executa sobre PHP pur sense frameworks:

{| class="wikitable"
! Capa
! Fitxers principals
! Responsabilitat
|-
| Presentació
| <code>views/header.php</code>, <code>llistat.php</code>, <code>formulari.php</code>, <code>detall.php</code>
| Genera el HTML que rep el navegador
|-
| Control
| <code>index.php</code>, <code>MonedaController.php</code>, <code>ImportExportController.php</code>
| Rep peticions, coordina model i vista
|-
| Model
| <code>models/Moneda.php</code>, <code>models/GestorImatge.php</code>
| Lògica de negoci, CRUD i gestió d'imatges
|-
| Base de dades
| MariaDB · taula <code>monedes</code>
| Emmagatzematge relacional via PDO
|}

=== Esquema de la base de dades ===

{| class="wikitable"
! Camp
! Tipus
! Nul·lable
! Descripció
|-
| <code>id</code>
| INT UNSIGNED PK AI
| No
| Identificador únic autoincremental
|-
| <code>nom</code>
| VARCHAR(150)
| No
| Nom oficial de la moneda
|-
| <code>pais</code>
| VARCHAR(100)
| No
| País o territori emissor
|-
| <code>valor</code>
| DECIMAL(15,4)
| No
| Valor facial o numismàtic
|-
| <code>any_emissio</code>
| SMALLINT
| No
| Any d'emissió (negatiu = a.C.)
|-
| <code>descripcio</code>
| TEXT
| Sí
| Descripció lliure
|-
| <code>imatge</code>
| VARCHAR(255)
| Sí
| Nom del fitxer d'imatge
|-
| <code>creat_el</code>
| DATETIME
| No
| Data de creació automàtica
|-
| <code>actualitzat</code>
| DATETIME
| No
| Data d'última modificació
|}

=== Tecnologies principals ===

* '''PHP 8.0+''' (sense frameworks) — motor d'aplicació
* '''MariaDB 10.5+''' — base de dades relacional via PDO
* '''Apache 2.4+ / Nginx 1.18+''' — servidor web
* '''HTML5, CSS3 i JavaScript vanilla''' — interfície d'usuari

== 3. Navegació principal ==

La barra superior de l'aplicació inclou aquests accessos:

* '''Col·lecció''' — llistat de totes les monedes
* '''Nova moneda''' — formulari per crear un registre nou
* '''Import/Export''' — importació i exportació en XML i CSV
* '''Documentació''' — descripció, arquitectura, manual i instal·lació

Flux d'ús recomanat:

# Crear una moneda nova.
# Afegir-hi dades i, si cal, una imatge.
# Revisar la fitxa de detall.
# Aplicar filtres o ordenació quan el catàleg creix.
# Exportar les dades si es necessita una còpia de treball.

== 4. Crear una moneda ==

Per donar d'alta una moneda:

# Fes clic a '''Nova moneda'''.
# Omple els camps obligatoris:
#* '''Nom''' — nom oficial o popular (ex: «Euro», «Pesseta», «Denari»)
#* '''País''' — territori emissor (ex: «Espanya», «Unió Europea»)
#* '''Valor''' — valor facial en format numèric (ex: 1.00, 0.50)
#* '''Any d'emissió''' — per anys a.C., usa valors negatius (ex: -264)
# Omple la '''Descripció''' si vols afegir informació contextual.
# Puja una imatge si la vols associar al registre.
# Prem '''Crear moneda'''.

Quan el formulari és correcte, el sistema desa la moneda, torna al llistat i mostra un missatge de confirmació.

== 5. Consultar el llistat i el detall ==

Des del llistat principal pots:

* veure totes les monedes en forma de targetes
* ordenar per nom, any o valor fent clic a les capçaleres
* obrir la vista de detall fent clic sobre una targeta
* editar o eliminar registres directament des de la targeta

La vista de detall mostra:

* imatge principal
* valor destacat
* país o territori emissor
* any d'emissió
* nom complet
* descripció
* metadades del registre (identificador, dates de creació i modificació)

== 6. Editar i eliminar ==

=== 6.1 Editar ===

Per editar una moneda:

# Entra a la fitxa o fes clic a '''Editar''' des del llistat.
# Modifica els camps necessaris.
# Si no afegeixes una nova imatge, la imatge actual es conserva.
# Si vols esborrar la imatge actual, marca l'opció corresponent.
# Prem '''Desar canvis'''.

=== 6.2 Eliminar ===

Per eliminar una moneda:

# Fes clic a '''Eliminar''' (botó vermell).
# Revisa el nom al quadre de confirmació.
# Fes clic a '''Eliminar''' per confirmar, o '''Cancel·lar''' per abortar.

'''Atenció:''' l'eliminació és permanent i també suprimeix la imatge associada si existeix.

== 7. Cerca, filtres i ordenació ==

El panell de filtres permet cercar per:

{| class="wikitable"
! Filtre
! Descripció
! Exemple
|-
| Nom
| Cerca per coincidència parcial
| <code>Euro</code> → troba «Euro», «Euronova»…
|-
| País
| Cerca per coincidència parcial
| <code>Esp</code> → troba «Espanya», «Esparta»…
|-
| Any d'emissió
| Any exacte
| <code>1999</code> o <code>-264</code>
|-
| Valor mínim
| Valor ≥ al valor indicat
| <code>0.50</code>
|-
| Valor màxim
| Valor ≤ al valor indicat
| <code>100</code>
|}

Els filtres es poden combinar lliurement. L'enllaç '''Mostra-les totes''' o el botó '''×''' permet tornar a l'estat general del catàleg.

== 8. Gestió d'imatges ==

La pujada d'imatges admet:

* JPG o JPEG
* PNG
* GIF
* WebP

Característiques principals:

* selecció manual de fitxer o arrossegar i deixar anar (drag & drop)
* previsualització en temps real abans de desar
* mida màxima: '''5 MB'''
* validació del tipus MIME real del fitxer
* eliminació automàtica del fitxer quan s'esborra el registre

== 9. Importació i exportació ==

Des de la pantalla '''Import/Export''' pots:

* exportar totes les monedes a XML
* exportar totes les monedes a CSV
* importar monedes des d'un XML vàlid
* importar monedes des d'un CSV amb capçalera correcta

=== 9.1 Exportar ===

L'exportació genera un fitxer descarregable directament des del navegador amb el nom <code>monedes_YYYYMMDD_HHMMSS.xml</code> o <code>.csv</code>.

=== 9.2 Importar XML ===

# Ves a '''Import/Export'''.
# Selecciona un fitxer XML amb l'estructura esperada.
# Prem '''Importar des de XML'''.

L'aplicació informa del nombre de monedes importades i dels errors detectats.

=== 9.3 Importar CSV ===

# Prepara el fitxer amb la capçalera: <code>nom;país;valor;any emissió;descripció</code>
# Selecciona'l al formulari.
# Prem '''Importar des de CSV'''.

El sistema detecta automàticament el separador (punt i coma o coma) i valida la capçalera i el contingut mínim.

== 10. Bones pràctiques ==

Per treballar millor amb l'aplicació:

* escriu noms i països de forma coherent i homogènia
* revisa els valors numèrics i l'any abans de desar
* usa la descripció per afegir context útil, no redundant
* fes exportacions periòdiques si el catàleg és important
* revisa els missatges d'èxit o error després de cada acció

== 11. Incidències habituals ==

{| class="wikitable"
! Problema
! Causa probable
! Solució
|-
| Imatge no es puja
| Format no admès o fitxer massa gran
| Comprova que sigui JPG, PNG, GIF o WebP i que no superi 5 MB
|-
| Importació falla
| Estructura XML o capçalera CSV incorrecta
| Revisa el format del fitxer importat
|-
| No es troba un registre
| Hi ha filtres actius
| Fes clic a «Mostra-les totes» per eliminar els filtres
|-
| Dada incorrecta
| Error en la creació o edició
| Entra a editar el registre i corregeix el camp
|}

== 12. Instal·lació i configuració ==

Aquesta secció descriu com desplegar l'aplicació en un servidor Ubuntu/Debian. La guia completa amb totes les opcions de configuració avançada es troba a la [https://fmehmood.cat/gestio_monedes/documentacio.php#instalacio documentació tècnica del projecte].

=== 12.1 Requisits del sistema ===

{| class="wikitable"
! Component
! Versió mínima
! Recomanada
|-
| PHP
| 8.0
| 8.2 o superior
|-
| MariaDB
| 10.5
| 10.11 o superior
|-
| Servidor web
| Apache 2.4 / Nginx 1.18
| Apache 2.4+
|-
| Extensions PHP
| pdo_mysql, mbstring, xml, fileinfo
| —
|-
| Sistema operatiu
| Linux, macOS, Windows (XAMPP)
| Ubuntu 22.04 LTS
|}

=== 12.2 Passos d'instal·lació ===

'''Pas 1 — Instal·lar dependències:'''

<pre>
sudo apt update && sudo apt install -y \
apache2 php php-mysql php-mbstring php-xml php-fileinfo mariadb-server
sudo systemctl enable --now apache2 mariadb
</pre>

'''Pas 2 — Copiar el projecte i preparar els permisos:'''

<pre>
cp -r gestio_monedes/ /var/www/html/
chmod 755 /var/www/html/gestio_monedes/uploads/
chown www-data:www-data /var/www/html/gestio_monedes/uploads/
</pre>

'''Pas 3 — Configurar les credencials:'''

Opció recomanada: crear el fitxer <code>/etc/gestio_monedes/config.local.php</code> fora del directori web. Alternatives: variables d'entorn <code>GESTIO_MONEDES_DB_*</code> o editar directament <code>config.php</code>.

'''Pas 4 — Primera execució:'''

Obre el navegador a l'URL de l'aplicació. La base de dades i la taula es creen automàticament si les credencials són correctes. No cal executar cap script SQL manualment.

== 13. Dependències i resolució de problemes ==

=== 13.1 Dependències ===

{| class="wikitable"
! Dependència
! Paquet
! Verificació
! Si falta
|-
| Servidor web
| <code>apache2</code> o <code>nginx</code>
| <code>systemctl status apache2</code>
| <code>sudo apt install apache2 -y</code>
|-
| Motor PHP
| <code>php</code> + <code>libapache2-mod-php</code>
| <code>php -v</code>
| <code>sudo apt install php libapache2-mod-php -y</code>
|-
| PDO MySQL
| <code>php-mysql</code>
| <code>php -m | grep pdo_mysql</code>
| <code>sudo apt install php-mysql -y</code>
|-
| Multibyte strings
| <code>php-mbstring</code>
| <code>php -m | grep mbstring</code>
| <code>sudo apt install php-mbstring -y</code>
|-
| XML
| <code>php-xml</code>
| <code>php -m | grep simplexml</code>
| <code>sudo apt install php-xml -y</code>
|-
| Fileinfo
| <code>php-fileinfo</code>
| <code>php -m | grep fileinfo</code>
| <code>sudo apt install php-fileinfo -y</code>
|-
| MariaDB
| <code>mariadb-server</code>
| <code>systemctl status mariadb</code>
| <code>sudo apt install mariadb-server -y</code>
|}

=== 13.2 Resolució de problemes habituals ===

{| class="wikitable"
! Error
! Causa probable
! Solució
|-
| Error de connexió a la BD
| Credencials incorrectes o MariaDB aturat
| Verifica <code>config.php</code> i executa <code>sudo systemctl status mariadb</code>
|-
| No s'ha pogut desar la imatge
| Permisos incorrectes a <code>uploads/</code>
| <code>chmod 755 uploads/ && chown www-data uploads/</code>
|-
| Pàgina en blanc
| Error de PHP ocult
| Activa <code>GESTIO_MONEDES_APP_DEBUG=1</code> o revisa <code>/var/log/apache2/error.log</code>
|-
| Error 413 (fitxer massa gran)
| Límit de pujada del servidor
| Augmenta <code>upload_max_filesize</code> a <code>php.ini</code> i reinicia Apache
|-
| Caràcters incorrectes
| Charset de la BD no és utf8mb4
| <code>ALTER DATABASE gestio_monedes CHARACTER SET utf8mb4</code>
|-
| Falta una extensió PHP
| No estan carregats pdo_mysql, mbstring, xml o fileinfo
| Instal·la el paquet corresponent amb <code>apt</code> i reinicia Apache
|}

== 14. Integracions CMS ==

El projecte inclou tres integracions opcionals per a sistemes de gestió de continguts. Totes llegeixen i escriuen des de MariaDB, CSV i XML.

=== 14.1 Plugin WordPress ===

* '''Nom:''' Gestio Monedes WP
* '''Shortcode:''' <code>[gestio_monedes_llistat]</code>
* '''Funcions:''' mostra el catàleg al frontend; permet inserir monedes des del panell d'administració; admet filtres per nom, país, any i valor.
* '''Fonts de dades:''' MariaDB, CSV, XML

=== 14.2 Extensió MediaWiki ===

* '''Nom:''' GestioMonedes
* '''Pàgina especial:''' [https://fmehmood.cat/mediawiki/index.php/Special:GestioMonedes Special:GestioMonedes]
* '''Funcions:''' consulta, filtres, inserció de monedes i visualització d'imatges directament des de la wiki.
* '''Fonts de dades:''' MariaDB, CSV, XML

=== 14.3 Component Joomla ===

* '''Nom:''' com_gestiomonedes
* '''Frontend:''' [https://fmehmood.cat/joomla/index.php/gestio-monedes-joomla Gestió Monedes Joomla]
* '''Funcions:''' frontend públic amb catàleg i filtres; backend d'administració per configurar la font de dades i inserir monedes.
* '''Fonts de dades:''' MariaDB, CSV, XML

== 15. Enllaços útils ==

* [https://fmehmood.cat/gestio_monedes/ Aplicació Gestió de Monedes]
* [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació tècnica del projecte]
* [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari en PDF]
* [https://fmehmood.cat/mediawiki/index.php/Special:GestioMonedes Extensió MediaWiki — Special:GestioMonedes]
* [https://fmehmood.cat/joomla/index.php/gestio-monedes-joomla Component Joomla — Frontend]

Página principal

2026-04-15T17:53:46Z

Admin: Restaurar la portada al estado anterior a la sección Test Copiar Web

Página principal

2026-04-15T17:52:22Z

Admin: Añadir sección Test Copiar Web con la rúbrica copiada desde binefa.com

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==
* [https://fmehmood.cat/gestio_monedes/ Projecte del tercer trimestre. Gestió Monedes]
** [[Manual d'usuari de Gestió Monedes|Manual d'usuari de Gestió Monedes (wiki)]]
** [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari de Gestió Monedes (PDF)]
** [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.docx Manual d'usuari de Gestió Monedes (DOCX)]

== Projecte PJ7 ==
* Projecte Integrador Bash 06. Sistema de Desplegament i Monitorització

== Test Copiar Web ==

{| class="wikitable" style="margin:auto"
|+ Rúbrica del projecte del tercer trimestre
|-
! !! 4 !! 3 !! 2 !! 1
|-
| Funcionalitat de la pàgina web (10%)
|| El projecte ha de tenir una interfície gràfica d'usuari ben dissenyada utilitzant PHP.

Ha de permetre opcions per connectar-se a una base de dades MariaDB.

El sistema ha de permetre als usuaris realitzar operacions CRUD bàsiques (Create, Read, Update, Delete) a la base de dades MariaDB.

Ha de permetre exportar dades des de fitxers XML a la base de dades MariaDB.

El sistema ha de gestionar els errors i excepcions de manera adequada.
|| El projecte ha de tenir una interfície gràfica d'usuari ben dissenyada utilitzant PHP.

Ha de permetre opcions per connectar-se a una base de dades MariaDB.

El sistema ha de permetre als usuaris realitzar operacions CRUD bàsiques (Create, Read, Update, Delete) a la base de dades MariaDB.

El sistema ha de gestionar els errors i excepcions de manera adequada.
|| El projecte ha de tenir una interfície gràfica d'usuari ben dissenyada utilitzant PHP.

Ha de permetre opcions per connectar-se a una base de dades MariaDB.

El sistema ha de permetre als usuaris realitzar operacions CRUD bàsiques (Create, Read, Update, Delete) a la base de dades MariaDB.

|| Ha de permetre opcions per connectar-se a una base de dades MariaDB.

El sistema ha de permetre als usuaris realitzar operacions CRUD bàsiques (Create, Read, Update, Delete) a la base de dades MariaDB.
|-
| Integració a la base de dades (10%)
|| El projecte ha d'establir una connexió amb MariaDB utilitzant PDO.

Ha d'incloure funcionalitats per crear una nova base de dades i taules dins de MariaDB.

El sistema ha de gestionar la inserció, actualització i eliminació de documents a MariaDB.

Ha de proporcionar opcions per consultar i recuperar dades a MariaDB.
|| El projecte ha d'establir una connexió amb MariaDB utilitzant PDO.

Ha d'incloure funcionalitats per crear una nova base de dades i taules dins de MariaDB.

El sistema ha de gestionar la inserció, actualització i eliminació de documents a MariaDB.

|| El projecte ha d'establir una connexió amb MariaDB utilitzant PDO.

Ha d'incloure funcionalitats per crear una nova base de dades i taules dins de MariaDB.

El sistema ha de gestionar la inserció i eliminació de documents a MariaDB.

|| El projecte ha d'establir una connexió amb MariaDB utilitzant PDO.

Ha d'incloure funcionalitats per crear una nova base de dades i taules dins de MariaDB.
|-
| Integració de l'XML (10%)
|| Permet treballar amb imatges.

Permet la importació de fitxers XML i integrar les dades dins de la base de dades MariaDB.

Permet la creació de fitxers XML basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació XML i garantir documents XML ben formats.
|| Permet la importació de fitxers XML i integrar les dades dins de la base de dades MariaDB.

Permet la creació de fitxers XML basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació XML i garantir documents XML ben formats.
|| Permet la creació de fitxers XML basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació XML i garantir documents XML ben formats.
|| Permet la creació de fitxers XML amb ''arrays'' de PHP.

El sistema ha de gestionar la validació XML i garantir documents XML ben formats.
|-
| Integració del CSV (10%)
|| Permet treballar amb imatges.

Permet la importació de fitxers CSV i integrar les dades dins de la base de dades MariaDB.

Permet la creació de fitxers CSV basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació CSV i garantir documents CSV ben formats.
|| Permet la importació de fitxers CSV i integrar les dades dins de la base de dades MariaDB.

Permet la creació de fitxers CSV basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació CSV i garantir documents CSV ben formats.
|| Permet la creació de fitxers CSV basats en les dades emmagatzemades a la base de dades MariaDB.

El sistema ha de gestionar la validació CSV i garantir documents CSV ben formats.
|| Permet la creació de fitxers CSV amb ''arrays'' de PHP.

El sistema ha de gestionar la validació CSV i garantir documents CSV ben formats.
|-
| Disseny de la interfície d'usuari (10%) ||
Ha de ser capaç de mostrar imatges de les monedes.

El sistema ha de gestionar la validació de les dades introduïdes per l'usuari i garantir la integritat de les dades.

Ha de proporcionar retroacció i notificacions adequades a l'usuari.

La interfície gràfica ha de ser intuïtiva i fàcil d'usar, amb etiquetes clares, botons i camps d'entrada.
||
El sistema ha de gestionar la validació de les dades introduïdes per l'usuari i garantir la integritat de les dades.

Ha de proporcionar retroacció i notificacions adequades a l'usuari.

La interfície gràfica ha de ser intuïtiva i fàcil d'usar, amb etiquetes clares, botons i camps d'entrada.

||
Ha de proporcionar retroacció i notificacions adequades a l'usuari.

La interfície gràfica ha de ser intuïtiva i fàcil d'usar, amb etiquetes clares, botons i camps d'entrada.

||
La interfície gràfica ha de ser intuïtiva i fàcil d'usar, amb etiquetes clares, botons i camps d'entrada.

|-
| Extensió per a WordPress (16%)
||
És capaç d'introduir noves dades a la base de dades MariaDB o a un arxiu CSV o XML.

És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
|-
| Extensió per a Mediawiki (12%) ||
És capaç d'introduir noves dades a la base de dades MariaDB o a un arxiu CSV o XML.

És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
|-
| Extensió per a Joomla (12%) ||
És capaç d'introduir noves dades a la base de dades MariaDB o a un arxiu CSV o XML.

És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de mostrar les imatges de les monedes.

És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de filtrar les dades per criteris de cerca.

És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
||
És capaç de llegir la informació de la base de dades MariaDB o d'un arxiu CSV o XML.
|-
| Qualitat i Organització del Codi (10%)
||
El codi del projecte ha de tenir una estructura clara, modular i llegible. Aquesta és completa.

Ha de seguir les millors pràctiques per a les convencions de codificació de PHP.

El codi ha d'incloure comentaris i documentació quan sigui necessari.
||
El codi del projecte ha de tenir una estructura clara, modular i llegible. Aquesta és completa.

Ha de seguir les millors pràctiques per a les convencions de codificació de PHP.
||
El codi del projecte ha de tenir una estructura clara, modular i llegible. Aquesta és completa.
||
El codi del projecte ha de tenir una estructura clara, modular i llegible. Però és incompleta.
|-
| Presentació i Documentació (10%)
||
Ha de contenir una descripció clara i concisa del projecte i del seu propòsit.

Fa diagrames explicatius de planificació clara i concisa del projecte i del seu propòsit.

Ha de tenir un manual d'usuari en format ''wiki'' que expliqui com fer servir l'aplicació. La ''wiki'' ha de tenir un enllaç al manual en format pdf.

Ha d'incloure instruccions d'instal·lació, configuració i com resoldre les dependències necessàries.
||
Ha de contenir una descripció clara i concisa del projecte i del seu propòsit.

Fa diagrames explicatius de planificació clara i concisa del projecte i del seu propòsit.

Ha de tenir un manual d'usuari en format ''wiki'' que expliqui com fer servir l'aplicació. La ''wiki'' ha de tenir un enllaç al manual en format pdf.
||
Ha de contenir una descripció clara i concisa del projecte i del seu propòsit. Format pdf o ''wiki''.

Fa diagrames explicatius de planificació .
||
Ha de contenir una descripció clara i concisa del projecte i del seu propòsit. Format pdf o ''wiki''.
|}

Manual d'usuari de Gestió Monedes

2026-04-15T11:43:42Z

Admin: Afegir versió DOCX del manual de Gestió Monedes

__TOC__
= Manual d'usuari de Gestió Monedes =

'''Versió PDF del manual:''' [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari de Gestió Monedes (PDF)]

'''Versió DOCX del manual:''' [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.docx Manual d'usuari de Gestió Monedes (DOCX)]

'''Aplicació web:''' [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]

'''Documentació tècnica:''' [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]

== 1. Presentació del projecte ==

'''Gestió de Monedes''' és una aplicació web per administrar una col·lecció de monedes des del navegador. Permet crear registres nous, consultar-los, editar-los, eliminar-los, gestionar imatges i importar/exportar dades.

L'objectiu del projecte és oferir una eina clara, funcional i fàcil de desplegar per a entorns acadèmics o personals.

{| class="wikitable"
! Recurs
! Enllaç
! Finalitat
|-
| Aplicació
| [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]
| Ús diari de l'aplicació
|-
| Manual PDF
| [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari en PDF]
| Consulta i impressió
|-
| Manual DOCX
| [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.docx Manual d'usuari en DOCX]
| Edició o lliurament en format Word
|-
| Documentació tècnica
| [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]
| Instal·lació, arquitectura i dependències
|}

== 2. Navegació principal ==

La barra superior de l'aplicació inclou aquests accessos:

* '''Col·lecció'''
* '''Nova moneda'''
* '''Import/Export'''
* '''Documentació'''

Flux d'ús recomanat:

# Crear una moneda nova.
# Afegir-hi dades i, si cal, una imatge.
# Revisar la fitxa de detall.
# Aplicar filtres o ordenació quan el catàleg creix.
# Exportar les dades si es necessita una còpia de treball.

== 3. Crear una moneda ==

Per donar d'alta una moneda:

# Fes clic a '''Nova moneda'''.
# Omple els camps obligatoris:
#* '''Nom'''
#* '''País'''
#* '''Valor'''
#* '''Any d'emissió'''
# Omple la '''Descripció''' si vols afegir informació contextual.
# Puja una imatge si la vols associar al registre.
# Prem '''Crear moneda'''.

Quan el formulari és correcte, el sistema desa la moneda i torna al llistat.

== 4. Consultar el llistat i el detall ==

Des del llistat principal pots:

* veure totes les monedes en forma de targetes
* ordenar per nom, any o valor
* obrir la vista de detall
* editar registres
* eliminar registres

La vista de detall mostra:

* imatge principal
* valor destacat
* país o territori emissor
* any d'emissió
* nom complet
* descripció
* metadades del registre

== 5. Editar i eliminar ==

=== 5.1 Editar ===

Per editar una moneda:

# entra a la fitxa o fes clic a '''Editar'''
# modifica els camps necessaris
# conserva la imatge actual si no n'afegeixes una de nova
# marca l'opció d'eliminar imatge si vols esborrar la que hi ha
# prem '''Desar canvis'''

=== 5.2 Eliminar ===

Per eliminar una moneda:

# fes clic a '''Eliminar'''
# revisa el nom al quadre de confirmació
# confirma l'acció

L'eliminació és permanent i també elimina la imatge associada si existeix.

== 6. Cerca, filtres i ordenació ==

El panell de filtres permet cercar per:

* nom
* país
* any d'emissió
* valor mínim
* valor màxim

Els filtres es poden combinar. L'enllaç per mostrar totes les monedes permet tornar a l'estat general del catàleg.

També pots ordenar per:

* nom
* any
* valor

== 7. Gestió d'imatges ==

La pujada d'imatges admet:

* JPG o JPEG
* PNG
* GIF
* WebP

Característiques principals:

* selecció manual de fitxer
* arrossegar i deixar anar a la zona de pujada
* previsualització abans de desar
* eliminació automàtica del fitxer en esborrar el registre

== 8. Importació i exportació ==

Des de la pantalla '''Import/Export''' pots:

* exportar totes les monedes a XML
* exportar totes les monedes a CSV
* importar monedes des d'un XML vàlid
* importar monedes des d'un CSV amb capçalera correcta

=== 8.1 Exportar ===

L'exportació genera un fitxer descarregable directament des del navegador.

=== 8.2 Importar XML ===

Per importar XML:

# ves a '''Import/Export'''
# selecciona un fitxer XML amb l'estructura esperada
# prem '''Importar des de XML'''

=== 8.3 Importar CSV ===

Per importar CSV:

# prepara el fitxer amb la capçalera correcta
# selecciona'l al formulari
# prem '''Importar des de CSV'''

== 9. Bones pràctiques ==

Per treballar millor amb l'aplicació:

* escriu noms i països de forma coherent
* revisa els valors numèrics abans de desar
* fes exportacions periòdiques si el catàleg és important
* revisa els missatges d'èxit o error després de cada acció

== 10. Incidències habituals ==

Algunes comprovacions útils:

* si una imatge no puja, revisa format i mida
* si una importació falla, comprova l'estructura del fitxer
* si no trobes un registre, elimina filtres actius
* si una dada és incorrecta, entra a editar i corregeix-la

== 11. Enllaços útils ==

* [https://fmehmood.cat/gestio_monedes/ Aplicació Gestió de Monedes]
* [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació tècnica del projecte]
* [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari en PDF]
* [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.docx Manual d'usuari en DOCX]

Página principal

2026-04-15T11:43:42Z

Admin: Afegir enllaç DOCX del manual a la portada

Manual d'usuari de Gestió Monedes

2026-04-15T11:25:38Z

Admin: Millorar i ampliar el manual d'usuari de Gestió Monedes

Página principal

2026-04-15T11:19:00Z

Admin: Indentar els enllaços del manual sota Gestió Monedes

Manual d'usuari de Gestió Monedes

2026-04-14T22:16:41Z

Admin: Crear manual d'usuari de Gestió Monedes amb enllaç al PDF

= Manual d'usuari de Gestió Monedes =

'''Versió PDF del manual:''' [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari de Gestió Monedes (PDF)]

'''Aplicació:''' [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]

== Finalitat del projecte ==

'''Gestió de Monedes''' és una aplicació web per administrar una col·lecció de monedes des del navegador. Permet donar d'alta nous registres, consultar-los, editar-los, eliminar-los, gestionar imatges i importar/exportar dades en XML i CSV.

El propòsit del projecte és oferir una eina clara i funcional per a entorns acadèmics o personals, mantenint una base tècnica senzilla de desplegar amb PHP i MariaDB.

== Accés i navegació ==

La barra de navegació principal inclou:

* '''Col·lecció'''
* '''Nova moneda'''
* '''Import/Export'''
* '''Documentació'''

Flux d'ús recomanat:

# Crear una moneda nova.
# Afegir-hi una imatge si cal.
# Revisar la fitxa de detall.
# Aplicar filtres i ordenacions.
# Exportar les dades quan es vulgui compartir o guardar una còpia de treball.

== Crear una moneda ==

Per donar d'alta una moneda:

* fes clic a '''Nova moneda'''
* omple '''nom''', '''país''', '''valor''' i '''any d'emissió'''
* completa la '''descripció''' si és necessari
* selecciona una imatge si la vols associar al registre
* prem '''Crear moneda'''

== Consultar, editar i eliminar ==

Des del llistat principal pots:

* veure les targetes de totes les monedes
* ordenar per nom, any o valor
* entrar al detall d'una moneda
* editar registres existents
* eliminar registres amb confirmació prèvia

A la vista de detall trobaràs la informació completa del registre i les metadades de creació i actualització.

== Cerca i filtres ==

Els filtres disponibles són:

* nom
* país
* any d'emissió
* valor mínim
* valor màxim

Els filtres es poden combinar. Si vols tornar a veure tot el catàleg, utilitza l'enllaç per mostrar totes les monedes.

== Gestió d'imatges ==

Característiques principals:

* admet JPG, JPEG, PNG, GIF i WebP
* permet arrossegar fitxers a la zona de pujada
* mostra una previsualització abans de desar
* elimina la imatge del servidor quan s'elimina la moneda

== Importació i exportació ==

Des de la pantalla '''Import/Export''' pots:

* exportar totes les monedes a XML
* exportar totes les monedes a CSV
* importar monedes des d'un XML vàlid
* importar monedes des d'un CSV amb la capçalera correcta

== Bones pràctiques ==

* mantén noms i països escrits de forma coherent
* revisa els valors numèrics abans de desar
* exporta periòdicament el catàleg si treballes amb dades importants
* revisa els missatges d'error quan una importació o una pujada no funcionen

== Enllaços útils ==

* [https://fmehmood.cat/gestio_monedes/ Aplicació Gestió de Monedes]
* [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació tècnica del projecte]
* [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari en PDF]

Página principal

2026-04-14T22:16:35Z

Admin: Afegir manual wiki i PDF de Gestió Monedes a la portada

Página principal

2026-04-14T22:02:08Z

Admin: Afegir secció Projecte PJ7 a la portada

Página principal

2026-04-14T22:00:18Z

Admin: Afegir enllaç al projecte Gestió Monedes a Projectes SEM7

Página principal

2026-04-14T21:43:16Z

Admin: Ajustar altura del 7 a -0.19em en SEM7

Página principal

2026-04-14T21:42:41Z

Admin: Ajustar ligeramente la altura del 7 en SEM7

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==

Página principal

2026-04-14T21:41:46Z

Admin: Pujar encara més el 7 de SEM7 a la portada

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==

Página principal

2026-04-14T21:41:08Z

Admin: Ajustar més amunt el 7 de SEM7 a la portada

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==

Página principal

2026-04-14T21:40:41Z

Admin: Ajustar alineació visual del 7 a SEM7

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==

Página principal

2026-04-14T21:40:03Z

Admin: Ajustar capitalització dels títols de la portada

== Activitats SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== Projectes SEM7 ==

Página principal

2026-04-14T21:39:08Z

Admin: Renombrar secció i afegir PROJECTES SEM7 a la portada

== ACTIVITATS SEM7 ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

== PROJECTES SEM7 ==

Página principal

2026-04-14T21:37:24Z

Admin: Corregir textos dels enllaços PDF de la portada

== Enlaces de utilidad ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació d'un entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament d'extensions per a WordPress]

Página principal

2026-04-14T21:37:10Z

Admin: Afegir enllaços a les pràctiques PDF a la portada

== Enlaces de utilidad ==
* [https://fmehmood.cat/activitats/A1_SM7_Faiez_Mehmood.pdf Pràctica 1. Instal·lació dun entorn LAMP]
* [https://fmehmood.cat/activitats/A6_SM7_Faiez_Mehmood.pdf Pràctica 6. PHP+MariaDB emprant dockers]
* [https://fmehmood.cat/activitats/A7_SM7_Faiez_Mehmood.pdf Pràctica 7. WordPress amb docker y WordPress amb Compose]
* [https://fmehmood.cat/activitats/A8_SM7_Faiez_Mehmood.pdf Pràctica 8. desenvolupament dextensions per a WordPress]

Página principal

2026-04-14T20:54:34Z

Admin: Limpiar texto introductorio de la portada

== Enlaces de utilidad ==

Página principal

2026-04-14T20:53:41Z

Admin: Vaciar enlaces de utilidad de la portada

Página principal

2026-04-14T20:48:49Z

Admin: Actualizar enlaces de utilidad en la portada

MediaWiki se ha instalado.

Consulta la [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents guía] para obtener información sobre el uso del software wiki.

== Enlaces de utilidad ==
* [https://fmehmood.cat/index.html.backup Página original del sitio (index.html.backup)]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Lista de ajustes de configuración]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ Preguntas frecuentes sobre MediaWiki]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ Lista de correo de anuncios de publicación de MediaWiki]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Traducir MediaWiki a tu idioma]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Aprende a combatir el spam en tu wiki]