Difference between revisions of "SSC Artifacts and Diagrams"

From wiki
Jump to navigation Jump to search
(Changed title sizes.)
 
(29 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
[[File:EA_Models_Structure.png|frameless|944x944px]]
 
[[File:EA_Models_Structure.png|frameless|944x944px]]
  
−
=== Enterprise Architecture ===
+
== Enterprise Architecture ==
 +
Enterprise Architecture (EA) includes and is broken down into Strategic and Solution Architecture. 
  
−
==== Strategic Motivation Analysis ====
+
[https://gcdocs.gc.ca/ssc-spc/llisapi.dll/Open/83409305 Video overview of EA, Strategic and Solution architecture artifacts]  
−
This set of catalogs and diagrams are used to, at the enterprise/strategic level, identify the motivators for SSC. These include strategic plans and directions, legislation, policy, GC Initiatives, and more. The items managed here are intended to be leveraged organization-wide.
 
  
−
===== Motivation Diagram =====
+
== Strategic Architecture ==
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946175 Motivation Viewpoint]
+
This portion of enterprise architecture contains artifacts that define the scope of the enterprise, break it down into useful portions (segments), describe the strategic current/target states, drivers and motivations.
  
−
Scope/Constraints:  None.
+
=== Strategic Motivation Diagram ===
 +
Prepared by:  Benefits Management.
 +
 
 +
Purpose/Value:  Used to identify and related the strategic drivers, goals, outcomes of the organization, and the key strategic stakeholders.  Provides links to identify what existing and planned architecture are supporting the enterprise's desired target direction.  All solution architectures should link (directly or indirectly) to a strategic goal or outcome.
 +
 
 +
Scope/Constraints:  None beyond the constraints of the default ArchiMate 3.0 recommended viewpoint.
 +
 
 +
Key Stakeholders: Enterprise architects, business analysts, strategic planning, benefits realization, SSC executives.
  
−
Key Stakeholders: Enterprise architects, business analysts, strategic planning, benefits realization team.
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=9fa6c389-96ed-4f4e-82fd-f1750a22f0d6 Strategic Motivation Diagram Example] (QW login required)
  
−
Purpose/Value:  Used to identify and related the key strategic drivers, goals, outcomes of the organization, and the key strategic stakeholders. Provides links to identify what existing and planned architecture are supporting the enterprise's desired target direction.
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946175 Motivation Viewpoint]
  
−
===== Business Capability Map =====
+
=== Business Capability Map ===
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946178 Capability Map]
+
Purpose/Value:  A primary communication mechanism with SSC executives on the state of the architecture, activities, and progress towards desired target direction.  Helps ensure alignment between current/target activities and the strategic direction/capabilities of the organization. Investment prioritization.
 +
 
 +
Prepared by: Enterprise Architecture - Business Capability Lead
  
 
Scope/Constraints:  Generally limited to identifying capabilities/sub-capabilities, and their association with enterprise strategic outcomes, goals, drivers.
 
Scope/Constraints:  Generally limited to identifying capabilities/sub-capabilities, and their association with enterprise strategic outcomes, goals, drivers.
Line 26: Line 35:
 
Key Stakeholders:  Senior executives, branches, business managers, enterprise and business architects.  Investment prioritization.
 
Key Stakeholders:  Senior executives, branches, business managers, enterprise and business architects.  Investment prioritization.
  
−
Purpose/Value:  A primary communication mechanism with SSC executives on the state of the architecture, activities, and progress towards desired target direction.  Helps ensure alignment between current/target activities and the strategic direction/capabilities of the organization.  Investment prioritization.
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=6d26f35d-1e3b-46b0-ba59-849f065d4dbf Business Capability Map Example] (QW login required)
 +
 
 +
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946178 Capability Map]
  
−
==== Strategic Architecture ====
+
=== Segment Diagram ===
 +
Prepared by: Enterprise Architect - Segment Architect/Lead
  
−
===== Segment/Service Overview Diagram =====
+
Purpose/Value:  Enables EA to organize, prioritize and assign architecture work/activities.  In particular, it identifies the segments that will be used to organize EA work, and distributes the key services/functions among them. Every identified SSC service should belong to a segment.
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946160 Business Process Cooperation Viewpoint]
 
  
−
Scope/Constraints:  Uses only business functions, and business functions with categories "SSC Segment", "SSC Client-facing Service", and "SSC Supporting Service".  It does not show detailed information about roles, processes, information, technologies, applications involved in each segment.  One diagram shows all segments, and key high-level associated functions.
+
Scope/Constraints:  Uses only business roles, business actors, and business functions with categories "SSC Segment", "SSC Client-facing Service", and "SSC Supporting Service".  It may begin to associate key high-level roles, information, applications - but generally, it leaves details of architecture to dedicated lower-level diagrams.  One diagram per defined segment.
  
 
Key Stakeholders:  Enterprise architects/Enterprise Architecture management/executives.
 
