Ir al contenido

Diferencia entre revisiones de «Manual d'usuari de Gestió Monedes»

De Wiki Local
← Edición anteriorEdición siguiente →
Contenido eliminado Contenido añadido
VisualWikitexto
Afegir versió DOCX del manual de Gestió Monedes
Ampliació del manual: arquitectura MVC, instal·lació, dependències i integracions CMS
Línea 3: Línea 3:


'''Versió PDF del manual:''' [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.pdf Manual d'usuari de Gestió Monedes (PDF)]
'''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]
'''Aplicació web:''' [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]
Línea 12: Línea 10:
== 1. Presentació 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.
'''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.
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"
{| class="wikitable"
Línea 21: Línea 19:
! Finalitat
! Finalitat
|-
|-
| Aplicació
| Aplicació web
| [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]
| [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]
| Ús diari de l'aplicació
| Ús diari de l'aplicació
Línea 28: Línea 26:
| [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.pdf Manual d'usuari en PDF]
| Consulta i impressió
| 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
| Documentació tècnica
| [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]
| [https://fmehmood.cat/gestio_monedes/documentacio.php Documentació del projecte]
| Instal·lació, arquitectura i dependències
| 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. Navegació principal ==
== 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:
La barra superior de l'aplicació inclou aquests accessos:


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


Flux d'ús recomanat:
Flux d'ús recomanat:
Línea 55: Línea 140:
# Exportar les dades si es necessita una còpia de treball.
# Exportar les dades si es necessita una còpia de treball.


== 3. Crear una moneda ==
== 4. Crear una moneda ==


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


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


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


Des del llistat principal pots:
Des del llistat principal pots:


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


La vista de detall mostra:
La vista de detall mostra:
Línea 89: Línea 173:
* nom complet
* nom complet
* descripció
* descripció
* metadades del registre
* metadades del registre (identificador, dates de creació i modificació)


== 5. Editar i eliminar ==
== 6. Editar i eliminar ==


=== 5.1 Editar ===
=== 6.1 Editar ===


Per editar una moneda:
Per editar una moneda:


# entra a la fitxa o fes clic a '''Editar'''
# Entra a la fitxa o fes clic a '''Editar''' des del llistat.
# modifica els camps necessaris
# Modifica els camps necessaris.
# Si no afegeixes una nova imatge, la imatge actual es conserva.
# conserva la imatge actual si no n'afegeixes una de nova
# marca l'opció d'eliminar imatge si vols esborrar la que hi ha
# Si vols esborrar la imatge actual, marca l'opció corresponent.
# prem '''Desar canvis'''
# Prem '''Desar canvis'''.


=== 5.2 Eliminar ===
=== 6.2 Eliminar ===


Per eliminar una moneda:
Per eliminar una moneda:


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


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


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


El panell de filtres permet cercar per:
El panell de filtres permet cercar per:


{| class="wikitable"
* nom
! Filtre
* país
! Descripció
* any d'emissió
! Exemple
* valor mínim
|-
* valor màxim
| Nom

| Cerca per coincidència parcial
Els filtres es poden combinar. L'enllaç per mostrar totes les monedes permet tornar a l'estat general del catàleg.
| <code>Euro</code> → troba «Euro», «Euronova»…

|-
També pots ordenar per:
| 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.
* nom
* any
* valor


== 7. Gestió d'imatges ==
== 8. Gestió d'imatges ==


La pujada d'imatges admet:
La pujada d'imatges admet:
Línea 142: Línea 240:
Característiques principals:
Característiques principals:


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


== 8. Importació i exportació ==
== 9. Importació i exportació ==


Des de la pantalla '''Import/Export''' pots:
Des de la pantalla '''Import/Export''' pots:
Línea 156: Línea 255:
* importar monedes des d'un CSV amb capçalera correcta
* importar monedes des d'un CSV amb capçalera correcta


=== 8.1 Exportar ===
=== 9.1 Exportar ===


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


=== 8.2 Importar XML ===
=== 9.2 Importar XML ===


# Ves a '''Import/Export'''.
Per importar XML:
# 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.
# ves a '''Import/Export'''
# selecciona un fitxer XML amb l'estructura esperada
# prem '''Importar des de XML'''


=== 8.3 Importar CSV ===
=== 9.3 Importar CSV ===


# Prepara el fitxer amb la capçalera: <code>nom;país;valor;any emissió;descripció</code>
Per importar CSV:
# 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.
# prepara el fitxer amb la capçalera correcta
# selecciona'l al formulari
# prem '''Importar des de CSV'''


== 9. Bones pràctiques ==
== 10. Bones pràctiques ==


Per treballar millor amb l'aplicació:
Per treballar millor amb l'aplicació:


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


== 10. Incidències habituals ==
== 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 ===
Algunes comprovacions útils:


* '''Nom:''' com_gestiomonedes
* si una imatge no puja, revisa format i mida
* '''Frontend:''' [https://fmehmood.cat/joomla/index.php/gestio-monedes-joomla Gestió Monedes Joomla]
* si una importació falla, comprova l'estructura del fitxer
* '''Funcions:''' frontend públic amb catàleg i filtres; backend d'administració per configurar la font de dades i inserir monedes.
* si no trobes un registre, elimina filtres actius
* '''Fonts de dades:''' MariaDB, CSV, XML
* si una dada és incorrecta, entra a editar i corregeix-la


== 11. Enllaços útils ==
== 15. Enllaços útils ==


* [https://fmehmood.cat/gestio_monedes/ Aplicació Gestió de Monedes]
* [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/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.pdf Manual d'usuari en PDF]
* [https://fmehmood.cat/gestio_monedes/docs/manual_usuari_gestio_monedes.docx Manual d'usuari en DOCX]
* [https://fmehmood.cat/mediawiki/index.php/Special:GestioMonedes Extensió MediaWiki — Special:GestioMonedes]
* [https://fmehmood.cat/joomla/index.php/gestio-monedes-joomla Component Joomla — Frontend]

Revisión del 22:37 15 abr 2026

Manual d'usuari de Gestió Monedes

Versió PDF del manual: Manual d'usuari de Gestió Monedes (PDF)

Aplicació web: Gestió de Monedes

Documentació tècnica: 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.

Recurs Enllaç Finalitat
Aplicació web Gestió de Monedes Ús diari de l'aplicació
Manual PDF Manual d'usuari en PDF Consulta i impressió
Documentació tècnica Documentació del projecte Instal·lació, arquitectura i dependències
Extensió MediaWiki 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:

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

Esquema de la base de dades

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

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

4. Crear una moneda

Per donar d'alta una moneda:

  1. Fes clic a Nova moneda.
  2. 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)
  3. Omple la Descripció si vols afegir informació contextual.
  4. Puja una imatge si la vols associar al registre.
  5. 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:

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

6.2 Eliminar

Per eliminar una moneda:

  1. Fes clic a Eliminar (botó vermell).
  2. Revisa el nom al quadre de confirmació.
  3. 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:

Filtre Descripció Exemple
Nom Cerca per coincidència parcial Euro → troba «Euro», «Euronova»…
País Cerca per coincidència parcial Esp → troba «Espanya», «Esparta»…
Any d'emissió Any exacte 1999 o -264
Valor mínim Valor ≥ al valor indicat 0.50
Valor màxim Valor ≤ al valor indicat 100

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 monedes_YYYYMMDD_HHMMSS.xml o .csv.

9.2 Importar XML

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

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

9.3 Importar CSV

  1. Prepara el fitxer amb la capçalera: nom;país;valor;any emissió;descripció
  2. Selecciona'l al formulari.
  3. 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

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 documentació tècnica del projecte.

12.1 Requisits del sistema

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: 

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

Pas 2 — Copiar el projecte i preparar els permisos: 

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/

Pas 3 — Configurar les credencials:

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

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

Dependència Paquet Verificació Si falta
Servidor web apache2 o nginx systemctl status apache2 sudo apt install apache2 -y
Motor PHP php + libapache2-mod-php php -v sudo apt install php libapache2-mod-php -y
PDO MySQL php-mysql grep pdo_mysql sudo apt install php-mysql -y
Multibyte strings php-mbstring grep mbstring sudo apt install php-mbstring -y
XML php-xml grep simplexml sudo apt install php-xml -y
Fileinfo php-fileinfo grep fileinfo sudo apt install php-fileinfo -y
MariaDB mariadb-server systemctl status mariadb sudo apt install mariadb-server -y

13.2 Resolució de problemes habituals

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

Obtenido de «https://fmehmood.cat/mediawiki/index.php?title=Manual_d%27usuari_de_Gestió_Monedes&oldid=28»