最初の実装を読む
ログインの先に住所がある
別々のアプリで「ログイン機能をつけて」と頼む。似た画面が返ってきても、中で何を選んだかは分からない。ログイン後の状態をどこで持つかも、どの処理でアクセス権を確かめるかも、コードに戻って初めて追える。1
前の章で決めたのは、会員が自分の住所を確認する操作だった。その場面でリクエストを受け取ったAPIは、まず相手が誰か確かめ、その人にどのデータを返してよいか決める。保存ボタンやフォームの見た目を直していても、この二つの判断は必要になる。
- 認証
- リクエストした人が誰かを確かめる。
- 認可
- その人が、指定したデータを読んだり操作したりしてよいかを確かめる。
会員を二人用意して読む
レビュー用に会員を二人用意する。まず自分の会員として住所を読めるところまで通す。次に、同じログイン状態から別の会員の住所を求め、相手の住所が応答に入らないことを確かめる。一つ目の試験を残しておけば、二つ目のために全員の閲覧を止めた場合にも気づける。
| 試す相手 | 要求する住所 | 確かめる結果 |
|---|---|---|
| 会員A | Aの住所 | Aの住所が返る |
| 会員A | Bの住所 | Bの住所が返らない |
| 未ログイン | Aの住所 | Aの住所が返らない |
注記
これはこの本で使うレビュー例。拒否時のエラーや、存在を知らせてよいかは、サービスの契約に合わせて決める。
次に似た機能を頼むとき
私もAIに何度も実装を頼んでいる。似た処理がすでにあると、今いるリポジトリの書き方に合わせてくる。一つ確かめた実装があれば、次の作業で参照できる。最初のAPIにアクセス権の確認が抜けていたら、次の機能でも同じ所が抜けることがある。
flowchart LR
A["最初の会員情報API"] --> B["本人に返る"]
A --> C["他人には返らない"]
B --> D["次の実装が参照"]
C --> D
レビューで先に読むのは、あとから繰り返される箇所だ。どのデータを選び、どこで返すものを決めたか。次の一つが同じ形で増えてもよいと判断できたら、そこで作業を広げていく。