Diagramming the Architecture

Praveen Nair

K-MUG TechDay 19 August 2017

About the Speaker

Praveen

SSADM, RUP, UML…

Why

• “What types of diagram should we draw?”

• “What notation should we use?”

• “What level of detail should we present?”

• “Who is the audience for these diagrams?”

• “What technology?”

• “What are the meanings of boxes and arrows?”

A Shared Vocabulary

C1 – System Context• The system users & dependencies

C2 – Containers• Overall shape & Technology Choices

C3 – Components• Logical components & their interactions

C4 – Classes• [optional] – class diagrams

Overview first,

zoom and filter,

then details-on-demand

Example: Reporting Tool

Context Diagram

MyReports v1.0[Software System]

HRMS 2017[Software System]

Triton 01[Software System]

Triton 02[Software System]

Finance Dept. User

[Person]

Employee from finance dept.

HR User[Person]

User from HR Dept.

Administrator[Person]

A system admin user

View, download, printfinance reports

View HR reports

Add/remove users,Manage roles

Get employeedata from

Get Kochi specificfinance data from

Get Mumbai specificfinance data from

Container Diagram

Relational Database[Container: SQL Server 2016]

Stores HR and Triton Data

HRMS 2017[Software System]

Triton 01[Software System]

Triton 02[Software System]

Finance Dept. User

[Person]

HR User[Person]

Administrator[Person]

Content Updater[Container: SSIS]

Data Synchronizer

Reporting Tool [Container: Power BI]

Allows users to view reports

Uses[HTTPS]

Uses[HTTPS]

Uses[HTTPS]

Reads data from[SQL, Port: 1433]

Writes to

Reads data from[SQL Server, Port: 1433] Reads data from

[SQL Server, Port: 1433]

Reads data from[SQL Server, Port: 1433]

System boundary

Example: techtribes.je

Context Diagram

Context Diagram

Context Diagram

Sources

• http://www.codingthearchitecture.com/

• https://c4model.com/

• Simon Brown’s books