Traceability review screen design · relationships and change impact
01 / CONTEXT & CONTRIBUTION
The problem. My part in it.
Background
Documentation spanned requirements, design, code and tests.
Changes required a way to identify affected artifacts.
Generated documents also needed links to source and tests.
The design had to fit on-premises, Git and Markdown workflows.
Objective
Make document creation and change review repeatable.
Propose generation, traceability and expert review as one flow.
My role
Defined requirements, operating scenarios and module boundaries.
Scoped functions, deliverables and the implementation roadmap.
02 / SYSTEM DESIGN
How it connects.
Proposed architecture
Processing / data flowIteration / feedbackService / environment boundary
01
Generation and traceability.
Generating a document does not maintain its relationship to requirements, code and tests. Define separate modules, with expert review linking their outputs.
02
Designed for the operating environment.
Use the customer’s on-premise, Git and Markdown constraints to define artifacts, operating scenarios and the phased roadmap.
03 / RESULTS & SCOPE
The outcome.
2Coordinated modules
GitVersioned collaboration
On-premCustomer environment
Requirements, solution proposal and screen-design outputs. Production operations and time savings were not measured in this scope.