# IDEA.md – ett eget verktyg för att samla och lägga ut material från nätet Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen implementation. Den bygger på Clipper, ett verktyg för att samla text och bilder från nätet och lägga ut dem fritt på ett rutnät, byggt med Claude Code. ## 1. Vad som ska byggas Ett webbverktyg med inloggning där man samlar material från nätet och ordnar det fritt. Förebilder: Fabric och Are.na. Användningsfall: research inför köp (produkter med pris och specifikationer), moodboards, och instudering med vändkort. I Clipper: - **projekt med dokument**, och varje dokument är ett rutnät. Man drar över tomma rutor för att markera en yta, och kan flytta och ändra storlek på blocket efteråt - **dokument och tavlor**: ett dokument har 1–12 kolumner och läsbredd, en tavla 24, 48 eller 96 kvadratiska rutor över hela fönstret, med zoom. Samma sak sedd genom olika rutnät, och det går att byta - **sju blocktyper**: text i Markdown (med färglagda kodblock), bild, checklista, PDF, ljud, vändkort och krypterade block - **inklistrad adress** blir ett bildblock och ett textblock med titel, beskrivning, pris och specifikationer - **ett Chrome-tillägg**: en panel ifylld från sidan (Alt+C), och högerklick för markerad text eller en bild - grupper, flerval, kopiera och klistra, ångra, överlapp per dokument, färger per dokument - **delning** via e-postadress (läsa eller redigera), inbjudan för adresser utan konto, och en publik länk - arkiv, sökning, utskrift, export, mörkt läge, hemskärmsapp på iPad - **en användare ser bara sin egen data**, och ingen självregistrering ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **Webbläsaren**: React 18, Vite och TypeScript. - **Servern**: PHP 8.3 utan ramverk, med mysqli och MariaDB. En `php:8.3-apache`-container för utveckling, Apache och PHP direkt i produktion. - **Viktigt: ren logik i egna moduler.** Placering, ångra, flerval, kopiering, färgläggning – allt som går att prova utan webbläsare – i moduler som inte importerar React eller något webbläsarbundet. Då kan Node köra testerna direkt (`node --experimental-strip-types`), utan byggsteg. - **Viktigt: rutnätet i CSS Grid** med explicit `col_start/col_span/row_start/row_span` och rader med fast höjd. Ett block är exakt den yta man ritade. - **Läsningen av en sida på två ställen**: på servern för inklistrade adresser och i tillägget för panelen. Samma frågor, samma ordning, och en rättelse i den ena har en självklar motsvarighet i den andra. - **Filer utanför docroten**, serverade bara av ett skript efter en ägarskaps- eller delningskontroll. Vad en fil är avgörs av dess byten, aldrig av namnet. - **All utgående HTTP genom en enda funktion** med reglerna mot SSRF. - **Publika id:n**: inget numeriskt id lämnar servern. ## 3. Beslut som visade sig avgörande **Läs sidan i fallande tillförlitlighet.** JSON-LD (schema.org) först, sedan Open Graph, sist markupen – spec-tabeller, definitionslistor, bilder. Välj bild efter poäng: `og:image` först, sedan störst yta. Läs måtten ur bildadressen (`_SL1500_`, `800x600`, `?w=1200`) och låt en alt-text som namnger det sidan handlar om väga tungt. Sortera bort logotyper, ikoner och spårpixlar. Ta ett pris bara där sidan anger det som pris. **Textblock växer sin egen ruta.** Låt inte raderna växa med texten – då sträcks varje block bredvid. Låt blocket mäta hur mycket det klipper och växa själv. **Mät layout i stället för att påstå den.** Rendera den riktiga stilmallen och den riktiga markupen i en webbläsare utan fönster och läs tillbaka talen. **Kryptera i webbläsaren.** PBKDF2-SHA256 gör lösenordet till en AES-GCM-nyckel; servern lagrar bara salt, iv och chiffertext, och kontrollerar formen så att klartext inte kan smyga in i ett block som påstår sig vara krypterat. Lösenordet lämnar aldrig datorn och kan inte återställas. **Vändkort med texten så stor som möjligt.** Sök fram storleken med halveringssökning mot frågan "spiller det över nu?", som en ren funktion över ett predikat. **Delning som en nivå, inte ja/nej.** Åtkomsten är `owner`, `edit` eller `view`. Redigerare ändrar innehållet; att radera, flytta, dela vidare och slå på publik länk är ägarens. En inbjudan är en delning som ännu saknar konto. **"Kom ihåg mig" i en egen tabell** med `selector:validator`, där bara hashen av validatorn lagras, rotation vid varje användning och stöldindikation – med ett nådafönster för den förra hemligheten. ## 4. Fallgropar - **Byggutdata utanför den monterade katalogen.** Pekar Vite utdatan en nivå upp och bara webbappens katalog är monterad i byggcontainern, försvinner allt när containern avslutas – fast bygget ser ut att lyckas. Montera projektroten. - **`php:8.3-apache` har `AllowOverride None`**, så `.htaccess` ignoreras och SPA:ns djuplänkar slutar fungera. - **Rader som växer med innehållet** sträcker grannarna. Fasta rader, och låt blocket växa. - **Alla bildkandidater med samma poäng** gör att dokumentordningen avgör – och en reklambanner vinner. - **Den renderade bildadressen är ofta en miniatyr.** Ett galleri namnger originalet i ett eget attribut. - **HTML i JSON-LD.** Butikers beskrivningar innehåller taggar; städa dem, och låt en tagg bli ett mellanrum, inte ingenting. - **Parallella anrop och roterande kakor.** En sidladdning skickar flera anrop med samma kaka; utan nådafönster loggar en omladdning ut. - **En utgången session ger fel CSRF-token** även på inloggningen. Hämta en färsk token och försök en gång till. - **PHP:s förvalda session är 24 minuter.** Sätt `session.gc_maxlifetime` och en egen `session.save_path`. - **Chrome sparar ett lösenord per adress och användarnamn.** Flera verktyg på samma domän krockar; låt ett prefix (`clipper/namn`) skalas av vid inloggning. - **`"type": "module"` i en rot-`package.json`** gör varje `.js` under den till ESM och kan tyst bryta CommonJS-filer som testerna läser. - **En hemskärmsapp på iPad delar inte kakor med Safari.** Första starten kräver en ny inloggning. ## 5. Krav och mätningar - En användare ser aldrig någon annans data – prövat i rökprovet. - Inget numeriskt id i något svar. - Krypterat innehåll är oläsbart i databasen och i en export. ## 6. Så verifieras det - Typkontroll och lint i bygget; ett lint-fel stoppar bygget. - Enhetstester i Node för rutnätet, ångra, grupper, kopiering, vändkortets storlekssökning, färgläggning och hur en urklippning formuleras. - Layouttester i en webbläsare utan fönster mot den riktiga stilmallen. - Sidläsningen mot fixturer, både på servern och i tillägget. - Ett rökprov från början till slut mot en utvecklingsinstans: inloggning, sessioner, rutnät, tavlor, överlapp, grupper, färger, urklipp, vändkort, kryptering, bilder, arkiv, delning, inbjudan och dataisolering. ## 7. Arbetssätt - **En ärendebräda**, ett ärende i taget, med verifieringen i den avslutande kommentaren. - **Skriv ner designvalen och varför** i README, så att nästa ändring inte gör om ett beslut som redan prövats. - **Varje schemaändring på två ställen**: en numrerad migration och samma ändring i hela schemat. ## 8. Prompten > Bygg ett webbverktyg där jag samlar text och bilder från nätet och lägger ut dem fritt på ett rutnät: projekt med dokument och tavlor, block av typerna [text, bild, checklista, vändkort och krypterade block], inklistrade adresser som blir bild, pris och specifikationer, och ett [Chrome]-tillägg. [React och Vite] i webbläsaren och [PHP utan ramverk med MariaDB] på servern, med inloggning och delning. > > Läs hela IDEA.md nedan först. > > Arbeta så här: > 1. Dela upp bygget i ärenden och fråga mig om det som är öppet. > 2. Lägg all logik som går att prova utan webbläsare i egna moduler med egna tester, och mät layouten i en riktig webbläsare. > 3. Skriv ett rökprov från början till slut, och kör allt efter varje ändring. > > [klistra in IDEA.md här]