Slides for my talk at OSDC 2021

1. From User Stories to
the First Architectural
Sketch
A Technique to Help You Plan Your App.
Renato Nascimento
Senior Consultant @ Digital Alchimia
/renatocpn

2. Back Then ...
2
● Focus on delivery
● Mistakes… A lot of them…
● Fix more than deliver
● Maintenance costs rising
● Agile? Architecture? Not for me...

3. Delivery
Advice to My Younger Self ...
3
User-Centric Team

4. ● Perfect match with OutSystems
● Incremental Value Delivery
● Based on User Stories
● Timebox
4
Agile Means Fast ...

5. What does architecture
mean?
● Art?
● Plan?
● Usability?
● Design choices?
● Why not all of it?
5

6. Three pillars:
● Scalability
● Consistency
● Flexibility
A Good Architecture
6

7. How to Translate User
Stories into a Full-Fledged
Architecture?
7
Or at least into its first sketch

8. Helpful things to keep in mind.
8
3-Layer Canvas User Stories

9. 9
“It promotes the correct
abstraction of reusable
(micro)services and the correct
isolation of distinct functional
modules.”
3-Layer Canvas

10. 10
1. No Upward references
2. No Cyclic references
3. No Side references on UI
Three Little Rules

11. User Stories
Extract the main elements:
● Who
● What
● Why
Concepts that can be extracted:
● Roles
● UI and Core concepts
● Restrictions and Integrations
11
As a Teacher I need to insert
the grades of the students
that will feed the National
Student Ranking
As a Teacher I need to insert
the grades of the students
that will feed the National
Student Ranking
Extract the main elements:
● Who
● What
● Why
Concepts that can be extracted:
● Roles
● UI and Core concepts
● Restrictions and Integrations

12. Did someone ask for
a Demo?

13. 13
As a Teacher, I need to insert
the grades of the students
that will feed the National
Student Ranking.
As a Student, I need to
access my portal to check my
grades.
As a Principal, I want a
performance report of the
grades of my students.
As a Teacher, I need to
schedule and upload the tests
to be printed.
As an Assistant, I need to
print all the tests scheduled
for the day.
As a Principal, I want the
ability to access a Student
profile.

14. 14
Recap
● Architecture is for everyone
● User Stories are simple and powerful
● 3-Layer Canvas saves lives
● Who, What, Why

15. Resources
● Architecting Sustainable Applications
https://www.outsystems.com/training/paths/8/architecting-sustainable-applications/
● Agile Software Development at Wikipedia
https://en.wikipedia.org/wiki/Agile_software_development
● Three Layer Canvas
https://success.outsystems.com/Support/Enterprise_Customers/Maintenance_and_Operatio
ns/Designing_the_Architecture_of_Your_OutSystems_Applications/The_Architecture_Canvas
● User Stories at Wikipedia
https://en.wikipedia.org/wiki/User_story
15

16. Thank You!
Renato Nascimento
Senior Consultant @ Digital Alchimia
/renatocpn