Dokumentation: Bildtävlingsmodul (v2.4)

Senast uppdaterad: 2026-09-20

1. Filstruktur & Systemarkitektur

Filnamn	Syfte & Funktion
index.php	Huvudportal. Startsidan för systemet som länkar till domarsidor, admin och resultat.
bild-setup.php	Installationsverktyg. Initierar systemet, skapar mappar och förbereder registry.json vid nyuppsättning.
bild-judge_form.php	Tävlingsval. Ingångssida för domare för att välja aktiv tävlingsklass.
bild-judge.php	Domargränssnitt. Hanterar röstning (I, K, T, O med dynamisk poängskala), bildvisning och jävshantering ("Egen bild"). Navigerar endast tillbaka till bild-judge_form.php.
bild-instruktioner.php	Domarinstruktioner. Pedagogisk guide och arbetsflöde för domare vid tävlingsbedömning.
bild-exif.php	Metadata-visare. Läser och listar EXIF-data (kameramodell, bländare, ISO etc.) för en bild via dess URL i tabellform.
bild-fetch-urls.php	Länkhämtare. Skript för att automatiskt hämta eller generera bild-URL:er och synkronisera dem till bild-urls.json.
bild-edit-links.php	Länk-editor. Admin-gränssnitt för att manuellt granska, lägga till eller redigera bildlänkar för en specifik tävling.
bild-adm-portal.php	Sekretariatets panel. Hanterar tävlingsinställningar, vote_limit, score_limit, viktning och status.
bild-adm-results.php	Admin-resultat. Beräknar snitt/totaler, tillåter redigering av omdömen och är optimerad för A4-utskrift.
bild-admin-vote-editor.php	Röst-editor. För manuell korrigering av enskilda domarröster vid behov.
bild-public-results.php	Publikt resultat. Visar medaljörer och poängställning för deltagare.

2. Logik för Poäng & Ranking

Systemet stöder flexibla bedömningsregler som ställs in per tävling i registry.json:

• Dynamisk Poängskala (score_limit):
  • Maxpoäng per kategori (I, K, T, O) konfigureras per tävling (t.ex. 5, 10 eller valfritt värde). Standardvärde är 10.
• Modell A: Fullständig bedömning (vote_limit: "all")
  • Samtliga bilder poängsätts av domarna.
  • Ranking: Baseras på Viktat Genomsnitt.
• Modell B: Urvalsbedömning (t.ex. vote_limit: 5)
  • Domaren väljer ut sina X bästa bilder.
  • Ranking: Baseras på Total Råpoäng (Viktad summa).
• Gemensam Tie-breaker: Om poängen är identisk används Oviktad totalpoäng (steg 1) och Antal domarröster (steg 2).

3. Digital Bildhantering & Jäv

• Bildvisning: Om bild-urls.json finns visas tumnaglar och fullbilder via Lightbox. Systemet fungerar även utan bildlänkar eller bildnamn.
• Metadata (EXIF): Genom bild-exif.php kan domare granska kameradata för digitala bidrag, förutsatt att datan inte rensats vid export.
• Egen bild (OWN): Domare kan markera bidrag som sina egna. Logiken sätter värdet till OWN, vilket exkluderar bilden från poängställningen och domarens röstkvot.

4. Teknisk konfiguration (JSON)

A. registry.json

{
  "tavling_id_1": {
    "name": "Årets Bild",
    "folder": "arets_bild_2026",
    "status": "active",
    "vote_limit": 5,
    "score_limit": 10,
    "weights": { "I": 1, "K": 1, "T": 1, "O": 1 }
  }
}

B. bild-urls.json

[
  {
    "name": "Bildnamn",
    "thumb": "https://url-till-miniatyr.jpg",
    "full": "https://url-till-fullbild.jpg"
  }
]

5. Versionshistorik

---