Skip to content

About

System architecture, design documentation, and technical overview for the StoryPoker real-time SaaS collaboration platform for distributed engineering teams.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

StoryPoker Documentation

StoryPoker is a real-time SaaS collaboration platform designed to support agile estimation sessions for distributed software engineering teams.

The platform enables multiple participants to join collaborative estimation rooms, submit estimates, and interact with synchronized workflows in real time through a shared browser-based interface.

Live platform:
https://storypoker.online


Repository purpose

This repository contains selected high-level technical documentation for the StoryPoker platform.

The production frontend and backend repositories are private because they power a live SaaS application. This public repository serves as a documentation hub that consolidates architecture diagrams, backend and frontend design materials, deployment notes, and engineering documentation describing how StoryPoker was designed and implemented.

This repository documents:

  • overall system architecture
  • frontend and backend engineering design
  • deployment structure of the live SaaS platform
  • real-time synchronization behavior
  • workflow-oriented estimation system design
  • productivity-oriented collaboration features

Platform overview

StoryPoker is built using a modern distributed system architecture consisting of:

  • React + TypeScript frontend
  • GraphQL API
  • WebSocket-based real-time communication
  • Node.js backend collaboration service
  • MongoDB persistence layer

The platform is designed to keep collaborative room state synchronized across connected participants, allowing distributed engineering teams to coordinate estimation sessions efficiently.


Quick navigation

Architecture diagrams

Backend documentation

Frontend documentation

Screenshots and reference assets


Repository structure

storypoker-docs/
├── diagrams/
│   ├── frontend-architecture.png
│   └── system-architecture.png
├── docs/
│   ├── backend/
│   │   ├── images/
│   │   ├── ARCHITECTURE.md
│   │   ├── DEPLOYMENT.md
│   │   └── SYSTEM_DESIGN.md
│   └── frontend/
│       ├── ARCHITECTURE.md
│       ├── DEPLOYMENT.md
│       ├── PRODUCTIVITY_IMPACT.md
│       └── SYSTEM_DESIGN.md
└── README.md

Architecture diagrams

System architecture

System Architecture

Frontend architecture

Frontend Architecture


Backend documentation

The backend documentation describes the server-side collaboration service responsible for:

  • persistent room-state management
  • GraphQL API execution
  • event-driven workflow handling
  • real-time synchronization across connected clients

Available backend documentation:


Frontend documentation

The frontend documentation describes the browser-based collaboration interface responsible for:

  • room rendering and interaction
  • player/session continuity
  • workflow-driven estimation UX
  • real-time synchronization with the backend
  • productivity-oriented collaboration behavior

Available frontend documentation:


Selected screenshots

Active estimation room

Active Estimation Room

Vote distribution

Vote Distribution

Session summary

Session Summary

Live GraphQL query example

Live GraphQL Query Example


Documentation scope

This repository contains:

  • architecture diagrams
  • backend and frontend design documentation
  • deployment documentation
  • screenshots of the live platform
  • engineering materials describing the StoryPoker system

This repository does not contain:

  • production application source code
  • internal infrastructure secrets
  • private deployment configuration
  • private backend and frontend repositories

What this documentation covers

This repository documents the following aspects of the StoryPoker platform:

  • distributed SaaS architecture
  • room-centered collaboration model
  • GraphQL API and subscription-driven synchronization
  • frontend-backend service separation
  • deployment design for a live SaaS platform
  • workflow-oriented estimation behavior
  • productivity impact for distributed software teams

Note

This repository is documentation-only.

The production frontend and backend application repositories remain private because they power the live StoryPoker SaaS platform. This repository exists to describe the system architecture, engineering approach, and deployment model used in building the platform.


Author

Valentyn Arkho
Senior Software Engineer / Technical Lead
StoryPoker platform builder

About

System architecture, design documentation, and technical overview for the StoryPoker real-time SaaS collaboration platform for distributed engineering teams.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors