På de fleste redaktioner er det ikke den, der uploader siderne, som godkender dem. Version 1.0 af Inkfold havde kladder og udgivne udgaver og forlod sig på, at folk talte sammen ind imellem. Version 1.1 tilføjer det, redaktioner faktisk gør: send til godkendelse, returnér med en note, udgiv.
En tredje status, ikke et ekstra flag
Det er fristende at tilføje en boolesk “skal godkendes” ved siden af statussen. Vi tilføjede i stedet en tredje værdi til selve statussen: kladde, til godkendelse, udgivet. En boolesk værdi ville tillade umulige kombinationer, som en udgivet udgave, der skal godkendes, og hver forespørgsel skulle huske at tjekke begge. Med ét felt virker den eksisterende regel om, at kun udgivne udgaver med passeret udgivelsestid er synlige for læserne, fortsat uændret: en udgave til godkendelse er simpelthen ikke udgivet.
To kolonner følger statussen: hvem der sendte udgaven til godkendelse, og godkenderens note. Noten ryddes, når udgaven sendes igen eller udgives, så en gammel bemærkning aldrig forvirrer næste runde.

Roller bygget af små rettigheder
Roller er lister af rettigheder, og ruter grupperes efter rettighed, ikke efter rollenavn. Ved at dele den gamle rettighed “administrér udgaver” i tre blev den nye rolle næsten gratis:
- stories.edit — åbn udgaver og sider, tegn og ret artikelområder, send til godkendelse.
- issues.manage — opret udgaver, upload, importér, omsortér og slet sider.
- issues.publish — udgiv, planlæg, afpublicér, godkend eller returnér.
En sideuploader har de to første, en redaktør alle tre, og den nye korrekturlæser kun den første: vedkommende kan rette en stavefejl i en rubrik eller en forkert placeret boks, men kan ikke uploade, slette eller udgive. Visningerne bruger de samme rettigheder, så en korrekturlæser aldrig ser en uploadformular, der ikke kan sendes.

Overgange, der nægter at gå galt
Hver overgang tjekker sin startstatus på serveren: kun en kladde kan sendes til godkendelse, og kun en udgave til godkendelse kan returneres. En udgave uden sider kan slet ikke sendes. Udgivelse virker fra kladde eller godkendelse, så en redaktør stadig kan udgive direkte klokken to om natten. Når udgaven går live, får læsere, der har bedt om det, én e-mail, et trin vi beskriver i seriens sidste indlæg.
Testet pr. rolle
Hver rolle har en featuretest, der gennemgår flowet og prøver de forbudte ruter: uploaderen sender en udgave til godkendelse og kan ikke returnere den, redaktøren returnerer den med en note, som uploaderen derefter ser, og korrekturlæseren retter en rubrik, men får 403 ved upload, sletning og udgivelse.
Det vigtigste
- Modellér flowet som tilstande i ét felt, så umulige kombinationer ikke kan opstå.
- Definér roller som lister af små rettigheder, og beskyt ruter efter rettighed.
- Valider hver overgangs startstatus på serveren.
- Test hver rolle mod de ruter, den ikke må nå.
Tidligere i serien: en artikelmapper styret med tastaturet. Log ind som redaktør i Inkfold-demoen for at se en udgave, der venter på godkendelse; softwaren fås hos Charming Theme.
Har du brug for godkendelsesflows eller finmaskede roller i din Laravel-applikation? Lad os tale sammen — ArtinTech Solution bygger dem hver måned.