docs: 認可制御のドキュメントを整備

[laminne]

close #10

related: pulsate-dev/pulsate#1410

[MikuroXina]

Actor の定義は網羅的にしておきたいです. 利用者のアカウントの他に, 特権的な管理者がある感じでしょうか?

[laminne]

cli等から起動できる管理系タスクが実装される可能性があるかなと思ってこう書いていますが，現時点では予定がないのでAccountのみにしておきます

[MikuroXina]

行う操作の名称として, read や write などの形に限定しておいたほうが命名規則がぶれずに済みそうです.

[MikuroXina]

引数と戻り値の形から, isAllowed というメソッド名は boolean を返しそうに見えて違和感を覚えます. また, 結局のところそのチェックと実際の操作が分離してしまうので少しもったいないと感じます.
以下のように, Policy クラスはコンストラクタに操作対象, actor, action, resource を受け取るようにして, withCheck を介することでチェック付きの操作ができるようにしてみてはどうでしょうか.

const policy = new Policy(target, actor, action, resource);

const result = policy.withCheck((target) => {
  // 特権的な処理の実行
  const res = target.privilegeAction(/* ... */);
  if (Result.isErr(res)) {
    return res;
  }
  const foo = Result.unwrap(res);
  // 特権的な処理の結果の利用 ...
  return Result.ok(/* ... */);
});

if (Result.isErr(res)) {
  return res;
}
// 特権的とは関係ない処理 ...