> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Collezione Project History Sharded Blobs

`projectHistoryShardedBlobs` contiene i record dei blob che non sono entrati in [projectHistoryBlobs](https://ayakaleaf-pro.mintlify.site/dev/data-model/project-history-blobs-collection.md): quando il bucket di un prefisso di hash ha già 8 record lì, i successivi finiscono qui. Un progetto vi ha al massimo 16 documenti, uno per prima cifra esadecimale dell’hash. Non esiste uno schema Mongoose; history-v1 la scrive in `services/history-v1/storage/lib/blob_store/mongo.js` (struttura descritta in `mongo.js:1-16`).

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | Binary | 13 byte: l’id della cronologia del progetto, un `0`, e la cifra dello shard, letta come esadecimale (`<history id>0<digit>`). La cifra dello shard è la prima cifra esadecimale dell’hash. | `mongo.js:439-453` |
| `blobs` | Object | Record dei blob raggruppati in bucket. La chiave di un bucket sono le cifre esadecimali da 2 a 4 dell’hash. | `mongo.js:439-443` |
| `blobs.<bcd>` | Array of Object | I record del bucket. Il codice non ne limita la dimensione. | `mongo.js:399-407` |
| `blobs.<bcd>[].h` | Binary | L’hash, 20 byte, come in projectHistoryBlobs. | `mongo.js:472` |
| `blobs.<bcd>[].b` | Number | Lunghezza del contenuto in byte. | `mongo.js:473` |
| `blobs.<bcd>[].s` | Number | Lunghezza del contenuto come testo; `null` quando il contenuto non è testo modificabile. | `mongo.js:474` |

#### Chi la scrive

| Codice | Cosa fa |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:399-407` | `insertRecordSharded`: upsert con `$addToSet` nel bucket. Chiamato da `insertBlob` quando il bucket in projectHistoryBlobs è pieno (`mongo.js:387-389`). |
| `mongo.js:75-103` | `clone`: copia gli shard del progetto in un altro id della cronologia, per history-v1 `POST /projects/:project_id/clone`, che nulla in web chiama. |
| `mongo.js:413-422` | `deleteBlobs`: elimina tutti gli shard del progetto insieme al suo documento projectHistoryBlobs, su history-v1 `DELETE /projects/:project_id`. |

#### Chi la legge

| Codice | Cosa fa |
| - | - |
| `mongo.js:144-157` | `findBlobSharded`: un blob, cercato solo quando il suo bucket in projectHistoryBlobs ha 8 record e non lo contiene (`mongo.js:127-131`). |
| `mongo.js:217-260` | `findBlobsSharded`: i blob che `findBlobs` non ha trovato in projectHistoryBlobs (`mongo.js:202-206`). |
| `mongo.js:285-306` | `getProjectBlobs`: tutti gli shard di un progetto. |
| `mongo.js:337-361` | `getProjectBlobsBatch`: tutti gli shard di più progetti, per la route delle statistiche dei blob. |

#### Indici

Solo l’indice predefinito `_id`. Nessuna migrazione in `tools/migrations/` ne aggiunge uno.

#### Note

* Gli shard di un progetto stanno uno accanto all’altro nell’ordine di `_id`, quindi il codice li trova con un intervallo di `_id` da `<history id>00` a `<history id>0f` (`mongo.js:75-80`, `287-295`).
* La collezione compare solo quando un progetto ha più di 8 blob con lo stesso prefisso di hash di 3 cifre, quindi un’istanza piccola potrebbe non averla affatto.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.