Original version was published in October 2025, updated: January 2026
This is a system design document for a Microsoft Teams bot that replaces JIRA’s clunky worklog UI with a single-view Adaptive Card interface.
JIRA Worklogs Bot: System Design Document
What This Document Covers
This is a complete system design for a Teams bot that solves the weekly pain of JIRA time reporting:
- Problem analysis and design goals
- Microsoft Teams Adaptive Card interface design
- Spring Boot 3 + AWS Lambda backend architecture
- Data flow and API contracts
- Load simulation and performance SLOs
- Production readiness checklist and evolution roadmap
Estimated reading time: 20-25 minutes
Who This Is For
- Engineers frustrated with JIRA’s worklog UI
- Teams developers building Adaptive Card integrations
- Backend engineers designing serverless Java applications
- System designers evaluating AWS Lambda for low-traffic, bursty workloads
- Anyone interested in load analysis for realistic traffic patterns
The document includes the actual Adaptive Card JSON structure, sequence diagrams, data models, and a mathematical load simulation proving that a single Lambda function handles the Friday afternoon spike comfortably.
Questions or improvements? Open an issue on the repo or e-mail me.
