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
10
2.2k
ログラスを支える設計標準について / loglass-design-standards
設計カンファレンス extends OOCの発表資料です。
urmot
March 29, 2024
Tweet
Share
More Decks by urmot
See All by urmot
ログラスを支える技術的投資の仕組み / loglass-technical-investment
urmot
10
5.3k
実践!CloudFormation Best Practice ~CloudFormationで始める組織改革~
urmot
2
2.9k
CircleCIを導入した話
urmot
0
54
SPA on AWS
urmot
0
150
実践!CloudFormation Best Practice
urmot
0
120
RDBのログを取る時にDMSを使うという選択肢
urmot
0
76
ベンチャー企業のインフラを運用して学んだ99のこと
urmot
0
1k
Other Decks in Programming
See All in Programming
PHP8.3の機能を振り返る / Review of PHP 8.3 features
seike460
PRO
1
120
MetricKitで予期せぬ終了を検知する話 / Detect unexpected termination with MetricKit
nekowen
1
190
Sheets API使ってみた
toshi0383
2
150
Going beyond Apache Parquet's default settings
xhochy
0
120
Apache Hive 4 on Treasure Data
ryukobayashi
0
400
Behind VS Code Extensions for JavaScript / TypeScript Linnting and Formatting
unvalley
5
1.1k
0→1と1→10の狭間で Javaという技術選定を振り返る/Reflecting on the Decision to Choose Java Between Scaling from 0 to 1 and 1 to 10
jaguar_imo
2
390
Elm 0.19.0 Changes
bkuhlmann
0
490
Ruby Function Composition
bkuhlmann
1
340
AWS CDKコントリビュートTIPS / aws-cdk-contribution-tips
gotok365
3
310
OpenAPIを中心に考えるAPI開発入門 / Introduction to API Development with a Focus on OpenAPI
seike460
PRO
2
170
雑に思考を整理する技術と効能
konifar
61
30k
Featured
See All Featured
What's in a price? How to price your products and services
michaelherold
238
11k
BBQ
matthewcrist
80
8.8k
The Brand Is Dead. Long Live the Brand.
mthomps
49
29k
jQuery: Nuts, Bolts and Bling
dougneiner
59
7.1k
Building a Scalable Design System with Sketch
lauravandoore
457
32k
What’s in a name? Adding method to the madness
productmarketing
PRO
17
2.7k
The Cult of Friendly URLs
andyhume
74
5.7k
The Power of CSS Pseudo Elements
geoffreycrofte
61
5k
Statistics for Hackers
jakevdp
790
220k
It's Worth the Effort
3n
180
27k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
79
43k
[RailsConf 2023] Rails as a piece of cake
palkan
27
4k
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