カオスに立ち向かう小規模チームの装備の選択〜フルスタックTSという装備の強み _ 弱み〜/Choosing equipment for a small team facing chaos ~ Strengths and weaknesses of full-stack TS~

© 2025 Bitkey Inc. カオスに立ち向かう小規模チームの装備の選択〜フルスタックTSという装備の強み / 弱み〜株式会社ビットキー佐藤拓人
2025/04/22

2 Copyright © 2025 Bitkey Inc. All right reserved. 目次
1. TypeScriptの利用状況 2. 事業特性の説明 3. 強み (メリット) 4. 弱み (困っていること / 改善したいこと) 5. おまけ

3 Copyright © 2025 Bitkey Inc. All right reserved. 自己紹介
佐藤拓人 Sato Takuto 2015.04 2019.05 2020.01 大学(建築学専攻)卒業後、株式会社ワークスアプリケーションズに入社会計システムのソフトウェア開発を担当特に財務会計の仕訳関連ビットキーへ参画 ECサイトの開発 / 保守、社内システムの開発 TaKuTyの開発今のHome事業の前身となるResidenceチームに配属スマートロックを扱う管理画面やバックエンド、スマホアプリの開発に従事 Now Home事業のプロダクト責任者複雑な事象を読み解いて構造化し、抽象化 / 汎用化できるように設計し、低コストで多くの価値をだせる開発をすることを好む

佐藤拓人 Sato Takuto はまっていること：健康・運動毎日出勤前に会社近くのジムで筋トレ (もちろん今日も筋トレしました！ ) ・食事毎日栄養素を考慮して食事をほぼ固定・睡眠 1日平均で +2時間睡眠取るように → 9ヶ月で約25kg減量！

佐藤拓人 Sato Takuto

6 Copyright © 2025 Bitkey Inc. All right reserved. 1.
TypeScriptの利用状況

TypeScriptの利用状況創業当初

TypeScriptの利用状況創業当初 4人

TypeScriptの利用状況現在

TypeScriptの利用状況現在 4人 5人

なぜTypeScript？

なぜTypeScript？ Why? 少人数で一連のプロダクトを迅速に実現をする責務を機能で提供価値にフォーカスしたい

TypeScriptの利用状況創業当初 4人

なぜTypeScript？創業当初 4人で Web / Mobile / サーバーを実装してリリース ※ スマートロック設置、解施錠、友達追加、チケット配布、管理会社向け管理機能...など

TypeScriptの利用状況現在 4人 5人

なぜTypeScript？現在 (homehub) 広範囲の Web / サーバーを保守しながら新規開発も...！ ※Mobileは別チーム　　

なぜTypeScript？現在 (homehub) 広範囲の Web / サーバーを保守しながら新規開発も...！ ※Mobileは別チーム　　昔も今の限られたリソースで事業を拡大させてきた！！

強み (メリット)

強み (メリット) 最初のねらい少人数で一連のプロダクトを迅速に実現をするため責務を機能で分割せずに提供価値にフォーカス

強み (メリット) 最初のねらい少人数で一連のプロダクトを迅速に実現をするため責務を機能で提供価値にフォーカスしたかったから達成できた？？

強み (メリット) 少人数で一連のプロダクトを迅速に実現をする → 達成できた！・特に創業当初はガンガン機能リリースをゴリゴリに実施していた・1人で全て賄えるため、かなり早いスピード感を持ってプロダクトの実現をやりきてれたと思う。・一方で属人化が進む要因でもあった・サーバーサイド側の不都合を、フロント側でいい感じで吸収することでなんとか首が繋がっている状況... 最初のねらい

強み (メリット) 責務を機能で分断せずに提供価値にフォーカス → 達成できた！& TypeScriptが一定寄与できた...はず！・元々何をやるか...ではなくてなぜやるか...を重視する組織文化ではあった・創業当初は、個人の裁量に委ねられるシチュエーションが多く個人で価値提供まで一貫して実現できる下地は意味があった・プロセスが型化されていく過程で、ここのメリットは薄れていった・リファインメントなどの場で事前に議論をする場が用意されるなど、提供価値にフォーカスした場が適宜組まれる仕組みとすることができたため ※ =フルサイクル開発者最初のねらい

強み (メリット) 責務を機能で分断せずに提供価値にフォーカス → 達成できた！& TypeScriptが一定寄与できた...はず！・元々何をやるか...ではなくてなぜやるか...を重視する組織文化ではあった・創業当初は、個人の裁量に委ねられるシチュエーションが多く個人で価値提供まで一貫して実現できる下地は意味があった・プロセスが型化されていく過程で、ここのメリットは薄れていった・リファインメントなどの場で事前に議論をする場が用意されるなど、提供価値にフォーカスした場が適宜組まれる仕組みとすることができたため最初のねらい他の観点ではどう？

強み (メリット) その他プロダクト全体の理解が深まりやすい高いアジリティを維持しやすい問い合わせ / 調査を迅速に完結させやすいモブやペアでタスクを組みやすい / 進めやすい

