Editando Manual d'usuari de Gestió Monedes (sección)

== 14. Arquitectura i tecnologies del projecte ==

'''Gestió de Monedes''' (versió 1.1.2) és una aplicació web PHP pura, sense frameworks externs. S'executa sobre Apache o Nginx amb MariaDB i segueix el patró Model-Vista-Controlador (MVC):

* '''Controladors''' — <code>MonedaController.php</code> i <code>ImportExportController.php</code> gestionen les peticions i coordinen model i vista.
* '''Models''' — <code>Moneda.php</code> conté tota la lògica CRUD i de filtres; <code>GestorImatge.php</code> gestiona la pujada, validació i eliminació d'imatges.
* '''Vistes''' — les plantilles PHP a <code>views/</code> generen el HTML que rep el navegador.
* '''Enrutador''' — <code>index.php</code> rep totes les peticions i les distribueix pel paràmetre <code>?accio=</code>.
=== Esquema de la base de dades ===

La base de dades consta d'una taula <code>monedes</code> amb els camps:

* <code>id</code> — clau primària autoincremental
* <code>nom</code> — nom oficial de la moneda (VARCHAR 150)
* <code>pais</code> — país o territori emissor (VARCHAR 100)
* <code>valor</code> — valor facial o numismàtic (DECIMAL 15,4)
* <code>any_emissio</code> — any d'emissió, negatiu per a.C. (SMALLINT)
* <code>descripcio</code> — descripció lliure (TEXT, opcional)
* <code>imatge</code> — nom del fitxer d'imatge (VARCHAR 255, opcional)
* <code>creat_el</code> — data de creació automàtica (DATETIME)
* <code>actualitzat</code> — data d'última modificació (DATETIME)
=== Integracions CMS opcionals ===

El projecte inclou tres integracions per a sistemes de gestió de continguts:

* '''Plugin WordPress''' — shortcode <code>[gestio_monedes_llistat]</code> que mostra el catàleg al frontend amb diagnòstic de fonts, selector de font, ordenació, límit visible i filtre específic d'imatges; panell d'administració per inserir i gestionar monedes.
* '''Extensió MediaWiki''' — pàgina especial <code>Especial:GestioMonedes</code> que permet consultar, filtrar i inserir monedes directament des de la wiki, amb diagnòstic de fonts, ordenació, límit visible, filtre específic d'imatges i targetes de resultat compactes.
* '''Component Joomla''' — <code>com_gestiomonedes</code> amb frontend públic i backend d'administració integrats al CMS.
Les tres integracions llegeixen i escriuen des de MariaDB, CSV i XML, compartint la mateixa configuració privada del servidor.

En el cas de MediaWiki, la pàgina especial s'ha pensat com una entrada ràpida al catàleg: a la part superior es mostra la font activa i un resum del conjunt de dades, a continuació apareix un diagnòstic visual de MariaDB, CSV i XML, al centre hi ha el formulari de consulta i d'inserció, i a la part inferior es mostren les monedes en forma de targetes llegibles amb imatge, valor, país, any, descripció i darrera actualització.