書架 超魔導 目次

最初の実装を読む

ログインの先に住所がある

別々のアプリで「ログイン機能をつけて」と頼む。似た画面が返ってきても、中で何を選んだかは分からない。ログイン後の状態をどこで持つかも、どの処理でアクセス権を確かめるかも、コードに戻って初めて追える。1

前の章で決めたのは、会員が自分の住所を確認する操作だった。その場面でリクエストを受け取ったAPIは、まず相手が誰か確かめ、その人にどのデータを返してよいか決める。保存ボタンやフォームの見た目を直していても、この二つの判断は必要になる。

認証
リクエストした人が誰かを確かめる。
認可
その人が、指定したデータを読んだり操作したりしてよいかを確かめる。

会員を二人用意して読む

レビュー用に会員を二人用意する。まず自分の会員として住所を読めるところまで通す。次に、同じログイン状態から別の会員の住所を求め、相手の住所が応答に入らないことを確かめる。一つ目の試験を残しておけば、二つ目のために全員の閲覧を止めた場合にも気づける。

試す相手要求する住所確かめる結果
会員AAの住所Aの住所が返る
会員ABの住所Bの住所が返らない
未ログインAの住所Aの住所が返らない

注記

これはこの本で使うレビュー例。拒否時のエラーや、存在を知らせてよいかは、サービスの契約に合わせて決める。

次に似た機能を頼むとき

私もAIに何度も実装を頼んでいる。似た処理がすでにあると、今いるリポジトリの書き方に合わせてくる。一つ確かめた実装があれば、次の作業で参照できる。最初のAPIにアクセス権の確認が抜けていたら、次の機能でも同じ所が抜けることがある。

flowchart LR
  A["最初の会員情報API"] --> B["本人に返る"]
  A --> C["他人には返らない"]
  B --> D["次の実装が参照"]
  C --> D

レビューで先に読むのは、あとから繰り返される箇所だ。どのデータを選び、どこで返すものを決めたか。次の一つが同じ形で増えてもよいと判断できたら、そこで作業を広げていく。

公開したら記事の操作が止まった

脚注

  1. 『最初の100行を、誰が見るのか』。 ↩

任せる前に、使う場面を一つ言う

たとえば「会員機能を作って」と送る前に、「ログインした人が、登録済みの自分の住所を確認して、間違っていたら直す」と書く。使う人と操作が一つ決まると、その人以外の住所を見せてしまう場合や、保存に失敗したときの表示も考えられる。

人数が十人でも、その十人の面倒が減るなら作る価値がある。友人の式の話を聞いて、自分もそんな小さいものを作りたいと思った。使う相手を思い浮かべてから頼むと、初めの一行を作る速さがちゃんと役に立つ。

次の章では、今の「自分の住所を確認する」を、最初のAPIでどこまで確かめるか考える。

最初の実装を読む