強み (メリット) プロダクト全体の理解が深まりやすい → じわじわとボディーブローのように効いてくるヤツ・Webアプリ / サーバーサイドの両方を触るためアーキテクチャの構成や動作する仕組みなど理解しやすい・サーバーサイド側に重要なロジック (ドメイン知識) が集約されがちだが、全員が同程度の理解でプロダクトの実装ができる点で特に良いその他

強み (メリット) 高いアジリティを維持しやすい → 運用やタスクに対する意識において良い影響があるはず・チーム全員の技術スタックがTypeScriptで得手不得手はあるものの、基本的には Webアプリ / サーバーサイドの両方が対応可能であるため、アサインなどで技術スタックを考慮する必要がない・そのため何ができるか？...ではなく何を実現するべきかで優先度を判断しやすいその他

強み (メリット) 問い合わせ / 調査を迅速に完結させやすい → これは普通に嬉しいやつ！・Webアプリ / サーバーサイドの両方を常に開発しているのでほとんどの問い合わせを単独で解決できる・実際にはデバイス (Firmware) の観点や、Mobileアプリ / 認証認可のプラットフォーム...なども絡んでくることもあるので単独で解決できないことも稀にあるその他

強み (メリット) モブやペアでタスクを組みやすい / 進めやすい → これが一番おいしかったかも！！・チームでタスクを進める際に、モブやペアでの進め方を積極的に採用しているがチーム全員の技術スタックがTypeScriptであるため、内容や理解度に応じて組み合わせを変えて実施しやすい・モブ / ペアでのタスクを進めやすいために比較的負荷を低く属人性の排除を実現できたように感じるその他

弱み (問題となったこと / 困っていること)

弱み (困っていること / 改善したいこと) 創業当初の代償

弱み (困っていること / 改善したいこと) Any大量発生 → リリースを最優先させていたため、よくわからずとりあえずAnyを使用していた・リリース最優先であり、当時は開発全メンバーが初めてTypeScriptを使用したこともあり、型の仕組みの理解が甘くうまく型解決できずにAnyを使っていたケースが多かった・当時はそこまで問題なかったものの、新しいメンバーが入ってきて既存機能の改修をする際などに多大な代償を払うこととなった創業当初の代償

弱み (困っていること / 改善したいこと) 属人化推進 → 全部自分がわかっていれば対応できるからドキュメントなどはない・フロント / サーバーの両方を1人で賄って実装を進め他ため、仕様が個人の頭の中に閉ざされていてもなんとかなっていた・自身でフロントも実装するためAPI仕様書がなくても困らなかった　(頻繁に機能追加 / 仕様変更があり変更コストが高かった背景もある) ・スケールした際に問題が露見...多大な代償を払うこととなった創業当初の代償

弱み (困っていること / 改善したいこと) 属人化推進 → 全部自分がわかっていれば対応できるからドキュメントなどはない・フロント / サーバーの両方を1人で賄って実装を進め他ため、仕様が個人の頭の中に閉ざされていてもなんとかなっていた・自身でフロントも実装するためAPI仕様書がなくても困らなかった　(頻繁に機能追加 / 仕様変更があり変更コストが高かった背景もある) ・スケールした際に問題が露見...多大な代償を払うこととなった創業当初の代償今でも困っていること

弱み (困っていること) 困っていることランタイムでの型チェックがないサーバーサイドのデファクトスタンダードがない… 様々な実装の仕方ができてしまう

強み (メリット) ランタイムでの型チェックがない → 型があるのに型を信じきれない... ・TypeScriptは静的型付け言語であり、コンパイル時に型チェックする。しかし、コンパイル後はJavaScriptに変換されるため、実行時に型チェックが行われない。・実行時に型チェックがなく、定義した型とは異なる型を持つ値が紛れ込むリスクがある。これにより、予期しない動作やバグが発生する可能性がある。・「any型」を使用すると、型チェックを回避することができ、どんな型の値でも受け入れる...。これにより、型安全性が失われ、コードがカオスな状態になるリスクがあるその他

強み (メリット) サーバーサイドのデファクトスタンダードがない… → これに倣っていればとりあえずOK！...ってのがない・TypeScriptをサーバーサイドで使用する際、ExpressやNestJS、Honoなどのフレームワークが存在しますが、特定のフレームワークがデファクトスタンダードとして広く認識されているわけではない...と感じている(個人的にはEﬀectが好き) ・多くの選択肢があるため、プロジェクトに最適なフレームワークやライブラリを選ぶのが難しく、開発者間での意見の相違が生じることがある。・サーバーサイドでのTypeScriptの使用に関するベストプラクティスが明確でないため、プロジェクトごとに異なるアプローチが取られることが多く、コードの一貫性が失われる可能性があります。その他

