Diferencia entre revisiones de «Manual d'usuari de Gestió Monedes»
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 |
# Afegir-hi dades i, si cal, una imatge. |
||
# Revisar la fitxa de detall. |
# Revisar la fitxa de detall. |
||
# Aplicar filtres |
# Aplicar filtres o ordenació quan el catàleg creix. |
||
# Exportar les dades |
# 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'''. |
|||
# 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 |
|||
* |
#* '''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 |
* 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 |
* editar registres |
||
* eliminar registres |
* 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. |
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 |
|||
* |
* arrossegar i deixar anar a la zona de pujada |
||
* |
* 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 |
* importar monedes des d'un CSV amb capçalera correcta |
||
== |
=== 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' |
* 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 |
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