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.9k
ログラスを支える設計標準について / 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
1.1k
ログラスを支える技術的投資の仕組み / loglass-technical-investment
urmot
10
6k
実践!CloudFormation Best Practice ~CloudFormationで始める組織改革~
urmot
2
3.4k
CircleCIを導入した話
urmot
0
85
SPA on AWS
urmot
0
200
実践!CloudFormation Best Practice
urmot
0
230
RDBのログを取る時にDMSを使うという選択肢
urmot
0
130
ベンチャー企業のインフラを運用して学んだ99のこと
urmot
0
1.2k
Other Decks in Programming
See All in Programming
MCPでVibe Working。そして、結局はContext Eng(略)/ Working with Vibe on MCP And Context Eng
rkaga
5
2.3k
Design Foundational Data Engineering Observability
sucitw
3
210
AI Coding Agentのセキュリティリスク:PRの自己承認とメルカリの対策
s3h
0
240
CJK and Unicode From a PHP Committer
youkidearitai
PRO
0
110
RDoc meets YARD
okuramasafumi
4
170
Processing Gem ベースの、2D レトロゲームエンジンの開発
tokujiros
2
130
Azure SRE Agentで運用は楽になるのか?
kkamegawa
0
2.5k
Platformに“ちょうどいい”責務ってどこ? 関心の熱さにあわせて考える、責務分担のプラクティス
estie
1
140
スケールする組織の実現に向けた インナーソース育成術 - ISGT2025
teamlab
PRO
2
170
「手軽で便利」に潜む罠。 Popover API を WCAG 2.2の視点で安全に使うには
taitotnk
0
870
旅行プランAIエージェント開発の裏側
ippo012
2
930
CloudflareのChat Agent Starter Kitで簡単!AIチャットボット構築
syumai
2
510
Featured
See All Featured
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
32
1.6k
Keith and Marios Guide to Fast Websites
keithpitt
411
22k
Balancing Empowerment & Direction
lara
3
620
Building a Modern Day E-commerce SEO Strategy
aleyda
43
7.6k
Rebuilding a faster, lazier Slack
samanthasiow
83
9.2k
VelocityConf: Rendering Performance Case Studies
addyosmani
332
24k
Into the Great Unknown - MozCon
thekraken
40
2k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
sstephenson
162
15k
How to Ace a Technical Interview
jacobian
279
23k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
31
2.2k
The Cost Of JavaScript in 2023
addyosmani
53
8.9k
Sharpening the Axe: The Primacy of Toolmaking
bcantrill
44
2.5k
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