Do It Yourself Guide

Guide your digital team through the suggested DIY path or pick your suitable steps to understand key design and architecture principles of GovStack. Accomplishing all or selected steps on this guide is a perfect practice for prototyping and implementing services based on the GovStack approach.

Part 1: Service Design

Participants: Business Analysts, Domain Experts, UX Designers

Objective: Design a selected use case to a developer-ready stage and learn methodology along the way

Deliverables: User Journey(s), Service Blueprint, Wireframes

Pre-Step: Inform yourself about the suggest GovStack methodology

• GovStack Playbook User Journey Description
• GovStack UX/UI Guidelines
• GovStack Sandbox Example Service: Construction Permit

  • Project Documentation
  • Use Case Frontend Demo

Steps

1. Draft an 'As-Is' User Journey to help identify touch points, inefficiencies, pain points, opportunities for improvement followed by a digitized 'To-Be' user journey that represents the desired state of the user experience after changes have been made

   • Select a use case with your team

   • Create As-Is and To-Be Use Journeys using the User Journey Template (click on the arrow next to the title to duplicate the template)
   • For an introduction to the template, watch our explanatory User Journey video
   • As a workshop method, you may use the GovStack Design Sprint proposal
2. Develop a Service Blueprint which helps organizations see the big picture of how a service is implemented and used. It pinpoints required Building Blocks, dependencies between user journeys and government entities in the same visualization.

   • Create a Service Blueprint using the Service Blueprint Template
   • For an introduction to the template, watch our explanatory Service Blueprint video
3. Create Wireframes to outline the user interface and interaction flow, serving as a base for the visual and functional aspects of the digitized solution.

   • Create wireframes using the GovStack Wireframe Kit

Success! The service design team is ready to hand over the service to the developers.

Part 2: Software Development

Target group: IT Architects, Software Engineers and Backend Developers

Objective: Build a testing environment and learn how GovStack architecture can be technically implemented in practice

Deliverables: Deployed of Sandbox in any form

Pre-Step: Inform yourself about the technical theory and practice of the GovStack approach

• Get familiar with the Building Block architecture using GovStack architecture specifications and Building Block specifications
• Compare specification and actual implementation of concepts like “Building Blocks”, “Information Mediator Security Server”, “Emulators”, “Adapters”, … using GovStack Sandbox USCT Technical Demo

  • High-level explanation of the software stack
  • Developer Documentation of the Use Case Demo
  • GitHub Code Repositories

Steps (All steps can be conducted chronologically or on an individual basis and need)

1. Service Design (see above)

2. "

3. "

4. Develop a Frontend. It outlines the user interface and interaction flow, displaying real visual and functional aspects of the digitized solution. Create your own Frontend according to your use case and your needs.

   • If you end or pause with this prototype, you might add Functionality with our generic RPC backend
5. Download GovStack’s Sandbox environment (Minikube container with Use Case Frontend + X-Road + BB Emulator) and deploy and configure X-Road (a possible software for Information Mediator Building Block). Learn how Building Blocks interact via X-Road with the Frontend based on GovStack’s use case “Social Cash Transfer”.

   • Sandbox Minikube Explanatory Videos
   • Sandbox Minikube Github Docs
6. Build Your Emulated Sandbox by recreating GovStack’s Sandbox and extend it with your Frontend and Building Block Emulators needed according to your Service Blueprint.

   • Rebuild infrastructure layer
   • Deploy Information Mediator "X-Road"
   • Deploy your Frontend from step 1

   • Build Building Block Emulators for each BB required according to the Service Blueprint
   • Integrate all components; you might find guidance based on our Social Cash Transfer Demo Github Repositories
7. Assemble Your Full-Stack Sandbox using open source software and assets provided by GovStack, your own Frontend and any Building Block Software of your choice.

   (Extensive knowledge required)

   • Follow step 3

   • Exchange Building Block Emulators with actual Software solutions compliant to the GovStack Specifications

   • Optionally, follow instructions to deploy Open Source Software for Identity, Payment and Consent Building Block

Success! The developer team is ready to scale the testing environment with more citizen services or to bring that one prototype closer to production use.