Key Stakeholders:  Enterprise architects/Enterprise Architecture management/executives.
  
−
Purpose/Value:  Enables EA to organize, prioritize and assign architecture work/activities. In particular, it identifies the segments that will be used to organize EA work, and distributes the key services/functions among them.  Segment diagrams are produced for each segment that provides a more complete definition of what belongs in each segment.
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=c8410fdd-62de-45b6-9959-2361c9f1aada Segment Diagram Guidance] (QW login required)
  
−
===== Segment Diagram =====
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=78d3b7af-8667-41c4-89e2-d58ffe1595cc Segment Diagram Example] (QW login required)
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946160 Business Process Cooperation Viewpoint]
 
  
−
Scope/Constraints:  Uses only business functions, and business functions with categories "SSC Segment", "SSC Client-facing Service", and "SSC Supporting Service". It may begin to associate key high-level roles, information, applications - but generally, it leaves details of architecture to dedicated lower-level diagrams. One diagram per defined segment. 
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946160 Business Process Cooperation Viewpoint] 
  
−
Key Stakeholders:  Enterprise architects/Enterprise Architecture management/executives.
+
=== Strategic Service Diagram ===
 +
[[File:Service Conceptual Diagram - Example Wi-Fi.png|thumb|
 +
Strategic Service Diagram:  GC Wi-Fi Service
 +
]]
 +
Prepared by:  Enterprise Architect (in collaboration with Service Leads/Architects)
 +
 
 +
Purpose/Value:  Provides a conceptual view of SSC Services, key inter-service linkages, strategic linkages, and links to enabling technologies. Answers the questions:  1) What services/functions need which services to operate?, 2) What technologies are required by a particular SSC Service?
  
−
Purpose/Value:  Enables EA to organize, prioritize and assign architecture work/activities.  In particular, it identifies the segments that will be used to organize EA work, and distributes the key services/functions among them.  
+
Scope/Constraints:  This diagram defines, at a high level, an SSC service.  It links the SSC Service to Business Capabilities (1 or more), and to other key business functions/services, and to the key foundational/supporting technologies.  The diagram may expose some of the key sub-functions/processes that are performed in that SSC service (down 1 level of conception).  Detailed business, application, information and technology diagrams for a particular service are to be detailed in other (solution-level) diagrams.
  
−
===== Conceptual Service Diagram =====
+
Key Stakeholders:  Enterprise architects/Enterprise Architecture management/executives, Service architects.
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
 
  
−
Scope/Constraints: A template is provided to complete the diagram.  This particular diagram links the SSC Service to Business Capabilities (1 or more), and to other key business functions/services, and to the key foundational/supporting technologies. Similar to the Conceptual Foundation Technology diagrams, except the focus here is on the business function and clients, rather than the technologies. The diagram may expose some of the key sub-functions/processes that are performed in that SSC service.
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=7969bebb-476a-4bc8-b649-cb6869e658e3 Strategic Service Diagram Guidance] (QW login required)
  
