Mappstruktur

Mappstruktur, eller katalogstruktur, avser hur filer och undermappar ordnas i ett filsystem eller i ett projektrepo. En väl genomtänkt mappstruktur underlättar att hitta, återanvända och underhålla filer samt stödjer samarbete och säkerhet. Grundprinciperna är en hierarkisk uppbyggnad där innehåll grupperas logiskt efter funktion, dataflöde eller livscykel, samt konsekventa namnkonventioner.

Topplivplatsen i strukturen speglar projektets domäner eller delar, ofta med mappar som src eller code för källkod, docs för dokumentation, tests för testfiler, data eller assets för resurser samt build eller dist för färdiga produkter. Inom varje del används undermappar för vidare indelning, till exempel src/komponent1 eller data/raw och data/processed.

Namnsättning och konventioner är centrala. Använd tydliga, beskrivande namn och enhetliga mönster. Vanliga praxis är att använda små bokstäver och separera ord med bindestreck eller understreck, samt undvika onödiga specialtecken. Att dokumentera mappstrukturen i en README-fil ökar förståelsen hos nya användare och bidrar till konsekvent användning.

Samarbete och behörigheter är ofta en del av övervägandena i teamsammanhang. Strukturen bör underlätta versionshantering (till exempel Git) och uppfylla säkerhetskrav, med tydliga regler för vad som lagras vart samt vad som ignoreras (till exempel via .gitignore) och vilka som har åtkomst till vilka kataloger.

Underhåll är viktigt för långsiktig relevans. Mappstrukturen bör granskas regelbundet och uppdateras när projektet växer eller förändras. Förändringar bör kommuniceras och dokumenteras för att undvika förvirring och dubbletter.