Ir al contenido

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

De Wiki Local
Contenido eliminado Contenido añadido
Crear manual d'usuari de Gestió Monedes amb enllaç al PDF
 
Millorar i ampliar el manual d'usuari de Gestió Monedes
Línea 1: Línea 1:
__TOC__
= Manual d'usuari de Gestió Monedes =
= 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ó 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]
'''Aplicació web:''' [https://fmehmood.cat/gestio_monedes/ Gestió de Monedes]


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


== 1. Presentació 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.


'''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.
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.


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


{| class="wikitable"
La barra de navegació principal inclou:
! 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ó
|-
| 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ó'''
* '''Col·lecció'''
Línea 23: Línea 44:


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


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


Per donar d'alta una moneda:
Per donar d'alta una moneda:


* fes clic a '''Nova moneda'''
# Fes clic a '''Nova moneda'''.
# Omple els camps obligatoris:
* omple '''nom''', '''país''', '''valor''' i '''any d'emissió'''
#* '''Nom'''
* completa la '''descripció''' si és necessari
#* '''País'''
* selecciona una imatge si la vols associar al registre
* prem '''Crear moneda'''
#* '''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.
== Consultar, editar i eliminar ==

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


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


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


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


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


== 5. Editar i eliminar ==
Els filtres disponibles són:

=== 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
* nom
Línea 60: Línea 117:
* valor màxim
* 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.
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:
== Gestió d'imatges ==

* nom
* any
* valor

== 7. Gestió d'imatges ==

La pujada d'imatges admet:

* JPG o JPEG
* PNG
* GIF
* WebP


Característiques principals:
Característiques principals:


* selecció manual de fitxer
* admet JPG, JPEG, PNG, GIF i WebP
* permet arrossegar fitxers a la zona de pujada
* arrossegar i deixar anar a la zona de pujada
* mostra una previsualització abans de desar
* previsualització abans de desar
* eliminació automàtica del fitxer en esborrar el registre
* elimina la imatge del servidor quan s'elimina la moneda


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


Des de la pantalla '''Import/Export''' pots:
Des de la pantalla '''Import/Export''' pots:
Línea 78: Línea 148:
* exportar totes les monedes a CSV
* exportar totes les monedes a CSV
* importar monedes des d'un XML vàlid
* importar monedes des d'un XML vàlid
* importar monedes des d'un CSV amb la capçalera correcta
* importar monedes des d'un CSV amb capçalera correcta


== Bones pràctiques ==
=== 8.1 Exportar ===


L'exportació genera un fitxer descarregable directament des del navegador.
* mantén noms i països escrits de forma coherent

=== 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
* revisa els valors numèrics abans de desar
* fes exportacions periòdiques si el catàleg és important
* exporta periòdicament el catàleg si treballes amb dades importants
* revisa els missatges d'error quan una importació o una pujada no funcionen
* 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


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


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

Revisión del 13:25 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 é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.

Recurs Enllaç Finalitat
Aplicació 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

2. Navegació principal

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

  • Col·lecció
  • Nova moneda
  • Import/Export
  • Documentació

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.

3. Crear una moneda

Per donar d'alta una moneda:

  1. Fes clic a Nova moneda.
  2. Omple els camps obligatoris:
    • Nom
    • País
    • Valor
    • Any d'emissió
  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 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:

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

5.2 Eliminar

Per eliminar una moneda:

  1. fes clic a Eliminar
  2. revisa el nom al quadre de confirmació
  3. 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:

  1. ves a Import/Export
  2. selecciona un fitxer XML amb l'estructura esperada
  3. prem Importar des de XML

8.3 Importar CSV

Per importar CSV:

  1. prepara el fitxer amb la capçalera correcta
  2. selecciona'l al formulari
  3. 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