多くの編集部では、紙面をアップロードする人と承認する人は別です。Inkfold 1.0には下書きと公開済みの号しかなく、その間はスタッフ同士の声かけに頼っていました。1.1では、編集部が実際に行っていることを加えました。確認に回す、メモを付けて差し戻す、公開する、の3つです。
フラグを増やすのではなく第3の状態に
ステータスの横に「確認が必要」というブール値を足したくなりますが、私たちはステータスそのものに3つ目の値を加えました。下書き、確認中、公開済みです。ブール値だと「公開済みなのに確認が必要」のような矛盾した組み合わせが生まれ、すべてのクエリで両方を確認しなければなりません。フィールドが1つなら、「公開済みで公開時刻を過ぎた号だけが読者に見える」という既存のルールは何も変えずに機能します。確認中の号は単に公開されていないからです。
状態とともに2つの列を持ちます。誰が確認に回したかと、確認者のメモです。メモは号が再提出されたときか公開されたときに消去されるので、古い指摘が次の確認を混乱させることはありません。

小さな権限を組み合わせたロール
ロールは権限のリストで、ルートはロール名ではなく権限ごとにまとめています。以前の「号の管理」権限を3つに分けたことで、新しいロールはほぼ手間なく作れました。
- stories.edit — 号とページを開き、記事エリアを描いて修正し、確認に回す。
- issues.manage — 号を作成し、ページのアップロード、取り込み、並べ替え、削除を行う。
- issues.publish — 公開、予約、公開取り消し、確認の承認や差し戻しを行う。
ページアップロード担当は最初の2つ、編集者は3つすべて、新しい校閲者は最初の1つだけを持ちます。見出しの誤字や位置のずれた枠は直せますが、アップロード、削除、公開はできません。画面も同じ権限で表示を切り替えるので、校閲者が送信できないアップロードフォームを目にすることはありません。

間違いを拒む状態遷移
それぞれの遷移はサーバー側で開始状態を確認します。確認に回せるのは下書きだけで、差し戻せるのは確認中の号だけです。ページのない号はそもそも確認に回せません。公開は下書きからも確認中からもできるので、編集者は深夜2時でも直接公開できます。号が公開されると、希望した読者にメールが1通届きます。この仕組みはシリーズ最終回で紹介します。
ロールごとにテスト
各ロールには、フローをひと通りたどり、禁止されたルートを試す機能テストがあります。アップロード担当は号を確認に回せても差し戻しはできず、編集者がメモ付きで差し戻すとアップロード担当にそのメモが表示されます。校閲者は見出しを直せますが、アップロード、削除、公開では403が返ります。
ポイント
- ワークフローは1つのフィールドの状態として表し、矛盾した組み合わせを生まない。
- ロールは小さな権限のリストとして定義し、ルートは権限で守る。
- すべての遷移の開始状態をサーバーで検証する。
- 各ロールが到達してはいけないルートをテストする。
シリーズ前回はキーボードで操作できる記事マッパーでした。Inkfoldのデモ に編集者としてログインすると、確認待ちの号を見られます。ソフトウェアは Charming Theme で入手できます。
Laravelアプリケーションに承認フローや細かな権限管理が必要ですか?ご相談ください — ArtinTech Solution は毎月のようにこうした機能を構築しています。