El sistema està construït i verificat; falta l'últim acte de l'ofici: lliurar-lo. Lliurar no és enviar un ZIP — és aconseguir que una altra persona pugui instal·lar-lo sense tu, entendre què fa i per què, i veure en deu minuts que funciona. En aquesta lliçó escriuràs el README definitiu, prepararàs una demostració amb guió, redactaràs l'informe de dades com a lliurable de negoci (amb la comanda de Sant Jordi com a model), t'avaluaràs amb una rúbrica honesta i faràs la retrospectiva que converteix l'experiència en aprenentatge. I com que aquesta és l'última lliçó del curs, acabarem on s'ha d'acabar: mirant el camí complet des del print("Hola, món!") fins aquí, i decidint — amb criteri — quin és el teu proper pas.

1. Documentar per a altres: el README complet
2. La demostració: un guió de 10 minuts
3. L'informe final de dades com a lliurable
4. Autoavaluació honesta: la rúbrica
5. Retrospectiva personal: cinc preguntes
6. Extensions possibles, ordenades per dificultat
7. El viatge complet: de M1 a M12
8. Propers passos amb criteri
9. Papyrus era teu des del principi

El README és la porta del projecte: s'escriu per a algú que no hi era (inclòs el teu jo d'aquí a sis mesos, que tampoc hi serà). La prova de foc és literal: una altra persona, només amb el README, arrenca el projecte sense fer-te ni una pregunta. Plantilla real, secció a secció:

