Com crear el formulari · Resum Comanda CryptPad

1. Exportació del formulari

Un cop tancat el formulari a CryptPad, cal exportar-lo en format JSON. El fitxer exportat ha de tenir exactament dues claus de primer nivell:

{
  "questions": { ... },
  "responses": [ ... ]
}

questions: objecte on cada clau és q1, q2, q3… i el valor és el text de la pregunta.
responses: llista de respostes, on cada resposta és un objecte amb les mateixes claus (q1, q2…) més _time i _name.

Les claus han de ser numèriques i ordenades (q1, q2… q10, q11…). L'ordre és important per a la detecció del patró de selector d'unitats (veure la secció 4).

2. Camps de metadades

Algunes de les preguntes (normalment q1 a q6) són camps de metadades estàndard, reconeguts per comparació (insensible a majúscules):

Clau	Text de la pregunta
`q1`	Adreça electrònica
`q2`	Nom Complet
`q3`	Algun comentari? o indicació o…
`q4`	PAGAMENT
`q5`	PUNT DE RECOLLIDA
`q6`	UN ALTRE PUNT DE RECOLLIDA

Qualsevol camp que contingui el text "Punt de recollida" (sense distingir majúscules) també s'exclou automàticament dels resums de producte.

Es recomana no editar aquests camps. Si canvieu el text, l'eina potser no els reconeixerà com a metadades i els tractarà com a productes. Proveu el formulari amb unes quantes respostes per assegurar-vos que tot funciona.

2.1 El camp «Nom Complet» és obligatori

El camp amb l'etiqueta "nom complet" és l'únic camp obligatori del formulari. L'eina l'utilitza per identificar cada participant al resum per persona i per a la impressió.

Si aquest camp no existeix o té un text diferent, totes les comandes apareixeran sota el nom «Anònim» i no es podran assignar als participants.

3. Camps de producte

Els camps que no coincideixen amb les metadades de l'apartat anterior són camps de producte. El text de la pregunta segueix aquesta convenció:

NOM DEL PRODUCTE. Descripció lliure amb paraules clau d'unitat.

Tot allò abans del primer punt (.) és el nom del producte (el que apareix als resums).
Tot allò després del primer punt és la descripció, que serveix per detectar el tipus d'unitat.

3.1 Detecció del tipus d'unitat

L'eina llegeix la descripció per determinar com sumar les quantitats:

Paraules clau a la descripció	Tipus d'unitat
`safata`, `paquet`, `manat`, `en unitats`, `en unitat`	Unitats
`en kg`	Quilograms
(cap de les anteriors)	Indeterminat — compta ocurrències

La detecció és insensible a majúscules. El tipus kg també s'activa si alguna resposta conté un decimal (per exemple, "1.5" o "0,5").

3.2 Exemples de textos de pregunta vàlids

XIITAKE. Quantes safates? Lentinula edodes. De l'Ivan Martínez (Castellserà) - 3,50€/safata 200 gr

Nom: XIITAKE
Tipus: unitat (conté "safates")

FAVES. Nostres (Castellserà) - 2,80 €/kg - Quantitat d'exemple (en kg): 0,5

Nom: FAVES
Tipus: kg (conté "en kg")

4. Patró de selector d'unitats (kg o unitats)

Per a productes que es poden demanar tant per quilograms com per unitats, cal crear tres preguntes consecutives en aquest ordre:

Posició	Rol	Contingut
Primera	Selector	Pregunta amb opcions de resposta (text exacte): veure els valors vàlids a continuació
Segona	Variant kg	Descripció ha de contenir `"en kg"` o `"quants kg en vols"`
Tercera	Variant unitats	Descripció ha de contenir `"en unitats"` o `"quantes unitats en vols"`

Exemple (q10, q11, q12)

q10: "Poma golden. Pomona-fruits eco (Ivars d'Urgell)."
q11: "Poma golden. Pomona-fruits eco (Ivars d'Urgell) - 2,60€/kg. En kg."
q12: "Poma golden. Pomona-fruits eco (Ivars d'Urgell) - 2,60€/kg. En unitats."

Valors de resposta del selector

Les respostes al camp selector han de ser exactament (sense distingir majúscules) un d'aquests sis valors:

Variants de kg:

Per kg
Per kgs
En kg

Variants d'unitats:

Per unitat
Per unitats
En unitats

Si el formulari ofereix altres opcions o el text no coincideix exactament, l'eina no reconeixerà el patró i no processarà correctament les quantitats.

Com funciona

El camp selector no apareix als resums; és invisible per a l'usuari del resum.
Segons el que hagi triat el participant, l'eina llegeix la quantitat del camp corresponent (kg o unitats) i ignora l'altre.
Al resum apareix el nom simplificat: p. ex. Poma golden. En kg o Poma golden. En unitats.

5. Respostes buides i valors especials

Un camp buit ("") equival a "no n'ha demanat" i s'exclou del resum.
Si una resposta val "Altres" (exactament, sensible a majúscules) i existeix un camp de quantitat associat (el camp immediatament següent), l'eina llegirà la quantitat d'aquell camp addicional.

6. Càlcul de totals per producte

L'eina suma les quantitats de cada producte:

Si totes les respostes d'un producte són numèriques → les suma (accepta tant . com , com a separador decimal).
Si alguna resposta no és numèrica → compta el nombre d'ocurrències.

7. Resum de bones pràctiques

Manteniu exactes els textos dels sis camps de metadades (q1–q6).
Useu sempre claus numèriques: q1, q2, …, q10, q11…
Separeu nom i descripció amb un punt en els camps de producte.
Incloeu paraules clau d'unitat a la descripció: safata, paquet, manat, en kg, en unitats.
Per al patró selector, poseu les tres preguntes consecutivament i assegureu-vos que les opcions del selector siguen exactament Per kg, Per kgs, En kg, Per unitat, Per unitats o En unitats. Per a la variant kg useu "en kg" o "quants kg en vols" a la descripció; per a la variant unitats, "en unitats" o "quantes unitats en vols".
No modifiqueu l'estructura del JSON exportat de CryptPad.