−
Key Stakeholders: Enterprise architects/Enterprise Architecture management/executives.
+
[http://qualfrm-0006075.dev.global.gc.ca/SSC_Governed_Architecture/?oid=1864994b-09bd-42e7-a17a-67fd15cf3e55 Strategic Service Diagram Example] (QW login required)
  
−
Purpose/Value:  Provides a conceptual view of SSC Services, key inter-service linkages, strategic linkages, and links to enabling technologies.
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
  
−
===== Conceptual Foundation Technology Diagram =====
+
=== Architecture Roadmap Diagram ===
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
+
Prepared by:  Enterprise Architect (in collaboration with Service Leads/Architects)
  
−
Scope/Constraints:  A template is provided to complete the diagram.  This particular diagram links the SSC Service to Business Capabilities (1 or more), and to other key business functions/services, and to the key foundational/supporting technologies.  Similar to the Conceptual Service Diagram, except the focus is on the enabling technologies, rather than business functions/processes.  The diagram may expose some of the key technology sub-functions/services that are used.
+
Purpose/Value:  Defines/describes the different architectures for a particular service in defined states (n-2, n-1, n, n+1, n+2) and plateaus (current, target, target+), and what work packages (projects) will satisfy which identified architecture gaps.
  
−
Key Stakeholders:  Enterprise architects/Enterprise Architecture management/executives.
+
Scope/constraints:  Uses Implementation and Migration elements, and Motivation elements (goal/outcome).
  
−
Purpose/Value:  Provides a conceptual view of SSC Services, key inter-service linkages, strategic linkages, and links to enabling technologies.
+
Key Stakeholders:  Enterprise Architects, Service Architects, Solution Architects, Service leads/teams.
  
−
==== Capability Planning View ====
+
[https://gcdocs.gc.ca/ssc-spc/llisapi.dll?func=ll&objaction=overview&objid=79127247 Architecture Roadmap Demonstration Video]
−
ArchiMate Viewpoint:  Capability Planning View  (Custom:  Base on Capability Planning view at:  https://www.hosiaisluoma.fi/blog/archimate-examples) 
 
  
−
Scope/Constraints: Link any Business Function or Business Process to a capability.  
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
  
−
Key Stakeholders: Enterprise architects, segment architects, strategic planning.  
+
== Solution (including Service) Architecture ==
 +
These diagrams are for service or solution architectures for initiatives.  The solution architecture artifacts are usually captured in a Service and Solution Architecture Description deliverable (package). These solution architectures are reviewed with enterprise architecture through a governance processes (architecture assurance) to help ensure alignment with the enterprise architecture.
  
−
Purpose/Value:  To link between strategy and enterprise architecture (core elements).  Used for mapping key core elements of architecture to realized capabilities.  In particular, those supporting functions/services and related applications/technology in support of particular capabilities.  
+
=== Conceptual Solution Architecture ===
 +
The conceptual solution architecture is a subset of a complete solution architecture.  It identifies the requirements, benefits and measures of success for a project, strategic goals/outcomes and business capabilities to be realized in the solution/initiative.  Further, it identifies the key business functions (SSC services) that will be used, created, impacted by the effort, and begins to outline the scope of the initiative.
  
−
===== SSC Service Catalog =====
+
==== Requirements Diagram ====
 +
Prepared by:  Solution architect, service architect.
  
−
Key Stakeholders:  SSC executives, service mangement, service inventory, enterprise architects, service leads, service teams, service architects, solution architects.
+
Purpose/Value:  List and definitions of the requirements for a project/initiative, as well as any related/influencing standards, principles, policies and/or reference architectures.
  
−
Purpose/Value:  Provides a list of the SSC functions designated as "SSC Services" including with key attributes used for service management and service inventory management.
+
Key Stakeholders:  Project managers, project teams, business analyst, business architects, service architects, solution architects, engineers.
  
−
==== Reference Library ====
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946175 Motivation Viewpoint]
  
−
===== Reference Architecture Catalog =====
+
==== Benefits Dependency Map ====
 +
Prepared by: Benefits management (in cooperation with the project/service team and/or service/solution architect)
  
−
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
+
Purpose/Value:  Identify the benefits of a projects/initiative, identifying key performance metrics (KPI's) that will be used to measure success of the effort.  Helps ensure alignment with enterprise outcomes, identify and link requirements to tactical and strategic outcomes.
  
−
Purpose/Value:  Provides a list of the reference architecture documents available, informing architects of the standard patterns and considerations for preparing architecture in particular defined circumstances.
+
Scope/Constraints:  Uses motivation elements of outcomes and implementation & migration element of work package and deliverable.
  
−
===== Reference Architecture Diagram =====
+
Key Stakeholders:  Project manager/lead, project team, business analyst, benefits realization team, governance bodies, management, executives.
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
 
  
−
Scope/Constraints: None.   
+
[https://gcdocs.gc.ca/ssc-spc/llisapi.dll?func=ll&objaction=overview&objid=79336116 Benefits Dependency Map Demonstration Video]  
  
−
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
+
Based on ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946175 Motivation Viewpoint] 
 +
==== Context Diagram ====
  
−
Purpose/Value: Diagrams of reference architecture patterns/options, to illustrate patterns and considerations for preparing new architectures under particular defined conditions/circumstances.  Used to ensure alignment/compliance and consistency of implementations.
+
Prepared by: Service/Solution architect
  
−
===== IT Standard Catalog =====
+
Purpose/Value:  Identifies the services used and/or modified/created by the initiative.  Identifies and links the initiative to a business capability to be fully or partly realized by the initiative.
−
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
 
  
−
Purpose/Value:  Provides a list of IT Standards to be applied to architectures, designs and implementations at SSC.  Used to ensure alignment/compliance and consistency of implementations.
+
Key Stakeholders:  Enterprise Architect, Governance Bodies (EART, AC, SARB).
  
−
===== Content Metamodel Diagram =====
+
[https://gcdocs.gc.ca/ssc-spc/llisapi.dll?func=ll&objaction=overview&objid=83412263 Context Diagram guidance and example video]
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
 
  
−
Scope/Constraints:  None.   
+
==== Conceptual Diagram ====
 +
Prepared by:  Service/Solution architect
  
−
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
+
Purpose/Value:  Identifies what, at a high/conceptual level, this project/initiative intends to do (key/main functions), for which clients (roles/actors), and what key information will be required/managed.  
  
−
Purpose/Value:  Illustrates the valid relationships amongst all types of architecture objects, and the rules to be applied for their use in architecture models.  The model of the model for architecture.
+
Scope/Constraints:  Show no sequence/flow, and generally no associations.  Limited to actors, roles, business functions (key high-level), business information, key application components, system software, technology services.    
  
−
===== Lexicon Catalog =====
+
Key Stakeholders:  Governance bodies (particularly AC and ESSARB), project teams/leads/managers, executives, enterprise architects, service architects, solution architects.
−
Key Stakeholders:  All users and practitioners of architecture.  
 
  
−
Purpose/Value:  Provides definitions of terms/nomenclature used for architecture.
+
[https://gcdocs.gc.ca/ssc-spc/llisapi.dll?func=ll&objaction=overview&objid=83414397 Conceptual Diagram guidance and example video]
  
−
===== SSC Project Catalog =====
+
ArchiMate Viewpoint:   [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]     
−
Key Stakeholders: Executives, project managers/leads, project teams, enterprise architects, service architects, solution architects, governance bodies, engineers.
 
  
−
Purpose/Value:  Used to associate objects, artifacts, deliverables to particular projects/initiatives.
+
=== Logical (and sometimes physical) Architecture ===
 +
The logical solution architecture provides the details of the business, information/data, application and technology architecture (including security and privacy) for the solution - in as much detail as is required to move to design, implementation and operations.
  
−
==== Service/Solution Architecture ====
+
==== Logical Business Diagram  (mandatory) ====
−
These diagrams are for service or solution architectures for initiatives to be reviewed/aligned by EA.
+
Prepared by:  Service/Solution architect
  
−
==== Project Definition ====
+
Purpose/Value:  Identifies/defines the business (functions, processes, roles, actors, etc...) of the project/initiative/SSC service, and links to application/data/information layers.
−
===== Requirements Catalog =====
 
−
Key Stakeholders:  Project managers, project teams, business analyst, business architects, service architects, solution architects, engineers.
 
  
−
Purpose/Value:  List and definitions of the requirements for a project/initiative. .
+
Scope/Constraints:  May only use application components from the application layer.  May have 1 diagram, or as many in as much detail as is required for the initiative.  
  
−
===== Motivation (Benefits Realization) Diagram =====
+
Key Stakeholders:  Governance bodies (particularly AC and ESSARB), project teams/leads/managers, enterprise architects, service architects, solution architects, business leads, business architects, business analists, business process practicioners.
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946175 Motivation Viewpoint]
 
  
−
Scope/Constraints:  None.  
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946160 Business Process Cooperation Viewpoint] 
  
−
Key Stakeholders:  Project manager/lead, project team, business analyst, benefits realization team, governance bodies, management. 
+
==== Logical Application Diagram ====
 +
Prepared by:  Service/Solution architect
  
−
Purpose/Value:  Identify the benefits of a projects/initiative, identifying key performance metrics, help ensure alignment with enterprise outcomes, identify and link requirements to tactical and strategic outcomes.   
+
Purpose/Value:  Optional.  Used if more details on application or inter/intra-application are required.  Focus on application development/components specifically.
  
−
==== Conceptual Architecture ====
+
Scope/Constraints:  Must link applications to business processes/functions as defined in the logical business diagram.  Diagram is optional, and is only needed if required to define the application and/or data architecture for the initiative.  Can have as many as are required.
  
−
===== Solution Context Diagram =====
+
Key Stakeholders:  Application managers, application architects, service architects, solution architects, CIO office, project team, application developers.
  
−
moved - and integrated with the Solution Conceptual Diagram.
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946162 Application Cooperation Viewpoint]
  
−
===== Solution Conceptual Diagram =====
+
==== Logical Technology (Usage) Diagram ====
−
ArchiMate Viewpoint:  Non-Standard (SSC specific)
+
Prepared by:  Service/Solution architect
  
−
Scope/Constraints:  Show no sequence/flow, and generally no associations.  Limited to actors, roles, business functions (key high-level), business information, KPI's.    
+
Purpose/Value:  Maps applications/application systems to required (generic/high level) technology implementations.
  
−
Key Stakeholders:  Governance bodies (particularly AC and ESSARB), project teams/leads/managers, executives, enterprise architects, service architects, solution architects.   
+
Scope/Constraints:  Must link the diagram (with objects within the diagram) to either a logical application diagram (and/or objects), or a logical business diagram (or functions/processes therein).  Optional.  Many have as many as is required to define the technology architecture to the level of detail desired.
  
−
Purpose/Value:  Identifies what, at a high/conceptual level, this project/initiative intends to do (key/main functions), for which clients (roles/actors), and what key information will be required/managed, and what key performance indicators/benefits will be provided by doing the effort.   
+
Key Stakeholders:  Service architects, solution architects, engineers, designers, implementers, operations staff, application support staff and management.   
  
−
==== Logical/Physical Architecture ====
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946166 Technology Usage Viewpoint] 
  
−
===== Business Process Cooperation Diagram =====
+
==== Logical Technology Diagram ====
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946160 Business Process Cooperation Viewpoint]
+
Prepared by:  Service/Solution architect
  
