## id
doc_gestio_documental

## nom
Gestió Documental — límits, cobertura real i casos concrets

## descripcio
Consulta aquest document quan calgui precisar exactament què cobreix la vista centralitzada de
"Gestió Documental" (i què en queda fora), quins són els límits reals de mida i format, com es
distingeixen els documents "orfes", o per què alguns documents pujats a FiskAppCloud no hi
apareixen mai. No és l'explicació general, que cobreix `flux_gestio_documental`.

## contingut
### Límits de mida i format

El límit de mida per a un document de Gestió Documental (tant estructural com d'operació) és de
**5 MB per fitxer** (rebaixat des dels 10 MB originals el 2026-08-30). Els formats admesos són
`.pdf`, `.doc`, `.docx`, `.xls`, `.xlsx`, `.xml` i `.txt` — no s'hi pot pujar qualsevol tipus de
fitxer.

Aquest límit **no viu al servei de blobs**: el servei que parla amb Azure no imposa cap límit ni
cap restricció de format per si sol. Es comprova al controlador que rep la pujada, abans de
cridar el servei. Qualsevol pantalla nova que pugi documents ha d'implementar aquesta comprovació
ella mateixa — no és una garantia automàtica del magatzem.

Hi ha un límit diferent i no relacionat, de 512 KB, que només s'aplica al **logotip de
l'empresa** (format imatge: PNG/JPG/WEBP). El logotip no es considera un document de Gestió
Documental — es guarda i es gestiona a part, des de la fitxa de l'empresa a Configuració — i per
això no apareix mai a cap de les dues pantalles de Gestió Documental. Si un usuari pregunta pel
límit de mida "de Gestió Documental", la resposta correcta és 5 MB; els 512 KB només apliquen al
logotip.

També hi ha un tercer límit, encara més estricte (1 MB), només per als fitxers que arriben per la
via d'**ingesta automàtica per correu** (abans que l'usuari els hagi revisat) — precisament perquè
en aquell pas no hi ha cap revisió humana prèvia. Vegeu `doc_ingesta_documents_comptables`.

### Les dues pantalles del menú "Gestió Documental"

Malgrat compartir menú, les dues pantalles funcionen de manera molt diferent:

- **Fitxers Mestres**: carrega d'entrada **tots** els documents estructurals de l'empresa
  (tots els vinculats a fitxes, de qualsevol tipus de fitxa), amb cerca lliure sobre el
  resultat i selecció múltiple per baixar-los junts en un ZIP (màxim 50 fitxers per petició).
- **Operacions**: no carrega res fins que l'usuari tria un **Tipus de document** (és a dir, un
  llibre comptable concret, o l'opció especial "Liquidacions" per als fitxers de les
  presentacions fiscals) i un **Exercici**. Opcionalment es pot afinar per compte comptable o
  per rang de dates. És, doncs, una consulta dirigida, no un llistat general com l'altra
  pantalla.

### Documents "orfes"

Un document es marca com a orfe quan el fitxer encara existeix al magatzem però ja no té cap
registre viu al darrere:

- A Fitxers Mestres: la fitxa a la qual estava vinculat ja no existeix.
- A Operacions: no es troba cap operació comptable amb aquell mateix identificador de document
  (típicament perquè es va esborrar després de pujar-hi el fitxer).

Els orfes no s'esborren automàticament — es mostren igualment, marcats, perquè l'usuari decideixi
si els vol conservar o eliminar-los manualment.

### El que NO és visible des de Gestió Documental (per disseny, no per omissió)

El magatzem físic (Azure Blob Storage) és únic per a tota l'empresa, però Gestió Documental
només és la vista d'una part concreta d'aquest magatzem: la documentació ja incorporada a
operacions econòmiques i a fitxes mestres. Dos tipus de fitxers que hi conviuen físicament en
queden fora, i en cap dels dos casos es tracta d'un forat — és el disseny previst:

- **El logotip de l'empresa** (i altres documents a nivell d'empresa gestionats des de
  Configuració) no es consideren documentació de l'empresa en el sentit de Gestió Documental:
  són metadades de la pròpia configuració, no un justificant vinculat a una operació o a una
  fitxa. Es guarden en una carpeta pròpia, separada de les que llegeixen Fitxers Mestres i
  Operacions.
- **Els fitxers pendents d'ingesta automàtica** (factures o nòmines que han arribat soles, per
  exemple per correu, però que l'usuari encara no ha revisat ni incorporat com a document
  comptable) són, per definició, documents **encara no incorporats** a cap operació ni fitxa —
  per això Gestió Documental no els mostra. Són accessibles des del "Repositori Pendents" propi
  d'aquesta ingesta automàtica (vegeu `doc_ingesta_documents_comptables`), no des de Gestió
  Documental. Un cop l'usuari incorpora el document (per exemple, en validar la factura de
  compra que se n'ha generat), passa a ser un document d'operació normal i des d'aquell moment
  sí que és visible des de Gestió Documental.

Si un usuari pregunta per què no troba el logotip o una factura acabada d'arribar per correu a
Gestió Documental, cal explicar aquest disseny — no és un error ni un forat de cobertura.

### Mòdul llicenciable

Tot el bloc de Gestió Documental (les dues pantalles del menú, i també els endpoints genèrics de
pujada/baixada de blobs que fan servir la resta de pantalles de l'aplicació) està condicionat a
un mòdul de subscripció separat. Una empresa sense aquest mòdul actiu no hi té accés, encara que
tingui contractades altres funcionalitats.

## comprovacions
Si un document pujat no apareix a Fitxers Mestres:
- comprova que s'hagi pujat des d'una fitxa (no des de la configuració general de l'empresa);
- comprova que la fitxa encara existeixi (si no, hauria d'aparèixer com a orfe, no absent).

Si un document pujat no apareix a Operacions:
- comprova que s'hagi triat el Tipus de document i l'Exercici correctes;
- comprova el rang de dates i el filtre de compte, si n'hi ha algun d'actiu;
- recorda que un filtre de compte actiu descarta els documents orfes (no es pot saber a quin
  compte pertanyien).

Si l'usuari pregunta pel logotip de l'empresa o per un fitxer encara pendent d'incorporar de la
ingesta automàtica: cap de les dues pantalles de Gestió Documental el mostrarà mai — no és un
error, és fora del seu abast per disseny (vegeu la secció anterior).

Si l'usuari pregunta pel límit de mida i esmenta "512 KB": aclarir que aquest valor és el límit
del logotip de l'empresa, no el de Gestió Documental — el de Gestió Documental és 5 MB.