Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
ログラスを支える設計標準について / loglass-design-standards
Search
urmot
March 29, 2024
Programming
12
2.7k
ログラスを支える設計標準について / loglass-design-standards
設計カンファレンス extends OOCの発表資料です。
urmot
March 29, 2024
Tweet
Share
More Decks by urmot
See All by urmot
DDDにおける認可の扱いとKotlinにおける実装パターン / authorization-for-ddd-and-kotlin-implement-pattern
urmot
4
840
ログラスを支える技術的投資の仕組み / loglass-technical-investment
urmot
10
5.7k
実践!CloudFormation Best Practice ~CloudFormationで始める組織改革~
urmot
2
3.2k
CircleCIを導入した話
urmot
0
68
SPA on AWS
urmot
0
180
実践!CloudFormation Best Practice
urmot
0
180
RDBのログを取る時にDMSを使うという選択肢
urmot
0
100
ベンチャー企業のインフラを運用して学んだ99のこと
urmot
0
1.1k
Other Decks in Programming
See All in Programming
Pulsar2 を雰囲気で使ってみよう
anoken
0
220
Compose でデザインと実装の差異を減らすための取り組み
oidy
1
290
Lottieアニメーションをカスタマイズしてみた
tahia910
0
110
[Fin-JAWS 第38回 ~re:Invent 2024 金融re:Cap~]FaultInjectionServiceアップデート@pre:Invent2024
shintaro_fukatsu
0
400
2024年のkintone API振り返りと2025年 / kintone API look back in 2024
tasshi
0
210
自動で //nolint を挿入する取り組み / Gopher's Gathering
utgwkk
1
240
プログラミング言語学習のススメ / why-do-i-learn-programming-language
yashi8484
0
110
Immutable ActiveRecord
megane42
0
130
[JAWS-UG横浜 #80] うわっ…今年のServerless アップデート、少なすぎ…?
maroon1st
1
170
富山発の個人開発サービスで日本中の学校の業務を改善した話
krpk1900
4
360
Amazon Bedrock Multi Agentsを試してきた
tm2
1
280
Linux && Docker 研修/Linux && Docker training
forrep
23
4.4k
Featured
See All Featured
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
160
15k
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
33
2.1k
How GitHub (no longer) Works
holman
313
140k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
29
2.2k
Producing Creativity
orderedlist
PRO
343
39k
How To Stay Up To Date on Web Technology
chriscoyier
790
250k
It's Worth the Effort
3n
184
28k
How to Ace a Technical Interview
jacobian
276
23k
Facilitating Awesome Meetings
lara
51
6.2k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
27
1.5k
The Cost Of JavaScript in 2023
addyosmani
47
7.3k
Designing on Purpose - Digital PM Summit 2013
jponch
117
7.1k
Transcript
1 ©2024 Loglass Inc. ログラスを支える設計標準について 2024.3.29 設計カンファレンス extends OOC Yuta
Muramoto / Loglass, Inc.
2 2 ©2024 Loglass Inc. 株式会社ログラス 開発部 エンジニア 村本 雄太
/ Yuta Muramoto (@urmot2) 自己紹介 2021年11⽉にログラスにソフトウェアエンジニアとして⼊社。 Loglass経営管理の開発に2年ほど携わり、 現在は新規事業であるLoglass⼈員計画の開発に勤しんでいる
3 ©2024 Loglass Inc. 設計標準とは?
4 ©2024 Loglass Inc. 設計標準とは何か?
5 ©2024 Loglass Inc. ex ・テストコードの書き方 ・ドメインオブジェクトの書き方 ・ドメインサービスの書き方 ・バリデーションの書き方 ・フロントエンドのAPIコールの仕方
設計標準 より良い設計の追求を目的とする ・理由がなければ、基本的に従う ・設計時やレビュー時に参照される ・より良い設計案がされば更新される コーディング規約 品質を均一化することを目的とする ・必ず従うべきもの ・違反したらRequest changesにする ・必要に応じて更新する コーディング規約との違い ex ・命名規則 ・スタイル規約 ・ディレクトリ構造 ・クラス設計 ・DB設計
6 ©2024 Loglass Inc. コレクション 設計標準の事例紹介
7 ©2024 Loglass Inc. 関数 設計標準の事例紹介
8 ©2024 Loglass Inc. サーバーサイドテストコード設計標準 設計標準の事例紹介
9 ©2024 Loglass Inc. サーバーサイドテストコード設計標準 設計標準の事例紹介
10 ©2024 Loglass Inc. 設計標準の運用
11 ©2024 Loglass Inc. 設計標準の運用
12 ©2024 Loglass Inc. 設計標準の運用 プロポーザルを書いて Slackで投げかける
13 ©2024 Loglass Inc. 設計標準の運用 ポストモーテムの再発防止策として
14 ©2024 Loglass Inc. 設計標準の効果
15 15 ©2024 Loglass Inc. 開発組織の資産になる 設計標準の効果 1. 設計で迷う時間を省くことができる ◦
⾃分が⼀度迷ったところは、他の⼈も絶対迷う ◦ そういうときに既に答えがあると、迷う時間を短縮できる 2. 良い設計が伝播していく ◦ 設計標準がないと、良い設計もその場限りのものになってしまう ◦ 設計標準に追加することによって、コードへ反映しようとする圧⼒がかかる 3. 現在の設計の意図がわかる ◦ なぜこのようになっているのか?がドキュメントとしてまとまっている ◦ オンボーディングの役に⽴つ ◦ 同じ轍を踏まない
16 ©2024 Loglass Inc. 今後の課題
17 ©2024 Loglass Inc. うまくいってるいるように話したけど ... 今後の課題 • ここ1年だけでも開発組織が急拡⼤している →
来年はもっと増える ◦ 開発者 → 1.5倍 ◦ チーム数 → 2倍 • 設計標準の重要性は増していくが、今の運⽤⽅針だとドキュメントの維持が⼤変 ◦ ex. 古いドキュメントの更新、バラバラなフォーマット、検索性、etc.. • 仕組み化と浸透施策が今後の課題 ◦ ADRのテンプレを作って運⽤を回す ◦ 各チームにアンバサダー的な⼈を置く
18