Sjálfsbestun kóðabálks

Þú ert að framkvæma sjálfsbestunar-úttekt á kóðabálki. Verkefnið er að skilja mynstur verkefnisins, andmynstur, högunarákvarðanir, venjur tæknistaflans og bilunarform — og skila svo stillingum og skjölun sem gerir hverja framtíðarlotu með gervigreind áhrifaríkari.

Þú sinnir tveimur hlutverkum samhliða:
1. Sjálfsbestun — úttekt á gervigreindarstillingum verkefnisins, réttmæti skjölunar og stoðtólum.
2. Högunarkortlagning — sjónrænt kort af íhlutum kerfisins, tengslum, háðum pökkum og gagnaflæði.

FASI 1 — KÖNNUN
Taktu verkefnið út kerfisbundið. Fyrir hvert svið skaltu vísa í tilteknar skrár og línunúmer:
- Tæknistafli, umgjörð, tungumál og val á útgáfum (lestu package.json / pyproject.toml / Cargo.toml)
- Möppuskipan og högunarmynstur (skýrt tré)
- Nafnavenjur, kóðastíll, innflutningsmynstur (með dæmum um frávik)
- Prófastefna (umgjörð, fjöldi með því að keyra prófin, þekja, hvar prófin liggja)
- Byggingar- og útgáfuferli (CI/CD-stillingaskrár)
- Git-mynstur (greinastefna út frá nýlegri sögu, stíll á færslum, PR-venjur)
- Fyrirliggjandi skjölun og göt hennar (sannreyndu fullyrðingar í README og skjölum gegn raunverulegum kóða)
- Þjónustur, gagnageymslur, API-mörk, auðkenningarferli, tengingar við þriðja aðila

FASI 2 — STILLINGAR
Skilaðu eða uppfærðu skjölun verkefnisins sem inniheldur:
- Sjálfsmynd verkefnisins (tæknistafli, högun í 2–3 línum)
- Framkvæmdastaðla (stíll á færslum, kröfur um próf, kóðavenjur)
- Skráa- og möppukort (hvað liggur hvar, hvað má ekki snerta)
- Skrá yfir andmynstur: fyrir hvert, slóð skrárinnar, hvað er að og hvert rétta mynstrið er
- Venjur um innflutning og háða pakka, með réttum og röngum dæmum
- Skipanir fyrir próf, byggingu, keyrslu og útgáfu (staðfestar með því að lesa skriftur í package.json)

FASI 3 — HÖGUNARKORT
Skilaðu Mermaid-myndritum fyrir:
- Kerfisskipan (þjónustur, gagnageymslur, ytri tengingar)
- Gagnaflæði fyrir hverja meginleið (beiðni → vinnsla → geymsla)
- Stefnu háðra pakka milli laga í högun

Skilaðu einnig töflu yfir íhluti: þjónustur, gagnageymslur, API-slóðir, ytri pakkar. Merktu hvern íhlut með vissu: staðfest, ályktað eða óvíst.

FASI 4 — SANNPRÓFUN
- Taktu 5 eða fleiri fullyrðingar úr skjölun og berðu saman við kóðann (sýndu fullyrðinguna, skrána sem þú skoðaðir og hvort hún sé rétt, úrelt eða röng)
- Staðfestu að högunarkortið nái yfir allar þjónustur, slóðir og gagnageymslur sem hægt er að finna
- Staðfestu að gagnaflæðin passi við raunverulegar innflutningskeðjur með því að rekja 3 eða fleiri leiðir

FASI 5 — HEILSUEINKUNN OG SKJÓTUR ÁVINNINGUR
Gefðu verkefninu einkunn 1–10 fyrir hversu tilbúið það er fyrir gervigreind, með rökstuðningi.

Skilaðu forgangsraðaðri töflu yfir „fimm mestu skjótu ávinningana":
| # | Lagfæring | Skrá | Vinna | Áhrif |

Þetta eiga að vera lagfæringar undir 30 mínútum hver með mest áhrif á heilsu verkefnisins eða upplifun þeirra sem vinna í því.

TAKMARKANIR:
- Ekki breyta frumkóða, prófum eða stillingum
- Sérhvert andmynstur verður að styðjast við sönnun úr kóðanum eða git-sögunni, ekki ágiskun
- Haltu skjöluninni þéttri — mikilvægustu reglurnar fremst
- Staðfestu útgáfunúmer og prófatalningar með því að athuga þau sjálfur, ekki treysta fyrirliggjandi skjölun

VERKEFNI TIL ÚTTEKTAR:
{{Límdu inn slóð verkefnisins eða lýstu því sem þú vilt besta}}