メインコンテンツへスキップ
見出し画像

あとから変えると全部直しになる。アプリを作る前に決める 3 つ(ログインの方式・必須の項目・権限の名前)

    今回の話

    • 前回は、組合のポータルアプリを作る前に、要件定義書を AI と作った話でした。ただ、その要件定義にも甘いところがありました

    • 作り始めてから変えると、画面の小さな違いなのに、アプリ全体を直すことになるものがあります

    • 僕の場合は 3 つ。ログインの方式・必須の項目・権限の名前です。1 つはうまくいき、2 つは作り直しになりました



    1 つ目:ログインの方式は、最初に決めてよかった

    多くのアプリは、メールアドレスとパスワードでログインします。

    でも、前回書いたように、うちの組合員の多くは会社支給のパソコンやメールアドレスを持っていません。
    メールアドレスでのログインを前提にすると、そもそも入口に立てない人が出てしまいます。

    そこで、誰でも必ず持っている社員番号を使うことにしました。
    ログインは、こういう 2 段階です。

    1. 組合コードを入力する

    2. 社員番号とパスワードを入力する

    画像
    ログイン方式

    「社員番号とパスワードだけでいいのでは?」と思うかもしれません。
    組合コードを入れているのは、ほかの組合でも使えるようにするためです。

    0-2 で、同じ業界のほかの組合も情報がクローズで、いっそみんなが使えるものになればいい、と書きました。

    複数の組合が同じアプリを使うと、社員番号がかぶることがあります。A 組合の「1001 番」と、B 組合の「1001 番」は別の人です。
    なので、先に組合コードで「どの組合か」を決めてから、社員番号で「誰か」を決める。住所の「都道府県」を先に決めるようなものです。

    ログインの方式は、アプリの一番の入口です。あとから「やっぱりメールで」「やっぱりほかの組合も」と変えると、登録もログインも名簿も、全部が変わります。
    これは最初から決めておいたので、作り直しにならずに済みました。

    ちなみに、組合コードと社員番号は入力を記憶するようにしています。理由は、自分が毎回打つのが面倒だったから(笑)。
    作った本人が面倒なことは、使う人はもっと面倒なはずです。

    2 つ目:メールアドレスの「必須」を、あとから外した

    ログインは社員番号でできるようにしました。
    ところが最初の設計では、登録のときにはメールアドレスを必須にしていました。お知らせの通知や、パスワードを忘れたときの再設定に、メールがあると便利だからです。

    実際の組合員の状況を考え直すと、これはまずいと気づきました。

    • そもそも、会社のメールアドレスを持っていない人が多い

    • 個人のメールアドレスを必須にすると、「え、個人のアドレスを入れるの?」とためらう人が出る

    • 入力の手間が増えるほど、登録までに時間がかかり、そのうち「じゃあ、やらない」になる

    使ってもらえなければ意味がありません。そこで、メールアドレスは任意にしました。

    「必須を任意に変えるだけ」と思っていました。ところが、アプリのあちこちに影響が出ました。

    画像
    メアド必須の有無

    データベースの制約を外し、ログインの裏側ではメールがない人の代わりのアドレスを用意し、登録画面と通知も直す。
    「メールアドレスは必ずある」という前提で作っていたものが、全部作り直しになったんです。

    前回の記事で「組合員の多くは会社のメールアドレスを持っていない」と自分で書いていたのに、登録のところでは、メールがある前提で考えていました。
    ログインのときには気づけたことが、登録のときには抜けていた。要件定義で書いた課題が、すべての機能に反映されているかを確かめていなかったんです。

    3 つ目:権限の名前「admin」を、あとから消した

    組合ポータルは、使う人によってできることが違います。
    一般の組合員、支部の運営メンバー、執行部。この「役割ごとの権限」を、アプリの世界ではロールと呼びます。会社でいえば、一般社員・課長・役員のような区分けです。

    僕の頭の中では、役割は 3 つでした。執行部・支部の運営者・見るだけの組合員です。
    そして僕にとって、「admin(アドミン)」は「管理者」、つまり執行部のことでした。

    ところが、Claude と話すときに、僕が「執行部」と「admin」を別のもののように話してしまっていたんです。
    同じものを 2 つの名前で呼んでいたので、アプリの中では、役割が 4 つになっていました。

    最後に役割を整理したとき、「この admin って、何をする人だっけ?」となりました。
    執行部と同じなら、要らない。そこで「admin は消そう」と決めました。これが失敗の始まりです。

    ロールの名前は、アプリの 1 か所だけで使われているわけではありません。

    画像
    admin変更

    入口の見張り番、データベースの権限、画面の出し分け、ドキュメント。そのすべてに「admin」が埋め込まれていて、1 つ消すと、ほかの場所で「admin って誰?」となります。
    結局、全部を確認して直すことになりました。

    家でいえば、ロールは「この部屋は誰の部屋か」を決める間取りです。住み始めてから間取りを変えると、壁も電気の配線も、全部やり直しになります。

    正直なところ

    気づいたときは、シンプルに「失敗したな」と思いました。
    もともと 3 段階の役割でよかったのに、4 つ目ができてしまって、ややこしくなった。
    作り始めのころは少し時間がかかっていたので、あとから思い出せなかったり、そのミスにうまく気づけていなかったりしたのもあったと思います。

    混ざった理由は、たぶん言葉です。僕は本業の仕事で「admin」という言葉をよく使います。
    でも、アプリを作り進める中では、執行部の役割は「executive」という名前で決まっていました。確かめなかった僕が悪いのですが、「executive」と聞いても、僕の中ではそれが「admin」と同じものだと結びついていなかったんです。

    メールアドレスのほうは、そもそも現場はパソコンを持っていない、という話があったので、メールを持っていない人もいるはずだ、と。
    そう思ったときに、必須にする必要はないな、と思いました。

    いまは「最初に決めること」に書いてある

    3 つとも、画面の上では小さな違いです。でも、アプリの土台にとっては大きな違いでした。
    いまは、全体ルールの「最初に決めること」に、こう書いてあります。

    • ロール名(あとから変えると、見張り番・データベースの権限・画面・ドキュメントの全部に波及する)

    • メールなどの必須/任意(あとから必須を外すのは、影響範囲が大きい)

    次のアプリを作るときは、作り始める前に、この 2 つを Claude と決め切ってから進めるようにしています。

    振り返ってみると

    • ログインの方式は、使う人が必ず持っているもので決める。広げる予定があるなら、最初から入口に仕掛けておく

    • 「必須にするか」は、使う人の実態から決める

    • 権限の名前は、作り始める前に決め切る。迷ったら、実際の組織図と照らし合わせる。AI と話すときも、同じものはいつも同じ名前で呼ぶ

    新規事業でも、最初に「誰が、何を決めるのか」をあいまいにしたまま走り出すと、あとで必ず揉めます。アプリも組織も同じでした。

    画像
    まとめ

    次回:管理画面でデータが消える、一括登録でログインできない。データベースを直接さわる前に知っておきたい 2 つ。


    連載の記事は、テーマごとにマガジンにまとめています。

     
     
    本業は都内の会社で新規事業の企画。エンジニアではないけれど、AI(Claude)といろんなアプリを作っています。組合の連絡アプリ「Unite」、ハンドボールの記録「HandLog」など、だんだん実際に使われるものが増えてきました。その記録と、つまずいた話を書いています。

    あなたへのおすすめ