LinkShare Project Handbook v31

Projekthandbok för Länksida v1.0, en modererad länkdelningsplattform med dagssidor, kommentarer, rapportering, favoriter och admin/moderatorflöden.

Läsordning

1. docs/00-Projektoversikt.md
2. docs/00-Snabbstart.md
3. docs/00-Beslut.md
4. docs/00-Versionshistorik.md
5. docs/25-Business-Rules.md
6. api/API-Spec.md
7. openapi/openapi.yml
8. database/schema.prisma
9. docs/32-Definition-of-Done.md
10. docs/33-Systemkonstanter.md
11. docs/Constants.md
12. docs/35-Moderation-State-Machine.md
13. docs/23-Implementation.md

Dokumenthierarki

Dokumenten ska läsas enligt denna hierarki när något verkar motsäga något annat:

1. docs/25-Business-Rules.md = vad systemet ska göra och vilka regler som gäller.
2. docs/33-Systemkonstanter.md = regelkritiska gränsvärden och tidsfönster.
3. database/schema.prisma = datamodellen och databaskontraktet.
4. api/API-Spec.md och openapi/openapi.yml = API-kontraktet, mänskligt respektive maskinläsbart. Dessa två ska hållas synkade.
5. adr/ = varför större beslut togs.
6. Övriga dokument = stöd, förklaring och implementation.

Om en affärsregel skiljer sig mellan dokument gäller alltid docs/25-Business-Rules.md. Om API-specifikationen och OpenAPI-filen skiljer sig ska båda korrigeras så att de åter speglar samma kontrakt.

Projektstatus

✔ Arkitektur fryst
✔ Databas fryst
✔ API fryst
✔ Dokumentation fryst

Nästa steg:
➡ Implementation
➡ Testning

v31 ändringar

• ADR-0031 tillagd för immutable scheduledFor efter publicering.
• DayPage förtydligad som datumrepresentation; länkar kopplas via scheduledFor.
• Metadata-refresh får aldrig ändra användargenererade data.
• docs/Constants.md tillagd som engelsk alias/samlingssida för systemkonstanter.
• API-specen har fått tydlig endpoint-scope-tabell för MVP respektive Post-MVP.
• Skillnaden mellan hiddenAt, removedAt, archivedAt och deletedAt är dokumenterad.

MVP-status

MVP omfattar:

• Dagssidor
• Länkinskick
• Favoriter
• Kommentarer
• Rapportering
• Violations
• Appeals

Ingår inte i MVP:

• Trendande
• Taggar
• Pinning
• Boosting

v25 ändringar

• Adminpanelen använder inte längre aktivt trendScore eller trendande länkar i MVP.
• mostClicked definieras som klick på aktuell dagssida.
• Klick registreras via LinkShares redirect-endpoint.
• Opublicerade framtida dagssidor är endast synliga för moderatorer och administratörer.
• Modereringshistorik visar som standard endast rollnamn, inte moderatorns användarnamn.
• Implementation-status har kompletterats med tydlig statusmatris.

v24 cleanup

• Förtydligade att varje datum endast får ha en dagssida.
• Förtydligade retry-krav om publiceringsjobbet misslyckas kl. 00:00.
• Förtydligade att felaktiga eller återkallade violations inte räknas som aktiva och att status räknas om.
• Metadata-fallback ändrad till URL som sista utväg.
• Revisionslogg/adminlogg är uttryckligen append-only, ej redigerbar och endast läsbar.
• Lade till Current Project Status i README.

v23 cleanup

• docs/33-Systemkonstanter.md är tillagd som single source of truth för gränsvärden.
• Modereringsstatus har fått state machine i docs/35-Moderation-State-Machine.md.
• Dagssidor stödjer uttryckligen retroaktiv publicering utan att påverka senare datum.
• Favoriter till borttagna länkar tas bort automatiskt.
• Metadata-cache och refresh-regel är dokumenterad.
• Klickstatistik räknar varje redirect/click-request i MVP, utan deduplicering.
• Definition of Done kräver ADR-referenser.

v22 cleanup

• README förtydligar dokumenthierarkin.
• Business Rules markeras tydligare som normativ källa.
• docs/23-Implementation.md är ersatt av docs/23-Implementation.md.
• docs/32-Definition-of-Done.md är tillagd.
• adr/README.md är tillagd som ADR-index.
• Versionshistoriken markerar v21 som dokumentationsfreeze före implementation.

v21 cleanup

• Systemterminologin är rensad: det heter alltid Violation.
• Reputation är förenklat till approvedLinksCount.
• Trendande är flyttat till post-MVP.
• Rate limits är specificerade.
• Dagssideflödet är specificerat.
• Favoriter kan inte exporteras.
• Klickstatistik räknas per användare.
• README, adminpanel och violation/restriction-begrepp är förtydligade.
• Spärrlogik uttrycks konsekvent som summan av aktiva Violation.points.

Varje kalenderdatum representerar exakt en dagssida. Dagssidan existerar även om den innehåller noll publicerade länkar.