Dos detalls que separen un README professional d'un d'ornamental: l'exemple d'ús copiable (el curl amb la seva resposta esperada: qui l'enganxa i veu el 18.67 ja confia en el projecte) i la secció de limitacions conegudes — documentar el que falta no és debilitat, és criteri; tot el software real la porta, encara que no sempre escrita.

Una demo sense guió ensenya pantalles; una demo amb guió explica una història. La història de Papyrus Online és "de la venda a la dada", i aquest ordre l'explica:

Tres consells de demo: assaja-la una vegada sencera (la demo que no s'assaja, falla — llei empírica), tingues les ordres ja escrites en un fitxer per enganxar-les (teclejar en viu és llençar minuts), i ensenya una fallada controlada a propòsit: res no genera més confiança que un sistema rebutjant netament una venda impossible. Que no tens audiència? Grava't la pantalla seguint el guió. La disciplina d'explicar-ho en veu alta delata cada racó que no entens del tot — és autoavaluació disfressada de teatre.

L'informe de RF6 no és un script que imprimeix números: és un document de negoci que l'Anna pugui llegir un dilluns al matí. El lliurable (un Markdown o PDF amb el PNG incrustat) ha de contenir exactament tres coses:

1. Els números del període: total d'unitats i quantia, top 3 de títols, millor dia de la setmana, evolució mensual. Amb vendes_2026.csv: 520 unitats al semestre, dissabte com a rei (130 u), abril desbocat (168 u).
2. El gràfic: un, no sis. El que millor explica la història del període (la barra mensual amb l'abril sobresortint, la de M11).
3. Una recomanació accionable — la part que gairebé tothom omet i la que dona valor a tota la resta. El model és la comanda de Sant Jordi de 11-05:

«La regressió (MAE ±1.1 u/dia) projecta 172 unitats per a l'abril de 2027. Recomanació: comanda de 190 unitats (projecció + marge del ~10 %), repartida en dues quotes — 120 a principi d'abril, 70 la setmana prèvia a Sant Jordi — per limitar el risc de sobreestoc. Vigilar Faust: 210 visites i un 11.9 % de conversió suggereixen revisar-ne el preu abans de la campanya.»

Fixa't en l'anatomia: dada → recomanació concreta (amb número) → gestió del risc → decisió que queda en mans de l'Anna. Els models recomanen; les persones decideixen — la regla d'or de M11 també es lliura per escrit.

Sense professor, la nota te la poses tu — raó de més perquè l'escala sigui explícita. Avalua cada dimensió i anota el nivell a DECISIONS.md:

Interpretació honesta: "Suficient" en tot ja és un èxit enorme — un sistema complet construït en solitari. "Bo" és l'estàndard professional raonable. "Excel·lent" és aspiracional: si ho has marcat tot excel·lent, o ets molt bo o has estat poc honest — i la rúbrica només serveix amb el segon descartat.

L'experiència no ensenya; l'experiència examinada ensenya. Tanca DECISIONS.md responent per escrit, amb calma:

1. Què m'ha costat més del que esperava? (Assenyala la teva propera àrea d'estudi.)
2. Què m'ha costat menys del que esperava? (Assenyala una fortalesa que potser no sabies que tenies.)
3. Quina decisió de disseny repetiria i quina no? (Revisa la teva taula de decisions de 12-02 amb la veritat del codi al davant.)
4. Quin ha estat el pitjor bug i què l'hauria evitat? (Un test abans, un contracte més clar, un tipus més ben definit…)
5. Què faria diferent si comencés demà? (La resposta és la teva llista personal de lliçons apreses — val més que qualsevol resum nostre.)

Les idees aparcades a 12-01 tenen ara el seu lloc. Cadascuna amb el que hauries d'aprendre — perquè "voler fer-ho" sense saber què implica és com estimar sense dades:

Regla per triar: una extensió, portada fins a acabada, ensenya més que tres a mitges. Ja saps per què: ho has après acabant aquest projecte.

Mira enrere un moment, perquè la distància recorreguda es veu millor des del final. A M1 vas escriure print("Hola, món!") i barallar-te amb el PATH era una aventura. A M2-M4 vas aprendre a pensar en control i estructures, i Papyrus era una llista amb quatre llibres. A M5 aquells llibres es van tornar objectes amb comportament; a M6 van sobreviure a un reinici; a M7 el sistema va aprendre a fallar amb elegància i a deixar-ne constància en un log. M8 et va donar les eines d'adult — type hints, decoradors, generadors, context managers — i M9 la que ho canvia tot: la capacitat de demostrar que el teu codi funciona. A M10 Papyrus va sortir al món per HTTP, dues vegades i de dues maneres. A M11 les seves dades van parlar: dissabtes de 130 unitats, un Sant Jordi de 168, un Faust que es mira i no es compra, una regressió que va projectar 172 i una llibretera que en va demanar 190. I a M12 no has après res de nou — has fet una cosa més difícil: ho has acoblat tot, sol, i funciona. Aquesta frase, fa dotze mòduls, era impensable. Aquesta frase és el curs.

"I ara què?" té millor resposta si la tries per interès real, no per moda. Tres itineraris segons el que més has gaudit:

Els tres comparteixen dos peatges: git (ja no hi ha excusa) i anglès tècnic (la documentació de veritat viu allà). I un consell transversal: a partir d'aquí s'aprèn construint — tria projectes una mica més grans que la teva comoditat, com ho ha estat aquest.

Una confessió final: Papyrus mai no va ser el tema del curs. Va ser un vehicle — prou petit per cabre en una lliçó, prou real per tenir estoc per quadrar, socis per validar i un Sant Jordi per planificar. El tema del curs eres tu treballant sobre la teva pròpia realitat. Així que l'últim exercici és obvi: mira la teva feina, el teu sector, el teu dia a dia. Què hi és, allà, el "catàleg"? Expedients, pòlisses, reserves, pacients, inventari? Què és la "venda amb regles": un càlcul amb descomptes, una validació amb excepcions, un procés que avui algú fa a mà? I quin informe li donaries a la teva "Anna"? Tot el que has construït aquí — capes, contractes, errors propis, tests, un CSV que es converteix en decisió — es trasllada tal qual. El primer projecte que facis sobre el teu domini serà més difícil que Papyrus, perquè ningú no et donarà els requisits numerats. També serà el que et canviï el perfil professional.

• Lliurar sense provar la instal·lació des de zero. Clona/copia el teu projecte a una altra carpeta, crea un venv nou i segueix el teu README al peu de la lletra. Fallarà en alguna cosa (una dependència no anotada, una ruta) — millor descobrir-ho tu que el teu lector.
• Demo sense assaig. El servidor que no arrenca, el JSON amb una coma de més… L'única vacuna és haver-la fet sencera una vegada abans.
• Informe de dades sense recomanació. Números sense decisió proposada és feina a mitges; la recomanació (amb el seu risc gestionat) és el que l'Anna no pot demanar-li a un full de càlcul.
• Autoavaluar-se a l'alça… o a la baixa. Inflar-se impedeix créixer; matxucar-se, continuar. La rúbrica existeix per treure't de tots dos llocs: nivell per dimensió, amb evidència.
• No tancar mai. Sempre hi haurà un refactor més, una extensió més. Els projectes es lliuren: versió 1.0, README honest amb limitacions, i el següent ja és la versió 2 — o el següent projecte.

1. Fita final — el paquet de lliurament. Completa el README amb la plantilla, verifica la instal·lació des de zero en un venv nou, i genera l'informe de negoci (números + PNG + recomanació) com a INFORME.md. Verificació: una persona de confiança (o tu mateix, en una altra màquina o una altra carpeta, seguint només el README) arrenca el sistema i executa els tests sense ajuda.
2. Fita final — la demo. Prepara el guió de 10 minuts amb les teves ordres en un fitxer demo.md, assaja-la una vegada completa i, si pots, grava-la o ensenya-la a algú. Verificació: l'executes sencera sense improvisar ni consultar res fora del guió.
3. Fita final — tancament i pas següent. Omple la rúbrica i les cinc preguntes de la retrospectiva a DECISIONS.md, tria el teu itinerari de la taula de propers passos i escriu la primera acció concreta amb data ("dissabte: curs bàsic de git"). Verificació: l'acció és tan concreta que dissabte sabràs exactament què obrir.

1. No hi ha solució per copiar: hi ha un senyal d'èxit — la persona que segueix el teu README no et fa cap pregunta. Cada pregunta que et faci és una línia que li falta al README; afegeix-la i considera l'exercici en curs fins que les preguntes siguin zero.
2. Orientativa: les fallades d'assaig més comunes són el servidor arrencat des de la carpeta equivocada (rutes relatives — 12-03 ho va avisar) i les dades "brutes" de proves anteriors; tingues un dades/ de demo net i preparat. Si en narrar un pas no saps explicar per què funciona, apunta-t'ho: és l'última lliçó del curs dient-te on repassar.
3. Exemple d'acció ben formulada: «Dissabte 10:00: tutorial oficial de git fins al branching; crear el repo de Papyrus Online i fer el primer commit amb la versió lliurada.» Mal formulada: «aprendre git aviat». La diferència entre l'una i l'altra és la mateixa que fa dotze mòduls que practiques: el verificable davant del vague.

S'ha acabat — i aquesta vegada no hi ha "a la propera lliçó". Vas començar aquest curs escrivint una línia que saludava el món i l'acabes amb un sistema complet que gestiona un negoci: domini amb regles i errors propis, persistència que no perd dades, una interfície que el serveix, una suite de tests que ho demostra i un informe que converteix vendes en decisions. Més important que qualsevol peça: has demostrat que pots rebre requisits, dissenyar, construir, verificar i lliurar sense que ningú et porti de la mà. Això no s'oblida com s'oblida una sintaxi; és un canvi de categoria. T'emportes un mètode (contractes abans que codi, validar-calcular-mutar, cada bug deixa el seu test, els models recomanen i les persones decideixen), un projecte real per ensenyar, i un mapa de passos següents triat amb criteri. La llibreria de l'Anna queda en bones mans — les teves són les que l'han construïda. Ara ves i fes-li al teu propi domini el que li has fet a Papyrus. Ha estat un privilegi acompanyar-te des del print("Hola, món!"). La resta del camí es recorre igual que aquest: una línia, un test i un projecte cada vegada. Bon viatge, i bon codi.