Mòdul 0 — Quadre de comandament (Consola principal)

Per a qui: propietari, operador

Fitxers relacionats: menuclient.php, views/menuclient.view.php, includes/client_init.php

Què és la consola?

Quan inicies sessió com a propietari del negoci, la primera pantalla que veus és la consola principal (/menuclient.php). És el centre de control: des d'aquí veus l'estat actual de les comandes, accedeixes al catàleg de productes i obres totes les eines de configuració del negoci.

📸 PENDENT: img/00con-01-consola-general.png

Què cal capturar: Vista general de /menuclient.php amb el navbar superior, l'alerta de mode proves (si aplica), les targetes d'estadístiques i el grid de productes a sota. Zoom 90% per veure tot.

Estadístiques de la part superior

A la part superior de la consola hi ha 3 targetes ràpides amb les xifres més importants del dia:

Si una targeta està en vermell, indica que hi ha alguna acció pendent.

Barra superior — Accés ràpid

Grid de productes

Sota les targetes apareix el grid de tots els productes del negoci. Cada producte mostra:

• Imatge del producte (o imatge genèrica si no n'hi ha)
• Nom, format de venda i preu
• Etiquetes d'al·lèrgens (si en té)
• Stock del dia (si el negoci té gestió d'estocs activada)
• Botons d'acció ràpida: editar, duplicar, baixa

Per crear un producte nou, fes clic al botó Nou producte (rodó, vermell) a la barra d'eines superior del grid. En mode proves el botó es desactiva quan arribes a 10 productes.

📸 PENDENT: img/00con-02-grid-productes.png

Què cal capturar: El grid de productes amb 6-8 articles visibles, mostrant les imatges, preus, etiquetes d'al·lèrgens i botons d'acció.

Canvi d'idioma del catàleg

Si el negoci té idiomes addicionals habilitats (català, anglès, francès), apareix un selector d'idioma a la cantonada superior dreta del navbar. Canviar l'idioma:

• Recarrega la consola amb el catàleg traduït (els camps multilingües nombre1/2/3/4 mostren el text de l'idioma triat).
• Es desa la preferència a la sessió.

⚠️ Si un producte no té traducció a l'idioma actiu, es mostra el text de l'idioma per defecte (castellà).

Alerta de mode proves

Si el teu compte està en proves, just sota el navbar veuràs un avís blau amb:

• Data de caducitat del compte
• Dies restants
• Un botó × per amagar l'avís (només per a la sessió actual)

També apareix un botó «Fes una comanda de proves» al navbar que permet simular una comanda real des del primer minut.

📸 PENDENT: img/00con-03-mode-proves.png

Què cal capturar: Consola d'un compte en proves amb l'alerta blava visible i el botó "Fes una comanda de proves" al navbar.

Accions ràpides recomanades

Quan acabes de donar-te d'alta, els 5 primers passos recomanats són:

1. Fitxa del negoci — completar dades, logo, horaris d'obertura. → Mòdul 1
2. Catàleg — substituir els 5 productes de prova pels reals. → Mòdul 2
3. Calendari — verificar festius i horaris especials. → Mòdul 4
4. SMTP — configurar el teu correu per enviar tickets als clients. → Mòdul 1
5. Provar una comanda — clica el botó "Fes una comanda de proves" per veure el flux complet.

Mòdul 1 — Configuració del negoci

Per a qui: propietari del negoci

Fitxers relacionats: client/fitxa_client.php, client/smtp.php, client/canvi_password.php

Fitxa del negoci

Accés: Navbar → Fitxers → Fitxa del negoci (/client/fitxa_client.php)

A la fitxa del negoci hi ha totes les dades que el sistema necessita per fer funcionar la teva web pública de comandes: nom, contacte, horaris, tipus de servei, idiomes, etc.

La fitxa està organitzada en seccions desplegables (clica el títol per obrir/tancar):

📸 PENDENT: img/01cfg-01-fitxa-general.png

Què cal capturar: Capçalera de la fitxa del negoci amb les primeres seccions desplegades (dades del negoci + sector/activitat/especialitat).

Camps importants a omplir abans d'obrir la web

1. Dades de contacte — nom comercial, telèfon, email, adreça i població.
2. Tipus de servei — sense això el sistema no sap si oferir comandes Take Away o només reserves.
3. Horaris d'obertura — la web pública filtra les hores disponibles per a comandes a partir d'aquí.
4. Logo — millora la imatge de marca a tickets i correus.

⚠️ El camp URL (nombreenurl) és el slug que forma part de la URL pública: https://{domini}/comandes/{slug}.php. No el canviïs si ja tens clients que tenen aquesta URL guardada.

Comportament dels camps multilingües

Tots els camps de text llarg (nom, descripció, eslògans…) tenen 4 versions: castellà, català, anglès, francès. Pots traduir-les manualment des de la mateixa fitxa, només si tens activat l'idioma corresponent.

Configuració SMTP (correu electrònic)

Accés: Navbar → Configuració → Configuració SMTP (/client/smtp.php)

El sistema envia correus automàticament als clients per cada comanda (ticket de petició, confirmació, observacions…). Cal configurar el teu propi servidor SMTP perquè els correus surtin amb el teu domini i no acabin a la safata de spam.

Camps a omplir

📸 PENDENT: img/01cfg-02-smtp-form.png

Què cal capturar: Formulari de /client/smtp.php amb els camps visibles.

Provar la configuració

A la mateixa pàgina hi ha un botó «Enviar correu de prova». Si arriba correctament, la configuració és correcta. Si no:

• Comprova que la contrasenya sigui correcta (si fas servir Gmail, has de generar una App Password des dels paràmetres de la teva compta de Google).
• Comprova que el port i el tipus de xifrat coincideixin amb la documentació del teu proveïdor SMTP.
• Algunes companyies bloquegen el port 25; usa 465 (SSL) o 587 (TLS).

Si no es pot configurar SMTP propi

El sistema utilitza com a fallback el SMTP de l'administrador (el de la plataforma cliencarrego). Funciona, però els correus surten amb el remitent de la plataforma i poden acabar a spam.

Canvi de contrasenya

Accés: Navbar → Fitxers → Canvi de contrasenya (/client/canvi_password.php)

Et permet canviar la contrasenya d'accés a la consola.

Com fer-ho

1. Introdueix la contrasenya actual.
2. Introdueix la nova contrasenya (mínim 6 caràcters).
3. Repeteix la nova contrasenya per confirmar.
4. Clica Desar.

Si tot és correcte, et tornen a redirigir a la consola amb un missatge verd d'èxit.

📸 PENDENT: img/01cfg-03-canvi-password.png

Què cal capturar: Pàgina /client/canvi_password.php amb el formulari de 3 camps i el botó "Desar".

Casos especials

• ⚠️ Si oblides la contrasenya, des de /login.php clica el link "He oblidat la contrasenya" per rebre un correu amb un link de reset.
• ⚠️ Si has duplicat clients per a múltiples locals, cada local té la seva pròpia contrasenya independent. Pots assignar la mateixa per a tots o diferents.

Activar/Desactivar la web pública

Accés: Navbar → Configuració → Activar/Desactivar web

Si necessites tancar temporalment la web pública (per vacances, manteniment…), aquesta opció bloqueja l'accés dels clients. Quan està desactivada:

• La URL pública mostra un missatge "Web temporalment no disponible"
• Cap client pot fer una comanda
• Tu segueixes podent entrar a la consola

Tornar-la a activar és immediat.

Activar/Desactivar comandes web

Accés: Navbar → Configuració → Activar/Desactivar comandes web

Permet mantenir oberta la web pública (la gent pot veure la carta) però sense permetre fer comandes. Útil si vols mostrar el menú sense rebre encàrrecs en aquell moment.

Quan està desactivat:

• A la web pública apareix el missatge "Comandes desactivades temporalment"
• El navbar de la consola mostra l'opció "Comandes no actives" en gris
• Els clients no poden iniciar el flux de comanda

Mòdul 2 — Catàleg de productes

Per a qui: propietari, operador

Fitxers relacionats: menuclient.php, client/producte.php

Prerequisit: famílies, subfamílies i tipus de producte han d'existir (→ Mòdul 10)

Llista de productes (consola)

Accés: Navbar → Fitxers → Catàleg o directament a la consola (/menuclient.php)

El grid de productes a la consola mostra tots els productes del negoci. Cada targeta inclou:

• Imatge del producte (o "sense imatge" si no se n'ha pujat)
• Nom (en l'idioma actiu) i descripció breu
• Format de venda (kg, unitats, gramatges…) i preu
• Etiquetes d'al·lèrgens (icones de fruits secs, gluten, lactosa, etc.)
• Estoc del dia (si el negoci té gestió d'estocs activada)
• Estat de publicació: en verd si es mostra a la web pública, gris si està oculta
• Botons d'acció ràpida: editar · duplicar · baixa · canvi de visibilitat

📸 PENDENT: img/02cat-01-llista-productes.png

Què cal capturar: Grid de productes a /menuclient.php amb 8-10 articles visibles, mostrant la informació i botons d'acció.

Ordenacions disponibles

A la barra d'eines del grid pots canviar l'ordre dels productes:

L'ordre 2 és el més usat: t'ho organitza per família → subfamília → ordre manual.

Reordenar manualment

Pots arrossegar productes dins el grid per canviar el seu ordre dins la família (camp ordensalida). Cada família té la seva pròpia numeració començant per 1.

⚠️ Si tens diversos formats per al mateix producte (300g, 500g, 1kg…), pensa abans com vols presentar-los: com a producte únic amb múltiples tarifes, o com a productes separats.

Crear i editar un producte

Accés: Botó «Nou producte» a la consola, o clic a un producte existent per editar-lo (/client/producte.php?id=X)

Camps del producte

📸 PENDENT: img/02cat-02-fitxa-producte.png

Què cal capturar: Pàgina /client/producte.php?id=X amb un producte ja existent obert, mostrant les seccions de dades i la imatge a dalt.

Pas a pas — Crear un producte nou

1. A la consola, clica Nou producte (botó rodó vermell a la barra d'eines).
2. Omple primer la Identificació:

- Nom — el que veurà el client (es pot traduir a 4 idiomes).

- Descripció curta — text breu que apareix al costat del producte.

- Descripció llarga (opcional) — apareix al detall quan el client clica el producte.

1. Selecciona el Tipus de producte, la Família i la Subfamília (si en tens).

> 💡 Si no en tens cap definida, primer cal anar al Mòdul 10 (Famílies, Subfamílies, Tipus de producte).

1. Puja una imatge del producte clicant a l'àrea d'imatge. Recomanat: format quadrat, mínim 500×500 px.
2. Marca les característiques que apliquin (vegetarià, oferta, etc.).
3. Marca Publicar a Sí perquè aparegui a la web pública.
4. Defineix l'ordre dins família (camp ordensalida). Comença per 1 per a la primera entrada de cada família.
5. Clica Desar.
6. Anar a la pestanya Tarifa (mòdul 3) per assignar format de venda i preu. Sense aquest pas el producte no apareixerà a la web pública (no té preu).

Duplicar un producte

A la consola, clica el botó Duplicar d'una targeta. Crea una còpia del producte amb el mateix nom + " (còpia)" i totes les tarifes i al·lèrgens copiats. Útil quan tens diversos productes molt similars (canvis de gramatge, sabors, etc.).

Baixa d'un producte

A la fitxa del producte, secció Estat, canvia a "Donar de baixa" (baixa = 1). El producte ja no apareixerà al catàleg públic ni es podrà afegir a comandes noves. Les comandes ja realitzades es mantenen amb el producte.

Per reactivar-lo, torna a la fitxa i canvia l'estat a "Actiu".

⚠️ No s'esborra mai un producte del sistema, només es marca com a baixa. Això permet mantenir l'històric de comandes intacte.

Casos especials / Avisos

• ⚠️ Si el negoci és en mode proves, el límit és de 10 productes. Quan arribes a 10, el botó "Nou producte" es desactiva amb tooltip "Límit de 10 productes en compte de proves".
• ⚠️ Les imatges es desen a assets/img/productes/ amb nom autogenerat (IMG_Cliente_{idCli}Producto-{idProd}.jpg). Si fas un canvi d'imatge, la versió anterior queda al disc però no es referencia (es pot netejar periòdicament).
• ⚠️ Quan duplicat un client (centre de venda amb fills), els productes es copien per a cada local fill però amb les seves pròpies tarifes (poden ser diferents).
• ℹ️ Si oblides marcar "Publicar", el producte només es veu a la consola però no a la web pública.
• ℹ️ Els al·lèrgens i les tarifes s'edita des d'iframes específics (mòdul 3); des de la fitxa del producte hi ha botons d'accés directe.

Mòdul 3 — Preus, tarifes i al·lèrgens

Per a qui: propietari, operador

Fitxers relacionats: client/iframe_tarifaproducto.php, client/iframe_asigna_alergenos.php

Prerequisit: formats de venda i unitats de venda han d'existir (es creen a l'alta del compte; es gestionen des del Mòdul 10)

Què són les tarifes?

Una tarifa és la combinació de format de venda + preu d'un producte. Un mateix producte pot tenir diverses tarifes:

• Un pollastre a l'ast es pot vendre per unitat, per mitja unitat o per kg, cadascuna amb preu propi.
• Una pizza pot tenir tarifa de petita / mitjana / gran.
• Un pa pot tenir tarifa de 300g / 500g / 1kg.

Sense almenys una tarifa, el producte no apareix al catàleg públic (no té preu per mostrar).

Assignar preus i formats de venda a un producte

Accés: Des de la fitxa del producte (/client/producte.php?id=X) → botó «Tarifa» → s'obre l'iframe client/iframe_tarifaproducto.php

Estructura de la pantalla

L'iframe mostra una taula amb:

📸 PENDENT: img/03tar-01-iframe-tarifes.png

Què cal capturar: L'iframe de tarifes d'un producte amb 2-3 tarifes definides (unitat, mitja unitat, kg) i el botó "Afegir tarifa" a baix.

Pas a pas — Afegir una tarifa

1. A la fitxa del producte, clica Tarifa. S'obre l'iframe.
2. Clica Afegir tarifa.
3. Tria el Format de venda del desplegable.

> 💡 Si no apareix el format que necessites (ex: "Mitja unitat"), primer cal definir-lo al Mòdul 10 (Formats de venda).

1. Tria la Unitat de venda (kg, peça, gramatge…).
2. Introdueix l'Import (preu).
3. Defineix la Seqüència (1 per al format principal, 2 per al secundari, etc.).
4. Clica Desar.
5. Repeteix per a cada format que vulguis oferir.

Editar o eliminar una tarifa

• Editar: clica el botó d'edició (llapis) → modifica els camps → desa.
• Eliminar: clica × → confirma. ⚠️ Si elimines una tarifa, les comandes existents que la usaven mantenen el preu històric (no es modifiquen).

Assignar al·lèrgens a un producte

Accés: Des de la fitxa del producte → botó «Al·lèrgens» → s'obre l'iframe client/iframe_asigna_alergenos.php

Llista d'al·lèrgens disponibles

El sistema gestiona els 14 al·lèrgens declarables oficialment a la UE:

Pas a pas — Marcar al·lèrgens

1. A la fitxa del producte, clica Al·lèrgens.
2. A l'iframe, marca les caselles dels al·lèrgens que conté el producte.
3. Clica Desar.

Les icones dels al·lèrgens apareixeran:

• Al grid de productes de la consola (com a etiquetes)
• Al catàleg públic (perquè el client en sigui conscient)
• Al detall del producte a la pàgina pública

📸 PENDENT: img/03tar-02-iframe-allergens.png

Què cal capturar: L'iframe d'al·lèrgens amb 4-5 al·lèrgens marcats i la taula de 14 al·lèrgens visible.

⚠️ La normativa europea obliga a declarar al·lèrgens a tots els productes alimentaris. Pren-t'ho seriosament: una omissió pot generar problemes greus de salut a un client.

Formats de venda (selectors disponibles)

Els formats que apareixen als desplegables de tarifes es defineixen al Mòdul 10 (Fitxers de suport). Cada negoci té els seus propis formats:

• Format 1: Unitat (1 ud)
• Format 2: Mitja unitat (0.5 ud)
• Format 3: Quart (0.25 ud)
• Format 4: Kg (1 kg)
• Format 5: Mig kg (0.5 kg)
• Format 6: Quart de kg (0.25 kg)
• … (els que vulguis)

Cada format té una descripció multilingüe (es mostra al públic) i un valor numèric (per calcular comptadors d'estoc, per exemple).

→ Veure Mòdul 10 — Formats de venda per saber com afegir-ne de nous.

Unitats de venda (selectors disponibles)

Les unitats descriuen el gramatge o magnitud concreta d'una tarifa. Són complementàries als formats:

• "1 kg" (per a format Kg)
• "500 g" (per a format Mig kg)
• "1 unitat" (per a format Unitat)
• "Pizza 30 cm" (per a Pizza gran)
• …

S'utilitzen per donar més detall al client (ex: "Pollastre — 1 unitat (~1.2 kg) — 14,50 €").

→ Veure Mòdul 10 — Unitats de venda per gestionar-les.

Casos especials / Avisos

• ⚠️ Si un producte té 0 tarifes definides, no es mostra al catàleg públic encara que publicar = 1. La vista vwv_productos_tarifas el filtra fora.
• ⚠️ El format predeterminat és el que té la seqüència més baixa. Si vols destacar la tarifa "Kg" abans que la "Unitat", canvia les seqüències.
• ℹ️ Pots tenir tarifes a preu 0 (productes gratuïts, regals…). El sistema els accepta com a vàlids.
• ℹ️ Les monedes són globals (€ per defecte). El sistema no gestiona múltiples monedes per ara.
• ℹ️ Els al·lèrgens es desen a tbalergenosprodcli (relació producte ↔ al·lergen). Una mateixa fitxa pot tenir 0..N al·lèrgens marcats.

Mòdul 4 — Calendari i horaris

Per a qui: propietari, operador

Fitxers relacionats: client/calendari.php, client/genera_calendari.php

Què és el calendari?

El calendari del negoci controla quins dies pots rebre comandes i a quines hores. Es genera per a tot l'any (o el període vigent del compte) i marca cada dia com a:

• Laborable — el negoci està obert amb els horaris definits a la fitxa
• Festiu — el negoci tancat (no es poden fer comandes per a aquest dia)
• Festivolaborable — dia especial amb horari diferent (ex: dilluns festiu que decideixes obrir)
• Vacances — període llarg tancat (s'aplica a múltiples dies seguits)

Cada dia del calendari té els seus propis horaris de matí i tarda (hora d'inici i fi), independent de la setmana habitual. Així pots tancar un dijous concret o canviar l'horari un divendres especial.

📸 PENDENT: img/04cal-01-calendari-general.png

Què cal capturar: Vista mensual del calendari a /client/calendari.php mostrant els colors dels diferents tipus de dia.

Visió general del calendari

Accés: Navbar → Fitxers → Calendari (/client/calendari.php)

La pantalla mostra una vista mensual amb selectors de mes/any a dalt. Cada dia és una cel·la amb:

• Número del dia
• Color de fons segons tipus:

- Blanc — laborable normal

- Vermell — festiu (tancat)

- Groc — festivolaborable (horari especial)

- Gris — vacances

• Petites icones si hi ha comandes ja programades

A baix es mostra la llegenda de colors. Clica qualsevol dia per editar-lo.

Filtres ràpids

• Anar a avui — torna al mes actual
• Anar a la data — selector per saltar a un mes/any concret

Crear o regenerar el calendari

Accés: Botó «Generar calendari» a /client/fitxa_client.php (només admin)

Si el calendari està buit (compte nou) o vols regenerar-lo completament, cal usar la funció de generació:

1. Anar a la Fitxa del negoci.
2. Trobar la secció Calendari.
3. Clica Generar calendari.
4. Confirma a l'alerta.
5. El sistema:

- Llegeix els horaris de la setmana habitual (fitxa)

- Llegeix els festius nacionals/regionals

- Llegeix les temporades definides (si n'hi ha)

- Crea entrades a tbcalendario per a tots els dies des d'avui fins a la fechacaducitat.

⚠️ Regenerar esborra els canvis manuals que hagis fet a dies individuals. Pensa-ho bé abans d'usar aquesta opció.

📸 PENDENT: img/04cal-02-generar-confirm.png

Què cal capturar: Alerta de confirmació "Voleu generar el calendari? Es perdran les modificacions manuals".

Editar un dia: horaris de torn

Accés: Clic sobre qualsevol cel·la del calendari

S'obre un modal amb els camps de configuració del dia:

📸 PENDENT: img/04cal-03-edita-dia.png

Què cal capturar: Modal d'edició d'un dia obert sobre el calendari, amb els camps de torns matí/tarda.

Validacions

El sistema comprova que:

• L'hora d'inici ha de ser anterior a la de fi en cada torn.
• Si un torn està buit, l'altre ha d'estar definit (un dia obert sempre té almenys un torn).
• Per a un dia festiu, tots els horaris es deixen buits automàticament.

Marcar dies festius

Hi ha dues formes:

1. Editar dia per dia

Clica al dia a la vista mensual → Tipus = Festiu → Desa.

2. Festius nacionals automàtics

A la generació del calendari, el sistema inclou per defecte els festius nacionals d'Espanya (1 Gener, 6 Gener, Setmana Santa, 1 Maig, 15 Agost, 12 Octubre, 1 Novembre, 6 Desembre, 8 Desembre, 25 Desembre).

Per festius autonòmics o locals, has d'editar-los manualment després de la generació.

Definir temporades

Les temporades són períodes de l'any amb horaris diferents als de la setmana habitual. Útil per:

• Estiu: obrir més tard o més estona
• Hivern: reduir torn de migdia
• Vacances escolars: tancar al migdia

Accés: Fitxa del negoci → secció Temporades

Defineix:

• Data d'inici i data fi de la temporada
• Tipus: Alta o Baixa
• Horaris d'aquesta temporada per a cada dia de la setmana

Quan generes el calendari, el sistema aplica els horaris de temporada als dies dins el rang i els horaris habituals fora del rang.

📸 PENDENT: img/04cal-04-temporades.png

Què cal capturar: Secció de temporades a la fitxa del negoci amb 1-2 temporades definides (ex: estiu i hivern).

⚠️ Si dues temporades es solapen, prevalia la més recent (fechaTempinicio més tardana).

Configurar horaris per defecte

Els horaris de la setmana habitual es defineixen a la Fitxa del negoci, secció Horaris d'obertura. Per a cada dia (Lu-Do):

• Marca si està obert o tancat (Lu = '1'/'0').
• Si està obert, defineix les hores de matí (him/hfm) i de tarda (hit/hft).

Aquests horaris són els que s'utilitzen per defecte quan generes el calendari.

📸 PENDENT: img/04cal-05-horaris-defecte.png

Què cal capturar: Secció d'horaris a la fitxa del negoci amb els 7 dies de la setmana i els seus horaris matí/tarda.

Casos especials / Avisos

• ⚠️ Un cop generat el calendari, els canvis a la fitxa NO es propaguen automàticament. Si canvies l'horari d'obertura a la fitxa, cal regenerar el calendari perquè els nous horaris s'apliquin als dies futurs.
• ⚠️ Quan un client fa una comanda al públic, el sistema només mostra els dies amb almenys un torn obert al calendari.
• ℹ️ Per a un dia festivolaborable, pots posar horaris fora del que faries un dia normal. Útil per a un dilluns "festiu" que decideixes obrir només per la tarda.
• ℹ️ Pots esborrar completament el calendari des de la fitxa del negoci (botó "Esborrar calendari"). Útil si vols recomençar de zero. Demana confirmació.

Mòdul 5 — Comptadors i slots horaris

Per a qui: propietari, operador

Fitxers relacionats: client/contadores-diarios-tickets.php, client/crea-contadores-diarios-tickets.php, client/contador-tickets.php, client/iframe_contadores.php, client/iframe_contadreservas.php, client/tramos-horarios-contadores-dia.php

Què són els comptadors?

Els comptadors són una eina per limitar el nombre de comandes que pots acceptar en una franja horària concreta. Útil per a:

• Restaurants amb capacitat limitada: només 30 reserves per al servei de migdia.
• Negocis amb cuina petita: només 20 pollastres a l'ast llestos per a les 13:00.
• Repartiment a domicili: només 10 entregues entre les 19:00 i les 20:00.
• Reserves: només 8 taules disponibles a les 21:00.

Quan un client va a fer una comanda i la franja horària té el comptador ple, el sistema no li deixa triar aquella hora i ha d'escollir una altra opció disponible.

Llista de comptadors diaris

Accés: Navbar → Fitxers → Comptadors (/client/contadores-diarios-tickets.php)

La pantalla mostra els comptadors configurats per al dia actual o el dia que selecciones:

📸 PENDENT: img/05cnt-01-llista-comptadors.png

Què cal capturar: Pàgina /client/contadores-diarios-tickets.php amb 3-4 comptadors del dia visibles i les seves capacitats.

Crear un nou comptador

Accés: Botó «Nou comptador» o /client/crea-contadores-diarios-tickets.php

Pas a pas

1. Clica Nou comptador.
2. Omple els camps:

- Codi del comptador — màx. 8 caràcters majúscules (ex: COCM).

- Descripció — text llarg en 4 idiomes (Ex: "Comandes de migdia").

- Tipus: Comandes o Reserves.

- Capacitat màxima — número (ex: 20).

- Activa: marcat per defecte.

1. Clica Desar.

📸 PENDENT: img/05cnt-02-nou-comptador.png

Què cal capturar: Formulari de nou comptador amb camps d'exemple.

Després de crear

El comptador queda definit però no s'aplica enlloc encara. Cal:

1. Assignar-lo a una o més franges horàries d'un dia (veure secció següent).
2. (Opcional) Definir un patró de comptadors per a la setmana habitual (es propaga al calendari).

Editar un comptador (capacitat, descripció)

A la llista, clica el botó d'edició (llapis) d'un comptador. Modifica els camps i clica Desar.

⚠️ Si canvies la capacitat quan ja hi ha comandes aplicades:

• Si l'augmentes, no passa res — més comandes podran encabir-se.
• Si la redueixes per sota del nombre actual, les comandes ja acceptades es mantenen però no pots reduir més (saturació immediata).

Assignar comptador a franges horàries d'un dia

Accés: Des de la llista de comptadors → botó «Slots horaris» d'un dia, o /client/tramos-horarios-contadores-dia.php?lafecha=YYYY-MM-DD

La pantalla mostra el dia escollit amb tots els intervals horaris definits a la fitxa (típicament cada 15 o 30 minuts).

Per a cada interval:

• Hora (ex: 13:00, 13:15, 13:30…)
• Selector amb tots els comptadors actius del client.
• Pots seleccionar un comptador per franja.

📸 PENDENT: img/05cnt-03-slots-horaris.png

Què cal capturar: Pàgina de slots horaris d'un dia mostrant la graella d'intervals i els comptadors assignats.

Exemple d'ús

Si vols que el comptador "COCM" (capacitat 20) cobreixi les hores de 12:00 a 14:30, assigna'l a cada slot de 12:00, 12:15, 12:30, …, 14:30. Total: 11 slots.

💡 Si en cada slot hi ha el mateix comptador, el seu límit (20) és global: en tot el rang 12:00-14:30 s'acceptaran fins a 20 comandes (no 20 per slot).

Auto-assignar per setmana habitual

Per estalviar feina, pots definir un patró setmanal (dl, dt, dc, dj, dv, ds, dg) als «Comptadors horaris» des de l'iframe del calendari, i el sistema l'aplica automàticament als nous dies generats.

Comptadors de reserves

Accés: Pestanya Reserves o /client/iframe_contadreservas.php

Funcionen igual que els comptadors de comandes, però:

• S'apliquen a reserves (taula tbreservas, no tbpedidos).
• Es desen a tbcontadreservas (no tbcontadores).

⚠️ Si el negoci no accepta reserves (aceptareservas = '0'), aquesta pestanya no apareix.

Comptadors horaris vs Comptadors per slot

El comptador setmanal és el patró general; el per slot és el que realment s'aplica i pots modificar dia per dia.

Casos especials / Avisos

• ⚠️ Si un slot no té comptador assignat, no hi ha límit per a aquella franja (s'accepten totes les comandes).
• ⚠️ Si vols bloquejar completament un slot (perquè el negoci està tancat), crea un comptador amb capacitat 0 i assigna'l. Si no, marca el dia com a festiu al calendari.
• ⚠️ Els comptadors es reseten cada nit (es comencen de zero el dia següent). El comptador acumula comandes només dins del dia natural.
• ℹ️ El sistema també gestiona comptadors per a tbcontadreservas (reserves) si el negoci té reserves activades.
• ℹ️ Quan duplicat un client (centre de venda), els comptadors es copien al fill amb els mateixos codis i descripcions, però amb ultnumdado = 0 (es reseta el comptador acumulat).

Mòdul 6 — Poblacions i zones d'entrega

Per a qui: propietari

Fitxers relacionats: client/iframe_pob_reparto.php

Per què cal definir poblacions d'entrega?

Si el teu negoci ofereix repartiment a domicili, necessites definir on portes les comandes: quines poblacions o codis postals, amb quin import mínim i quina tarifa de transport.

Sense aquestes dades, el client no pot escollir el repartiment a domicili al fer la comanda.

Gestió de poblacions d'entrega a domicili

Accés: Fitxa del negoci → secció Repartiment a domicili → botó «Poblacions» (/client/iframe_pob_reparto.php)

L'iframe mostra una taula de totes les poblacions configurades amb les seves dades.

Columnes

📸 PENDENT: img/06ent-01-iframe-poblacions.png

Què cal capturar: L'iframe iframe_pob_reparto.php amb 3-5 poblacions configurades a la taula.

Pas a pas — Afegir una població

1. Obre la fitxa del negoci → Repartiment a domicili → Poblacions.
2. Clica Afegir població.
3. Omple:

- Codi postal (5 dígits).

- Població (text).

- Import mínim (ex: 15.00).

- Cost (ex: 2.50).

- Gratuït a partir de (ex: 30.00).

1. Clica Desar.
2. La població apareix a la taula i ja és disponible per a comandes.

Editar o donar de baixa una població

• Editar: clica el llapis → modifica els camps → desa.
• Baixa: clica × o canvia el checkbox Activa. La població desapareix dels desplegables públics però es manté a la BD per a comandes ja realitzades.

Importar poblacions massiu

Si tens moltes poblacions a definir (per ex. tot un comarcal), pots fer-ho via CSV i pujar-lo a la BD directament. Pregunta al teu administrador per ajuda amb això.

Com afecta al client final

Quan un client va a fer una comanda i marca Repartiment a domicili:

1. El sistema li mostra un desplegable amb totes les poblacions actives.
2. En triar-ne una, es calculen:

- Import mínim requerit per a aquella població.

- Cost del repartiment que s'afegeix al total (o 0 si supera el llindar de gratuïtat).

1. Si la comanda no arriba a l'import mínim, es bloqueja el check-out amb el missatge "Comanda mínima X € per a {població}".

📸 PENDENT: img/06ent-02-public-domicili.png

Què cal capturar: Pantalla pública de selecció de domicili amb el selector de poblacions i els camps d'adreça.

Casos especials / Avisos

• ⚠️ Si no actives cap població, l'opció de repartiment a domicili no apareix al públic encara que la fitxa la tingui marcada com a adomicilio = '1'.
• ⚠️ Si tens múltiples locals duplicats, cada local té les seves pròpies poblacions independents. Si vols que tots tinguin la mateixa cobertura, has de configurar-les una vegada per local (o duplicar a la creació del fill — la duplicació de client copia automàticament les poblacions).
• ⚠️ Per a comandes Take Away (recollida al local), no s'usen aquestes dades — només per a entregues a domicili.
• ℹ️ Pots definir el mateix codi postal en diferents files (ex: si una part del CP queda a una zona diferent). El sistema permet duplicats al codi postal però no al codi (id_poblacionrepartocliente).
• ℹ️ Si vols eliminar una població definitivament (en lloc de donar-la de baixa), cal entrar a la BD i fer-ho manualment. La interfície només permet baixa lògica.

Mòdul 7 — Gestió de comandes

Per a qui: propietari, operador, recepcionista

Fitxers relacionats: client/quadre.php, client/llibreta_comandes.php, client/comandes_dia.php, client/comandes_client.php, client/comandes_historic.php, client/iframe_accion_pedido.php, client/transaccions.php

Visió general

El sistema gestiona les comandes en 3 estats principals:

Cada comanda passa pels estats: nova → confirmada → preparada → entregada → cobrada.

Aquest mòdul descriu totes les pantalles disponibles per a gestionar comandes des de la consola.

Quadre de control (preparació)

Accés: Navbar → Consola (/client/quadre.php)

És la pantalla principal del dia a dia per a operadors i propietaris. Mostra 3 comptadors amb les comandes pendents d'acció:

1. A confirmar — comandes noves que esperen la teva resposta
2. En passarel·la — comandes que estan en procés de pagament Redsys
3. Converses pendents — comandes amb missatges del client per llegir

📸 PENDENT: img/07cmd-01-quadre.png

Què cal capturar: Pàgina /client/quadre.php amb els 3 comptadors amb números i les accions ràpides.

Comportament del so

Quan hi ha comandes a confirmar, en passarel·la o converses, el quadre emet un so d'alerta repetitiu. Pots silenciar-lo amb el botó del so o desactivar-lo permanentment des de la configuració del navegador.

⚠️ Si Firefox no reprodueix el so, has d'activar print.always_print_silent = true a about:config.

Accions ràpides

Cada comptador té un botó per anar al llistat corresponent:

• Veure comandes a confirmar → comandes_client.php?filtre=...
• Veure converses pendents → converses_comandes.php

Llistat de comandes del dia

Accés: Navbar → Comandes → Llistat de comandes (/client/comandes_client.php)

Mostra totes les comandes del dia seleccionat amb un strip de dates al damunt (per saltar a un altre dia ràpidament).

📸 PENDENT: img/07cmd-02-llistat-comandes.png

Què cal capturar: Pàgina /client/comandes_client.php amb hero vermell ("Llistat de comandes — Avui 22 de juliol — 8 comandes") i 4-5 cards de comandes amb informació detallada.

Filtres per estat

A la barra de filtres pots restringir per:

Detall d'una comanda

Clica sobre una card per expandir-la: es mostra el detall complet (línies, observacions, dades del client, ticket associat).

Des d'aquí pots:

• Veure el ticket del client (PDF/imatge)
• Confirmar / Rebutjar / Modificar la comanda
• Contestar el client (conversa)
• Imprimir el ticket
• Marcar com a entregada / cobrada

Accions sobre una comanda (confirmar, preparar, entregar)

Accés: Des del llistat de comandes, clica el botó d'acció d'una comanda. S'obre client/iframe_accion_pedido.php en modal.

Possibles accions

📸 PENDENT: img/07cmd-03-iframe-accio.png

Què cal capturar: Modal iframe_accion_pedido.php obert sobre comandes_client.php amb els botons Acceptar/Contestar/Rebutjar.

⚠️ Una comanda rebutjada envia un correu automàtic al client. Pensa-ho bé abans de fer-ho.

Converses pendents

Accés: Navbar → Comandes → Converses (/client/converses_comandes.php)

Llistat de comandes amb missatges pendents de resposta per part teva. Cada fila mostra:

• Codi de la comanda
• Dades del client
• Últim missatge del client
• Botó «Contestar»

📸 PENDENT: img/07cmd-04-converses.png

Què cal capturar: Llistat de converses pendents.

Quan contestes, el client rep un correu amb el teu missatge i un link per respondre. La conversa es manté a tbconversaciones per a referència futura.

Històric de comandes

Accés: Navbar → Comandes → Històric (/client/comandes_historic.php)

Mostra totes les comandes de l'històric amb filtres avançats:

• Rang de dates
• Estat
• Per client (telèfon o email)
• Per producte
• Per import (min/max)

📸 PENDENT: img/07cmd-05-historic.png

Què cal capturar: Pàgina /client/comandes_historic.php amb filtres aplicats i la taula resultat.

Útil per:

• Veure quins productes s'han venut més
• Buscar una comanda concreta per dades del client
• Generar informes mensuals

Resum del dia (tancament econòmic)

Accés: Navbar → Comandes → Resum del dia (/client/comandes_dia.php)

Mostra el tancament econòmic del dia:

• Total de comandes confirmades
• Import total recaptat
• Desglossament per mètode de pagament (efectiu, targeta, Redsys, …)
• Productes més venuts
• Botó Enviar resum per email (envia el resum a l'administrador del negoci)

📸 PENDENT: img/07cmd-06-resum-dia.png

Què cal capturar: Resum del dia amb totals econòmics i productes més venuts.

Llibreta de comandes

Accés: Navbar → Comandes → Llibreta (/client/llibreta_comandes.php)

És una vista imprimible del dia amb totes les comandes en format llibre. Cada comanda ocupa una pàgina amb el ticket sencer. Útil per:

• Imprimir el dia sencer al matí per al servei
• Tenir una còpia en paper de seguretat
• Repassar les comandes mentre prepares la cuina

📸 PENDENT: img/07cmd-07-llibreta.png

Què cal capturar: Vista imprimible amb 2-3 comandes seguides.

Comandes per client

Accés: Des de la fitxa d'un client final (/usuario/comandes.php o comandes_client.php?email=...)

Filtra les comandes pel client concret. Permet veure l'històric d'un client específic, útil per a:

• Contestar consultes ("Quan vaig fer la última comanda?")
• Identificar clients freqüents
• Gestionar fidelització

Casos especials / Avisos

• ⚠️ Una comanda a confirmar que no es contesta en X hores NO es cancel·la automàticament. Cal fer-ho manualment o esperar que el client la cancel·li.
• ⚠️ Si la comanda s'ha pagat per passarel·la (Redsys) i la cancel·les, el reemborsament no és automàtic — has d'anar al panell de Redsys (canales.redsys.es) per fer la devolució.
• ⚠️ El so del quadre roman actiu mentre hi ha 1 o més comandes pendents. Atura's automàticament quan les confirmes totes.
• ℹ️ Els operadors només veuen les seccions que tenen permís a la seva configuració (tboperador_field_config). Pots ajustar permisos des de la fitxa de cada operador.
• ℹ️ El llistat de comandes utilitza la vista vwv_pedidos (no la taula tbpedidos directament) per assegurar coherència de dades amb les transaccions associades.

Mòdul 8 — Control d'estocs

Per a qui: propietari, operador

Fitxers relacionats: client/stocks-dia.php

Per què cal gestionar estocs?

Si el teu negoci té productes amb estoc limitat per dia (ex: 30 pollastres a l'ast disponibles cada migdia, 50 quitxes per al cap de setmana…), la gestió d'estocs evita que els clients facin comandes que després no puguis servir.

Quan un client va a fer una comanda i el producte té estoc 0, no apareix al catàleg o apareix com "esgotat", segons la configuració.

Activar la gestió d'estocs

A la fitxa del negoci, secció Configuració, marca el camp gestionastocks = 1. Sense això, el sistema no controla estocs i tot apareix sempre disponible.

⚠️ Activar/desactivar la gestió d'estocs no esborra dades — només canvia si el sistema els respecta o no.

Estocs diaris per producte

Accés: Navbar → Configuració → Estocs del dia (/client/stocks-dia.php o modal modalStocksDia)

La pantalla mostra tots els productes amb control d'estoc actiu, amb les unitats disponibles per al dia actual.

Columnes

📸 PENDENT: img/08stk-01-stocks-dia.png

Què cal capturar: Modal o pàgina stocks-dia.php amb una taula de 4-5 productes amb les seves quantitats restants.

Pas a pas — Establir l'estoc del dia

1. Obre Configuració → Estocs del dia.
2. Per a cada producte, introdueix la quantitat disponible al camp.
3. Clica Desar.
4. El sistema desa la quantitat per a la data d'avui a tbstocksdeldia.

A mesura que els clients fan comandes, el sistema descompta automàticament del stock disponible (unidadesenstock).

Quan un producte arriba a 0

• Apareix com esgotat al catàleg públic (segons configuració).
• Les comandes ja acceptades es mantenen (no es cancel·len).
• Les noves comandes no poden incloure aquest producte fins que l'estoc augmenti.

Quins productes tenen control d'estoc?

Per defecte, cap producte té control d'estoc activat individualment. Per activar-lo a un producte concret:

1. Obre la fitxa del producte.
2. Trobat el camp Control d'estoc (controlstocks).
3. Marca'l a 1.
4. Desa.

A partir d'aquí, el producte apareix a la pantalla d'estocs del dia.

⚠️ Cal activar el control general (gestionastocks = 1 a la fitxa del negoci) I el control particular (controlstocks = 1 al producte) perquè el sistema controli realment l'estoc d'un producte.

Resetejar estocs

A la pantalla d'estocs del dia hi ha un botó «Resetejar» per cada producte que torna el comptador a 0. Útil si:

• Has fet errades al posar l'estoc.
• El producte ha esgotat i no en penses fer més (per al dia).

També pots resetejar tots amb un botó global a baix.

⚠️ Resetejar no afecta les comandes ja acceptades. El sistema simplement deixa el comptador disponible en 0.

Casos especials / Avisos

• ⚠️ El stock es reseta cada nit: el dia següent comença en 0 per a tots els productes. Has de definir l'estoc cada matí (o automatitzar-ho amb un patró setmanal — no implementat).
• ⚠️ Si el client té el producte al carret i en aquell moment esgotes el stock, el sistema rebutja el check-out amb el missatge "Producte esgotat. Revisa el teu carret".
• ℹ️ La taula tbstocksdeldia desa una fila per (producte, data). Si vols revisar quants se n'han venut a la setmana, pots fer una consulta SQL a aquesta taula.
• ℹ️ Si vols un estoc setmanal (ex: 100 pollastres a la setmana, no 30 al dia), el sistema actual no ho suporta directament — has de fer-ho manualment dividint per 7 i resetejant cada dia.
• ℹ️ La vista vwv_stocksdeldia agrega l'estoc amb les comandes per donar el "unidades disponibles" actual.

Mòdul 9 — Mostrador i tickets

Per a qui: operador, recepcionista

Fitxers relacionats: client/entregas_mostrador.php, client/ticket.php, client/ticket-confirmado.php

Què és el mostrador?

El mostrador és la pantalla que utilitza l'operador o recepcionista per gestionar les entregues quan els clients passen pel local a recollir les seves comandes. És especialment útil per a:

• Negocis amb molta afluència a hores punta
• Recepcionistes que han de validar comandes amb pagament en efectiu
• Tickets impresos al moment

Entregues de mostrador

Accés: Navbar → Consola → Mostrador (/client/entregas_mostrador.php)

Mostra una llista de comandes pendents d'entrega per a la franja horària actual o pròxima. Cada fila:

📸 PENDENT: img/09mos-01-mostrador-llista.png

Què cal capturar: Pantalla /client/entregas_mostrador.php amb 5-6 comandes pendents llistades en ordre per hora.

Pas a pas — Entregar una comanda

1. Crida el client pel codi de ticket o pel seu nom.
2. Quan vingui, clica la seva fila o el botó «Veure ticket».
3. Es mostra el detall de la comanda. Verifica que els productes són correctes.
4. Si la comanda no està pagada:

- Clica Cobrar.

- Tria el mètode (efectiu, targeta física, transferència, regal…).

- Confirma. El sistema marca la transacció a tbtransacciones.

1. Si està pagada per Redsys, salta el pas anterior.
2. Clica Lliurar. La comanda queda marcada com entregada (estat = L).
3. (Opcional) Imprimeix el ticket per al client si ho demana.

Filtrar per pagament o estat

A la barra superior pots filtrar:

• Només pendents de lliurar — amaga les ja entregades
• Només pendents de cobrar — útil per identificar feina pendent
• Amb domicili — comandes per a repartiment, no de mostrador

Visualitzar i confirmar un ticket

Accés: Des del mostrador, clica una comanda → s'obre client/ticket.php o ticket-confirmado.php

Ticket a confirmar (ticket.php)

Es mostra el ticket abans que l'operador l'accepti definitivament. Inclou:

• Codi de ticket gran (visible des de lluny)
• Logo del negoci
• Llista de productes amb quantitats i preus
• Subtotal, taxes i total
• Dades del client
• Observacions del client (si n'hi ha)
• Botons d'acció: Confirmar, Modificar, Rebutjar

Ticket confirmat (ticket-confirmado.php)

Mostra el ticket un cop confirmat. Aquesta és la pantalla que es imprimeix automàticament quan acceptes una comanda. Inclou:

• Codi de ticket
• Tot el detall del producte
• QR amb el codi de la comanda (per al client)
• Peu amb dades del negoci (nom, telèfon, adreça, web)

📸 PENDENT: img/09mos-02-ticket-confirmat.png

Què cal capturar: Pàgina ticket-confirmado.php amb ticket d'exemple per a un client.

Impressió silenciosa (2 còpies)

El sistema està configurat per imprimir 2 còpies automàticament:

• 1 per al client (queda amb el client)
• 1 per al negoci (queda a la caixa o a la barra)

⚠️ Si Firefox no imprimeix automàticament, has d'activar print.always_print_silent = true a about:config. Chrome i Edge funcionen sense configuració.

Reimprimir un ticket

Per reimprimir un ticket ja generat:

1. Vés a Comandes → Llistat o al Mostrador.
2. Localitza la comanda.
3. Clica el botó Veure ticket o Reimprimir.
4. S'obre el ticket en mode imprimible.
5. Polsa Ctrl+P o el botó d'imprimir del navegador.

Casos especials / Avisos

• ⚠️ Si la comanda té observacions o notes especials del client, surten destacades en groc al ticket. Llegeix-les abans de lliurar.
• ⚠️ Quan cobres per Redsys, el sistema fa el cobrament al moment del check-out (no quan entregues). Per tant la columna "pagament" mostrarà "pagat" abans que arribi el client.
• ⚠️ Si una comanda té múltiples productes i en falta algun, no es pot fer entrega parcial — has de modificar la comanda manualment (Comandes → Llistat → Modificar).
• ℹ️ La impressió automàtica utilitza CSS específic per a impressores tèrmiques de 80 mm. Si tens una impressora normal A4, surt amb format A4 (cal una configuració adicional per a tèrmica).
• ℹ️ Els tickets es guarden a tbticket amb un número incremental per any (numticket). Tot ticket emès queda registrat per a futurs informes.

Mòdul 10 — Fitxers de suport (dades mestres)

Per a qui: propietari

Descripció: Taules de configuració que cal definir ABANS de crear productes i tarifes. Sense elles, no es poden classificar productes ni assignar formats de venda.

Fitxers relacionats: client/families.php, client/subfamilies.php, client/tipus_producte.php

Per què cal aquestes taules?

Els productes del catàleg s'organitzen en una jerarquia de 3 nivells:

```

Tipus de producte (ex: Plats principals)

↓

Família (ex: Carns)

↓

Subfamília (ex: Pollastres)

↓

Producte (ex: Pollastre a l'ast)

```

Cada producte ha d'estar lligat a una família (i opcionalment a una subfamília). Per això, abans de poder crear productes, has de definir aquestes taules.

Pels formats i unitats de venda, és el mateix: cada tarifa d'un producte ha d'usar un format i una unitat ja definits.

💡 Quan crees el compte de proves, el sistema inicialitza aquestes taules automàticament amb valors genèrics. Pots començar a treballar de seguida i ajustar després.

Famílies de productes

Accés: Navbar → Fitxers → Famílies (/client/families.php)

Les famílies són la categoria principal dels productes. Exemples típics:

• Entrants
• Carns
• Peix
• Postres
• Begudes

📸 PENDENT: img/10sup-01-families.png

Què cal capturar: Pantalla /client/families.php amb 5-7 famílies llistades i el botó "Afegir família" a baix.

Pas a pas — Afegir una família

1. A la pantalla de famílies, clica Afegir família.
2. Introdueix el nom en els 4 idiomes (si en tens activats).
3. Defineix l'ordre (ordencatalogo) — número per ordenar al catàleg.
4. Clica Desar.

Reordenar famílies

Pots arrossegar les famílies amb el ratolí per canviar el seu ordre, o editar el camp ordencatalogo directament. L'ordre es propaga immediatament al catàleg públic.

Editar / Baixa

• Editar: clica el llapis → modifica → desa.
• Baixa: clica × → confirma. Si la família té productes assignats, el sistema avisa i no permet la baixa fins que reassignis els productes a una altra família.

Subfamílies de productes

Accés: Navbar → Fitxers → Subfamílies (/client/subfamilies.php)

Les subfamílies són el segon nivell d'organització, dins d'una família. Exemples per a la família "Carns":

• Pollastres
• Conills
• Vedella
• Porc

Cada subfamília està vinculada a una família mare (id_familia).

📸 PENDENT: img/10sup-02-subfamilies.png

Què cal capturar: Pantalla /client/subfamilies.php amb la selecció de família a dalt i les subfamílies llistades.

Pas a pas — Afegir una subfamília

1. Tria la família mare del desplegable.
2. Clica Afegir subfamília.
3. Introdueix el nom en els 4 idiomes.
4. Defineix l'ordre dins la família.
5. Desa.

Casos especials

• Una família pot no tenir subfamílies — si els teus productes no necessiten un nivell més de detall, deixa la subfamília a 0 (genèrica).
• Si mous una subfamília a una altra família, tots els productes assignats es mouen automàticament.

Tipus de producte

Accés: Navbar → Fitxers → Tipus de producte (/client/tipus_producte.php)

Els tipus de producte són una classificació transversal (independent de famílies). Útil per:

• Distingir "Per encàrrec" vs "De venda directa"
• Distingir "Plat principal" vs "Acompanyament"
• Distingir "Producte fresc" vs "Producte congelat"

📸 PENDENT: img/10sup-03-tipus-producte.png

Què cal capturar: Pantalla /client/tipus_producte.php amb 3-4 tipus llistats.

Pas a pas

Igual que famílies: Afegir tipus → posa nom en 4 idiomes → defineix ordre → desa.

Cada producte ha de tenir un tipus assignat (id_tipoproducto). El tipus afecta la presentació al catàleg públic (per ex. els tipus es poden mostrar com a pestanyes superiors).

Formats de venda

Accés: No té una pantalla dedicada a la consola pública. Es gestionen des de l'iframe iframe_tarifaproducto.php quan estableixes una tarifa, o demanant a l'administrador per fer canvis massius.

Els formats ja inicialitzats al compte són:

• Unitat — 1 ud
• Mitja unitat — 0.5 ud
• Quart — 0.25 ud
• Kg — 1 kg
• Mig kg — 0.5 kg
• Quart de kg — 0.25 kg
• (i altres específics del sector)

Si necessites un format nou (ex: "Ració de 250g"), parla amb l'administrador per afegir-lo a tbformatosventa del teu client.

Unitats de venda

Accés: Igual que els formats — gestió via administrador.

Les unitats són el complement descriptiu d'una tarifa:

• "1 kg"
• "500 g"
• "1 unitat"
• "1 unitat (~ 1.2 kg)"
• "Pizza familiar"

Es defineixen a tbunidadesventa per client.

Ordre de propagació al catàleg

Quan visualitzes el catàleg al públic, l'ordre de presentació segueix aquesta jerarquia:

```

1. Tipus de producte (ordencatalogo del tipus)
2. Família (ordencatalogo de la família)
3. Subfamília (ordencatalogo de la subfamília)
4. Producte (ordensalida del producte dins la subfamília)

```

Si canvies l'ordre d'una família, tots els seus productes es mouen junts. Si canvies l'ordre d'un producte concret, només es mou ell dins la seva subfamília.

Casos especials / Avisos

• ⚠️ No esborris famílies/subfamílies amb productes assignats sense reassignar-los primer. Si ho fas, els productes apareixen al catàleg com a "Sense família" i poden no visualitzar-se correctament.
• ⚠️ Si vols reorganitzar la jerarquia completa (canviar moltes famílies a la vegada), millor fer-ho en moments de poc trànsit. Cada canvi es propaga immediatament al catàleg públic.
• ℹ️ Els canvis de noms (traduccions) no afecten les comandes ja realitzades — el nom del producte queda registrat a tbpedidoslineas en el moment de la comanda.
• ℹ️ Quan duplicat un client (centre de venda), totes aquestes taules es copien al fill amb els mateixos IDs interns, però sense relacionar-se amb els del pare (cada local té les seves dades pròpies).
• ℹ️ Per crear formats o unitats nous massivament, demana a l'administrador que executi una migració SQL — la interfície només permet edició individual.