強み (メリット) 様々な実装の仕方ができてしまう → 気を抜くと無法地帯になるリスク・TypeScriptは、関数型やオブジェクト指向など様々なスタイルで実装が可能です。他言語と比較して制約が少なく開発者は自由に設計できてしまいます。・この柔軟性により、実装者の個人的な好みがコードに反映されやすく、結果として一貫性のないコードスタイルが混在することがあり、視認性や保守性に影響を与える可能性があります。・統一されたコーディング規約がない場合、異なる実装スタイルが混在し、コードの一貫性が失われるリスクがあります。これにより、コードレビューやメンテナンスが困難になることがあります。・既存のオブジェクトを破壊することなどもできてしまいます... その他

弱み (困っていること) 困っていることランタイムでの型チェックがないサーバーサイドのデファクトスタンダードがない… 様々な実装の仕方ができてしまう

弱み (困っていること) 困っていることランタイムでの型チェックがないサーバーサイドのデファクトスタンダードがない… 様々な実装の仕方ができてしまう良い方法あればぜひ教えて欲しい ...！！！ (切実)

42 Copyright © 2025 Bitkey Inc. All right reserved. 良かったこと
・プロダクト全体の理解が深まりやすい・高いアジリティを維持しやすい・問い合わせ / 調査を迅速に完結させやすい・モブやペアでタスクを組みやすい / 進めやすい特に初期フェーズにおいて迅速にリリースするための選択してしてはよく機能した！ 3. 強み (メリット) まとめ

43 Copyright © 2025 Bitkey Inc. All right reserved. 辛かったこと
・Any大量発生・属人化推進・ランタイムでの型チェックがない・サーバーサイドのデファクトスタンダードがない… ・様々な実装の仕方ができてしまう特に初期フェーズでは全部個人でできてしまうためにスケール時のプロセスの軌道修正は大切と感じる 3. 強み (メリット) まとめ

おまけ

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 TSKaigi 2024 こんなTypeScriptは嫌だ！...みんなの声

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 1. 世界が ”any” で溢れている

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜「なにか」ってなに？

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・コードが説明責任を放棄している・チーム開発する気なし...と思われうる・AIのサポートも受けづらくなる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・noImplicitAny:true (tsconﬁg.json) ・コードが説明責任を果たすか気か掛ける (1年後の自分が理解/保守可能か) ・モブプロ / ペアプロを積極実施

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 TypeScriptを使って「わかる」状態にしよう！

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 2. 外界からくる「値」が「型」と乖離している

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・APIの呼び出す処理、APIの定義、DBの参照など...

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜型を信じられなければなにを信じれば良い！？

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・普通に実装していたらバグる・疑心暗鬼になる・いろいろ気にしだして変更できなくなる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・外界との境界でチェックする・定義から自動生成するツールを利用する (Prismaなど)

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜型を信頼できる状態にしよう！

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 3. 配列の要素のundeﬁned考慮

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 undefinedが考慮されない

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜これって本当に大丈夫？

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・TypeScriptに身を任せることができない・常にケアし続けなければならない

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・noUncheckedIndexedAccess:true (tsconﬁg.json)

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜意図せぬミスを事前に潰そう！

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 4. 列挙型の追加に追従できない

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・before ・after どこが修正必要か考えなきゃ...

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・修正が必要な箇所を機械的に洗い出すことができない

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・switch文でneverを利用する・switch-exhaustiveness-checkを利用

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 TypeScriptとうまく付き合って保守しやすくしよう！

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 5. 型のパターンと具体的な値との狭間

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜みんな大好き Prisma

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜みんな大好き Prisma include区の指定に基づいて取得される値にも動的に型が付与される

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜みんな大好き Prisma include区の指定に基づいて取得される値にも動的に型が付与される型としても実態としても値が取得される型としても実態としても値が取得されない

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 Include句を切り出し

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 Include句を切り出し trueではなくboolean扱いとなる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 Include句を切り出し trueではなくboolean扱いとなる include句がboolean扱いのため取得されるか未確定の扱いとなる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 as const を利用

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜 as const を利用 as const のみだと trueは維持されるが中身に誤りがあってもここでは気付けない ...

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜利用する箇所で取得できていないことに気づく as const を利用 as const のみだと trueは維持されるが中身に誤りがあってもここでは気付けない ...

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・実装ミス時に、ミス周辺で気付けない・問題の検知が遅れ、問題の解消が煩雑に

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・satisﬁesを用いる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・satisﬁesを用いる true扱いで型が渡されるので型としても取得される前提となる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜・satisﬁesを用いる指定の仕方に誤りがあれば即時に気づけて補完のサポートを受けながら修正できる true扱いで型が渡されるので型としても取得される前提となる

おまけ TSKaigi 〜こんなTypeScriptは嫌だ〜型の仕組みを上手く使ってより簡単に実装できる工夫を！

カオスに立ち向かう小規模チームの装備の選択〜フルスタックTSという装備の強み _ 弱み〜/Ch...

カオスに立ち向かう小規模チームの装備の選択〜フルスタックTSという装備の強み _ 弱み〜/Choosing equipment for a small team facing chaos ~ Strengths and weaknesses of full-stack TS~

More Decks by 株式会社ビットキー / Bitkey Inc.

Other Decks in Programming

Featured

Transcript