Your Architecture as a Crime Scene: Improvements with Forensic Analysis

Transcript

1. AngularArchitects.io | @ManfredSteyer Your Architecture as a Crime Scene: Improvements with Forensic Analysis Angular Berlin
2. Which One is More Complex? [Adam Tornhill: Your Code as a Crime Scene, 2nd edition, 2024]
3. Same „Cyclomatic Complexity“ [Adam Tornhill: Your Code as a Crime Scene, 2nd edition, 2024]
4. [https://www.se.cs.uni-saarland.de/publications/docs/PAP+21.pdf]
5. Can we Support Architecture and Code Reviews with Code Metrics?
6. First Reaction … NO!
7. Goodhart‘s Law: „When a measure becomes a target, it ceases to be a good measure.“ -- Charles A. E. Goodhart
8. What‘s Important for Architects? Minimal Dependencies Vertical 1 Vertical 2 Vertical 3 Feature UI Data Feature UI Data Feature UI Data
9. What‘s Important for Architects? Low Coupling Vertical 1 Vertical 2 Vertical 3 Conway‘s Law High Cohesion High Cohesion High Cohesion Single Responsibility? Most Changes: Within ONE Verical Reduce Cognitive Load!
10. Code Churn Code that changes often: Indicator for issues
12. Forensic Analysis Source Code History History History Forensic Analysis „Hidden“ Patterns e.g., Git History
13. Agenda • Tools for Forensic Analysis • Limitations of Forensic Analysis • DEMO
14. About me… Manfred Steyer, ANGULARarchitects.io (Remote) Angular Workshops and Consulting Google Developer Expert for Angular Blog, Books, Articles, and Talks about Angular Manfred Steyer
15. Tools
16. Code Scene • By Adam Tornhill • Free for Open Source Projects • Lots of analysis methods • Awesome visualization • Several Programming Languages • Code & Architecture Level • https://codescene.com/
17. Detective • Our take on Forensic Analysis • Open Source • Limited to a few methods • Architecture Level • Primarily TypeScript • Focus: Help for Reviews • Appetizer for CodeScene!
18. Limitations
19. Awesome, but not a replacement for … Code Review Best Practices Architectural Goals Consequences/ Trade-offs Advise Joint Walkthrough Developer Interviews More general: Stakeholder Interviews
20. However, a tempting addition … Code Review Best Practices Architectural Goals Consequences/ Trade-offs Advise Joint Walkthrough Developer Interviews More general: Stakeholder Interviews (Forensic) Analysis Better Questions
21. DEMO
22. Try it out Now in Your Project! npm i @softarc/detective –D npx detective
23. Free eBook (6th Edition) angularArchitects.io/ebook
24. More: Angular Architecture Workshop • Maintainable Architectures with Modern Angular • Strategic Design with Nx & Sheriff • Micro Frontends with Module Federation • Signals and Your Architecture: CD & Zone-less, NGRX & Signal Store, RxJS-Interop German Version: angulararchitects.io/workshop-de English Version: angulararchitects.io/workshop-en
25. Conclusion • Metrics: Grain of Salt • Metrics should not become a target! • Low Coupling, High Cohesion, Conway’s Law
26. Conclusion • Hot Spots = High Change Rate + High Complexity • Change Coupling • Team/Code Alignment
27. Contact and Downloads [web] ANGULARarchitects.io [twitter] ManfredSteyer d Slides & Examples Remote and In-House http://softwarearchitekt.at/workshops