−
Scope/Constraints:  May only use application components from the application layer.  
+
Purpose/Value:  Identifies/defines the required technology components, positioning/placement/location, relationships, network, network zoning required for the initiative.
  
−
Key Stakeholders:  Governance bodies (particularly AC and ESSARB), project teams/leads/managers, enterprise architects, service architects, solution architects, business leads, business architects, business analists, business process practicioners.
+
Scope/Constraints:  None.
  
−
Purpose/Value:  Identifies/defines the business (functions, processes, roles, actors, etc...) of the project/initiative/SSC service, and links to application/data/information layers.   
+
Key Stakeholders:  Service architects, solution architects, engineers, designers, implementers, operations staff.   
  
−
===== Implementation and Deployment Diagram (optional) =====
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946165 Technology Viewpoint]
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946164 Implementation and Deployment Viewpoint]
 
  
−
Scope/Constraints: None.
+
== Reference Library ==
 +
The reference library contains a number of catalogues managing objects to be used across all levels of architecture. It particularly houses links to objects representing IT Standards and reference architectures (patterns).
  
−
Key Stakeholders: Application managers, application architects, service architects, solution architects, CIO office, project team, application developers.
+
A full list of the catalogues can be found in Qualiware, under the CatalogueDiagram:SSC template, and a summary of other key catalogues can be found [[SSC Architecture Catalogs|here]].
  
