{"id":50916310,"url":"https://github.com/pranjal-barnwal/road-warrior","last_synced_at":"2026-06-16T15:30:57.443Z","repository":{"id":357674983,"uuid":"1191804403","full_name":"pranjal-barnwal/road-warrior","owner":"pranjal-barnwal","description":"Architecture Kata | Internal hackathon in Bentley","archived":false,"fork":false,"pushed_at":"2026-05-13T19:29:56.000Z","size":9125,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-13T21:29:49.285Z","etag":null,"topics":["architecture-katas","bentley-systems","hackathon"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pranjal-barnwal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T15:49:17.000Z","updated_at":"2026-05-13T19:29:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pranjal-barnwal/road-warrior","commit_stats":null,"previous_names":["pranjal-barnwal/road-warrior"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/pranjal-barnwal/road-warrior","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranjal-barnwal%2Froad-warrior","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranjal-barnwal%2Froad-warrior/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranjal-barnwal%2Froad-warrior/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranjal-barnwal%2Froad-warrior/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pranjal-barnwal","download_url":"https://codeload.github.com/pranjal-barnwal/road-warrior/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranjal-barnwal%2Froad-warrior/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34412784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture-katas","bentley-systems","hackathon"],"created_at":"2026-06-16T15:30:56.500Z","updated_at":"2026-06-16T15:30:57.438Z","avatar_url":"https://github.com/pranjal-barnwal.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Road Warrior Architecture Kata\r\n\r\nRoad Warrior is an architecture kata for a next-generation trip management dashboard. The system consolidates existing airline, hotel, and car rental reservations into a traveler-facing dashboard, groups them into trips, keeps them up to date, and supports rich web and mobile experiences.\r\n\r\nThis repository is intentionally documentation-first. It captures the problem framing, the architectural characterization, the key decisions, the diagrams, and the presentation materials used to explain the solution.\r\n\r\n![Road Warrior | Pranjal Kumar, Software Engineer](assets/social-share.jpg)\r\n\r\n## Quick Links\r\n\r\n- [Problem Statement](problem-statement.md)\r\n- [Architecture Characterization Document](ACD.md)\r\n- [ADR Index](ADR/README.md)\r\n- [Presentation Guide](guide.md)\r\n- [Presentation Rubric](presentation-rubric.md)\r\n- [System Context Diagram](diagrams/system_context.png)\r\n- [Container Diagram](diagrams/container.png)\r\n- [Runtime View](diagrams/runtime_view.png)\r\n- [Deployment View](diagrams/deployment.png)\r\n\r\n## What This Repository Contains\r\n\r\n- problem statement and evaluation rubric\r\n- architecture characterization document\r\n- architecture decision records\r\n- PlantUML source and rendered architecture diagrams\r\n- presentation guide and final presentation artifacts\r\n\r\nThere is no runnable application code in this repository. The purpose of the repo is to document and explain the architecture.\r\n\r\n## Repository Map\r\n\r\n### Core Documents\r\n\r\n- [problem-statement.md](problem-statement.md): cleaned copy of the kata brief\r\n- [ACD.md](ACD.md): architecture characterization document covering requirements, constraints, concerns, strategy, C4 views, and deployment view\r\n- [guide.md](guide.md): slide-by-slide presentation guide and speaker support\r\n- [presentation-rubric.md](presentation-rubric.md): presentation scoring criteria used to evaluate the solution\r\n\r\n### ADRs\r\n\r\n- [ADR/README.md](ADR/README.md): ADR index with one-line summaries\r\n- [ADR/ADR-1.md](ADR/ADR-1.md): microservices architecture with event-driven design\r\n- [ADR/ADR-2.md](ADR/ADR-2.md): asynchronous event-driven reservation ingestion\r\n- [ADR/ADR-3.md](ADR/ADR-3.md): real-time client updates via WebSockets or SSE\r\n- [ADR/ADR-4.md](ADR/ADR-4.md): cloud-native deployment with managed services\r\n- [ADR/ADR-5.md](ADR/ADR-5.md): Azure SQL as the primary operational datastore\r\n- [ADR/ADR-6.md](ADR/ADR-6.md): automatic trip grouping with traveler override\r\n\r\n### Diagrams\r\n\r\n- [diagrams/system_context.plantuml](diagrams/system_context.plantuml) and [diagrams/system_context.png](diagrams/system_context.png)\r\n- [diagrams/container.plantuml](diagrams/container.plantuml) and [diagrams/container.png](diagrams/container.png)\r\n- [diagrams/runtime_view.plantuml](diagrams/runtime_view.plantuml) and [diagrams/runtime_view.png](diagrams/runtime_view.png)\r\n- [diagrams/deployment.plantuml](diagrams/deployment.plantuml) and [diagrams/deployment.png](diagrams/deployment.png)\r\n\r\n### Presentation Artifacts\r\n\r\n- [Team 4 - Road Warrior Architecture Kata.pptx](Team%204%20-%20Road%20Warrior%20Architecture%20Kata.pptx)\r\n- [Team 4 - Road Warrior Architecture Kata.pdf](Team%204%20-%20Road%20Warrior%20Architecture%20Kata.pdf)\r\n- [guide.pdf](guide.pdf)\r\n\r\n## Recommended Reading Order\r\n\r\nIf you are using this repository to learn from the architecture, read the documents in this order:\r\n\r\n1. [problem-statement.md](problem-statement.md)\r\n2. [ACD.md](ACD.md)\r\n3. [ADR/README.md](ADR/README.md)\r\n4. Individual ADR files in [ADR](ADR/README.md)\r\n5. Diagrams in [diagrams](diagrams/system_context.png)\r\n6. [guide.md](guide.md)\r\n\r\n## Architecture Summary\r\n\r\nThe solution uses an event-driven microservices architecture with a Backend-for-Frontend pattern.\r\n\r\n- Reservation updates enter asynchronously through agency integration systems.\r\n- A dedicated ingestion flow normalizes and persists reservation changes.\r\n- Trip grouping is treated as a domain capability, not just presentation logic.\r\n- Web and mobile clients are supported through tailored backend experiences.\r\n- Managed cloud services are used to satisfy scalability, elasticity, and availability goals.\r\n\r\nThe architecture is optimized for scale, data freshness, responsiveness, and maintainability, while accepting the trade-offs of distributed-system complexity and eventual consistency.\r\n\r\n## Why This Repo Is Structured This Way\r\n\r\nPublic architecture repositories are most useful when a reader can understand the problem, the decision process, and the resulting design without needing private context. This repository is organized around that learning path:\r\n\r\n- start with the problem\r\n- understand the requirements and constraints\r\n- review the architecture strategy and diagrams\r\n- inspect the decision records\r\n- use the presentation guide to see how the story is communicated\r\n\r\n## Notes for Contributors\r\n\r\nIf you extend this repository, keep it documentation-centric and learner-friendly.\r\n\r\n- Prefer clear filenames and conventional indexes such as [README.md](README.md) in documentation folders.\r\n- Keep diagrams versioned from their PlantUML source files.\r\n- When changing the architecture, update [ACD.md](ACD.md), the relevant ADRs in [ADR](ADR/README.md), and any impacted diagrams together.\r\n- Avoid adding scratch files or editor-generated artifacts to the root of the repo.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranjal-barnwal%2Froad-warrior","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranjal-barnwal%2Froad-warrior","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranjal-barnwal%2Froad-warrior/lists"}