Your Architecture as a Crime Scene: Improvements with Forensic Analysis @ijs Munich 2024

Transcript

1. AngularArchitects.io | @ManfredSteyer Your Architecture as a Crime Scene: Improvements with Forensic Analysis
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 • Lab • Discussion: Your Findings
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 https://github.com/manfredsteyer/standalone-example-cli.git Run this in your own code base (prefered) or clone this example project:
23. Contact and Downloads [web] ANGULARarchitects.io [twitter] ManfredSteyer d Slides & Examples Remote and In-House http://softwarearchitekt.at/workshops