−
Purpose/Value:  Optional.  Used if more details on application or inter/intra-application and technology interactions are required than is provided in the Technology Usage Diagram (below).
+
==== Reference Architecture Catalog ====
  
−
===== Application Cooperation Diagram (optional) =====
+
Prepared/maintained by: Enterprise Architecture
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946162 Application Cooperation Viewpoint]
 
  
−
Scope/Constraints:  None.
+
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
  
−
Key Stakeholders:  Application managers, application architects, service architects, solution architects, CIO office, project team, application developers.
+
Purpose/Value:  Provides a list of the reference architecture documents available, informing architects of the standard patterns and considerations for preparing architecture in particular defined circumstances.
  
−
Purpose/Value:  Optional.  Used if more details on application or inter/intra-application are required.  Focus on application development/components specifically.
+
==== Reference Architecture Diagram ====
 +
Prepared by:  Enterprise architect, solution/service architect, subject matter experts.
  
−
===== Technology Usage Diagram =====
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946166 Technology Usage Viewpoint]
 
  
 
Scope/Constraints:  None.     
 
Scope/Constraints:  None.     
  
−
Key Stakeholders:  Service architects, solution architects, engineers, designers, implementers, operations staff, application support staff and management.   
+
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
 +
 
 +
Purpose/Value:  Diagrams of reference architecture patterns/options, to illustrate patterns and considerations for preparing new architectures under particular defined conditions/circumstances.  Used to ensure alignment/compliance and consistency of implementations.
 +
 
 +
==== IT Standard Catalog ====
 +
Prepared/Maintained by:  Enterprise Architecture
 +
 
 +
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
 +
 
 +
Purpose/Value:  Provides a list of IT Standards to be applied to architectures, designs and implementations at SSC.  Used to ensure alignment/compliance and consistency of implementations.
  
−
Purpose/Value:  Maps applications/application systems to required (generic/high level) technology implementations. 
+
==== Content Metamodel Diagram ====
 +
Prepared/maintained by:  Enterprise Architecture
  
−
===== Technology Diagram =====
+
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946170 Layered Viewpoint]
−
ArchiMate Viewpoint:  [https://pubs.opengroup.org/architecture/archimate3-doc/apdxc.html#_Toc489946165 Technology Viewpoint]
 
  
 
Scope/Constraints:  None.     
 
Scope/Constraints:  None.     
  
−
Key Stakeholders:  Service architects, solution architects, engineers, designers, implementers, operations staff.   
+
Key Stakeholders:  Enterprise architects, service architects, solution architects, engineers/implementers.
 +
 
 +
Purpose/Value:  Illustrates the valid relationships amongst all types of architecture objects, and the rules to be applied for their use in architecture models.  The model of the model for architecture.
 +
 
 +
==== Lexicon Catalog ====
 +
Prepared/maintained by:  Enterprise Architecture
 +
 
 +
Key Stakeholders:  All users and practitioners of architecture.
 +
 
 +
Purpose/Value:  Provides definitions of terms/nomenclature used for architecture.
 +
 
 +
==== Initiative (Project) Catalog ====
 +
Prepared/maintained by:  Enterprise architecture, governance body secretariats, others.
 +
 
 +
Key Stakeholders:  Executives, project managers/leads, project teams, enterprise architects, service architects, solution architects, governance bodies, engineers.
 +
 
 +
Purpose/Value:  Used to associate objects, artifacts, deliverables to particular projects/initiatives.
 +
 
 +
==== Architecture Gaps Catalog ====
 +
Prepared/maintained by: Enterprise Architecture
  
−
Purpose/Value:  Identifies/defines the required technology components, positioning/placement/location, relationships, network, network zoning required for the initiative.
+
Key Stakeholders:  Enterprise Architecture, Service/solution architects, SISD, Service Lines
  
 +
Purpose/Value:  To identify SSC gaps so that they may be accommodated in future architecture and initiatives.
 
[[Category:Architecture]]
 
[[Category:Architecture]]
 
[[Category:Enterprise Architecture]]
 
[[Category:Enterprise Architecture]]
 
[[Category:Modeling]]
 
[[Category:Modeling]]

Latest revision as of 16:11, 30 October 2020

SSC Enterprise Architecture

In addition to a content metamodel, SSC has established a set of specific artifacts (catalogs, matrices, diagrams) that are required. In general, these artifacts follow the recommended viewpoints established in the ArchiMate 3.0.1 Specification. However, in some instances we have chosen diagrams that better suit our particular needs, particularly in respect to project and service governance. The following are the required and recommended artifacts for architecture at SSC.

SSC Key EA Artifacts Diagram

EA Models Structure.png

Enterprise Architecture

Enterprise Architecture (EA) includes and is broken down into Strategic and Solution Architecture.

Video overview of EA, Strategic and Solution architecture artifacts

Strategic Architecture

This portion of enterprise architecture contains artifacts that define the scope of the enterprise, break it down into useful portions (segments), describe the strategic current/target states, drivers and motivations.

Strategic Motivation Diagram

Prepared by: Benefits Management.

Purpose/Value: Used to identify and related the strategic drivers, goals, outcomes of the organization, and the key strategic stakeholders. Provides links to identify what existing and planned architecture are supporting the enterprise's desired target direction. All solution architectures should link (directly or indirectly) to a strategic goal or outcome.

Scope/Constraints: None beyond the constraints of the default ArchiMate 3.0 recommended viewpoint.

Key Stakeholders: Enterprise architects, business analysts, strategic planning, benefits realization, SSC executives.

Strategic Motivation Diagram Example (QW login required)

Based on ArchiMate Viewpoint: Motivation Viewpoint

Business Capability Map

Purpose/Value: A primary communication mechanism with SSC executives on the state of the architecture, activities, and progress towards desired target direction. Helps ensure alignment between current/target activities and the strategic direction/capabilities of the organization. Investment prioritization.

Prepared by: Enterprise Architecture - Business Capability Lead

Scope/Constraints: Generally limited to identifying capabilities/sub-capabilities, and their association with enterprise strategic outcomes, goals, drivers.

Key Stakeholders: Senior executives, branches, business managers, enterprise and business architects. Investment prioritization.

Business Capability Map Example (QW login required)

Based on ArchiMate Viewpoint: Capability Map

Segment Diagram

Prepared by: Enterprise Architect - Segment Architect/Lead

Purpose/Value: Enables EA to organize, prioritize and assign architecture work/activities. In particular, it identifies the segments that will be used to organize EA work, and distributes the key services/functions among them. Every identified SSC service should belong to a segment.

Scope/Constraints: Uses only business roles, business actors, and business functions with categories "SSC Segment", "SSC Client-facing Service", and "SSC Supporting Service". It may begin to associate key high-level roles, information, applications - but generally, it leaves details of architecture to dedicated lower-level diagrams. One diagram per defined segment.

Key Stakeholders: Enterprise architects/Enterprise Architecture management/executives.

Segment Diagram Guidance (QW login required)

Segment Diagram Example (QW login required)

Based on ArchiMate Viewpoint: Business Process Cooperation Viewpoint

Strategic Service Diagram

Strategic Service Diagram: GC Wi-Fi Service

Prepared by: Enterprise Architect (in collaboration with Service Leads/Architects)

Purpose/Value: Provides a conceptual view of SSC Services, key inter-service linkages, strategic linkages, and links to enabling technologies. Answers the questions: 1) What services/functions need which services to operate?, 2) What technologies are required by a particular SSC Service?

Scope/Constraints: This diagram defines, at a high level, an SSC service. It links the SSC Service to Business Capabilities (1 or more), and to other key business functions/services, and to the key foundational/supporting technologies. The diagram may expose some of the key sub-functions/processes that are performed in that SSC service (down 1 level of conception). Detailed business, application, information and technology diagrams for a particular service are to be detailed in other (solution-level) diagrams.

Key Stakeholders: Enterprise architects/Enterprise Architecture management/executives, Service architects.

Strategic Service Diagram Guidance (QW login required)

Strategic Service Diagram Example (QW login required)

Based on ArchiMate Viewpoint: Layered Viewpoint

Architecture Roadmap Diagram

Prepared by: Enterprise Architect (in collaboration with Service Leads/Architects)

Purpose/Value: Defines/describes the different architectures for a particular service in defined states (n-2, n-1, n, n+1, n+2) and plateaus (current, target, target+), and what work packages (projects) will satisfy which identified architecture gaps.

Scope/constraints: Uses Implementation and Migration elements, and Motivation elements (goal/outcome).

Key Stakeholders: Enterprise Architects, Service Architects, Solution Architects, Service leads/teams.

Architecture Roadmap Demonstration Video

Based on ArchiMate Viewpoint: Layered Viewpoint

Solution (including Service) Architecture

These diagrams are for service or solution architectures for initiatives. The solution architecture artifacts are usually captured in a Service and Solution Architecture Description deliverable (package). These solution architectures are reviewed with enterprise architecture through a governance processes (architecture assurance) to help ensure alignment with the enterprise architecture.

Conceptual Solution Architecture

The conceptual solution architecture is a subset of a complete solution architecture. It identifies the requirements, benefits and measures of success for a project, strategic goals/outcomes and business capabilities to be realized in the solution/initiative. Further, it identifies the key business functions (SSC services) that will be used, created, impacted by the effort, and begins to outline the scope of the initiative.

Requirements Diagram

Prepared by: Solution architect, service architect.

Purpose/Value: List and definitions of the requirements for a project/initiative, as well as any related/influencing standards, principles, policies and/or reference architectures.

Key Stakeholders: Project managers, project teams, business analyst, business architects, service architects, solution architects, engineers.

Based on ArchiMate Viewpoint: Motivation Viewpoint

Benefits Dependency Map

Prepared by: Benefits management (in cooperation with the project/service team and/or service/solution architect)

Purpose/Value: Identify the benefits of a projects/initiative, identifying key performance metrics (KPI's) that will be used to measure success of the effort. Helps ensure alignment with enterprise outcomes, identify and link requirements to tactical and strategic outcomes.

Scope/Constraints: Uses motivation elements of outcomes and implementation & migration element of work package and deliverable.

Key Stakeholders: Project manager/lead, project team, business analyst, benefits realization team, governance bodies, management, executives.

Benefits Dependency Map Demonstration Video

Based on ArchiMate Viewpoint: Motivation Viewpoint

Context Diagram

Prepared by: Service/Solution architect

Purpose/Value: Identifies the services used and/or modified/created by the initiative. Identifies and links the initiative to a business capability to be fully or partly realized by the initiative.

Key Stakeholders: Enterprise Architect, Governance Bodies (EART, AC, SARB).

Context Diagram guidance and example video

Conceptual Diagram

Prepared by: Service/Solution architect

Purpose/Value: Identifies what, at a high/conceptual level, this project/initiative intends to do (key/main functions), for which clients (roles/actors), and what key information will be required/managed.

Scope/Constraints: Show no sequence/flow, and generally no associations. Limited to actors, roles, business functions (key high-level), business information, key application components, system software, technology services.

Key Stakeholders: Governance bodies (particularly AC and ESSARB), project teams/leads/managers, executives, enterprise architects, service architects, solution architects.

Conceptual Diagram guidance and example video

ArchiMate Viewpoint: Layered Viewpoint

Logical (and sometimes physical) Architecture

The logical solution architecture provides the details of the business, information/data, application and technology architecture (including security and privacy) for the solution - in as much detail as is required to move to design, implementation and operations.

Logical Business Diagram (mandatory)

Prepared by: Service/Solution architect

Purpose/Value: Identifies/defines the business (functions, processes, roles, actors, etc...) of the project/initiative/SSC service, and links to application/data/information layers.

Scope/Constraints: May only use application components from the application layer. May have 1 diagram, or as many in as much detail as is required for the initiative.

Key Stakeholders: Governance bodies (particularly AC and ESSARB), project teams/leads/managers, enterprise architects, service architects, solution architects, business leads, business architects, business analists, business process practicioners.

ArchiMate Viewpoint: Business Process Cooperation Viewpoint

Logical Application Diagram

Prepared by: Service/Solution architect

Purpose/Value: Optional. Used if more details on application or inter/intra-application are required. Focus on application development/components specifically.

Scope/Constraints: Must link applications to business processes/functions as defined in the logical business diagram. Diagram is optional, and is only needed if required to define the application and/or data architecture for the initiative. Can have as many as are required.

Key Stakeholders: Application managers, application architects, service architects, solution architects, CIO office, project team, application developers.

ArchiMate Viewpoint: Application Cooperation Viewpoint

Logical Technology (Usage) Diagram

Prepared by: Service/Solution architect

Purpose/Value: Maps applications/application systems to required (generic/high level) technology implementations.

Scope/Constraints: Must link the diagram (with objects within the diagram) to either a logical application diagram (and/or objects), or a logical business diagram (or functions/processes therein). Optional. Many have as many as is required to define the technology architecture to the level of detail desired.

Key Stakeholders: Service architects, solution architects, engineers, designers, implementers, operations staff, application support staff and management.

ArchiMate Viewpoint: Technology Usage Viewpoint

Logical Technology Diagram

Prepared by: Service/Solution architect

Purpose/Value: Identifies/defines the required technology components, positioning/placement/location, relationships, network, network zoning required for the initiative.

Scope/Constraints: None.

Key Stakeholders: Service architects, solution architects, engineers, designers, implementers, operations staff.

ArchiMate Viewpoint: Technology Viewpoint

Reference Library

The reference library contains a number of catalogues managing objects to be used across all levels of architecture. It particularly houses links to objects representing IT Standards and reference architectures (patterns).

A full list of the catalogues can be found in Qualiware, under the CatalogueDiagram:SSC template, and a summary of other key catalogues can be found here.

Reference Architecture Catalog

Prepared/maintained by: Enterprise Architecture

Key Stakeholders: Enterprise architects, service architects, solution architects, engineers/implementers.

Purpose/Value: Provides a list of the reference architecture documents available, informing architects of the standard patterns and considerations for preparing architecture in particular defined circumstances.

Reference Architecture Diagram

Prepared by: Enterprise architect, solution/service architect, subject matter experts.

ArchiMate Viewpoint: Layered Viewpoint

Scope/Constraints: None.

Key Stakeholders: Enterprise architects, service architects, solution architects, engineers/implementers.

Purpose/Value: Diagrams of reference architecture patterns/options, to illustrate patterns and considerations for preparing new architectures under particular defined conditions/circumstances. Used to ensure alignment/compliance and consistency of implementations.

IT Standard Catalog

Prepared/Maintained by: Enterprise Architecture

Key Stakeholders: Enterprise architects, service architects, solution architects, engineers/implementers.

Purpose/Value: Provides a list of IT Standards to be applied to architectures, designs and implementations at SSC. Used to ensure alignment/compliance and consistency of implementations.

Content Metamodel Diagram

Prepared/maintained by: Enterprise Architecture

ArchiMate Viewpoint: Layered Viewpoint

Scope/Constraints: None.

Key Stakeholders: Enterprise architects, service architects, solution architects, engineers/implementers.

Purpose/Value: Illustrates the valid relationships amongst all types of architecture objects, and the rules to be applied for their use in architecture models. The model of the model for architecture.

Lexicon Catalog

Prepared/maintained by: Enterprise Architecture

Key Stakeholders: All users and practitioners of architecture.

Purpose/Value: Provides definitions of terms/nomenclature used for architecture.

Initiative (Project) Catalog

Prepared/maintained by: Enterprise architecture, governance body secretariats, others.

Key Stakeholders: Executives, project managers/leads, project teams, enterprise architects, service architects, solution architects, governance bodies, engineers.

Purpose/Value: Used to associate objects, artifacts, deliverables to particular projects/initiatives.

Architecture Gaps Catalog

Prepared/maintained by: Enterprise Architecture

Key Stakeholders: Enterprise Architecture, Service/solution architects, SISD, Service Lines

Purpose/Value: To identify SSC gaps so that they may be accommodated in future architecture and initiatives.

Retrieved from "https://wiki.gccollab.ca/index.php?title=SSC_Artifacts_and_Diagrams&oldid=33896"