How brpapa/recursion-tree-visualizer works
• Backend (Lambda Function): Show the serverless function that is responsible for executing the user’s code to generate the recursion tree. Inside this component, note the presence of internal modules for validations, error handling, the runner logic (separating out steps for initial, intermediate, final, and source code compilation), and shared static code (utilities and templates).
• Deployment Infrastructure (Terraform): Illustrate how Terraform is used to deploy the Lambda function (and possibly other infrastructure). Although it’s a couple of files, it conceptually ties into how the system is provisioned on the cloud.
Interactions and dependencies
• Lambda function processing flow: Receiving the event payload, running through various steps (as indicated by subdirectories under the “runner” folder such as “initial-tree”, “intermediate-tree”, etc.), and then returning the computed tree visualization.
• Optionally, show that during local development and production, there are separate deployment considerations – the Web App is shipped via Vercel while the Lambda is packaged with Docker (local emulation) and deployed with Terraform.
Architectural patterns and design principles
• Separation of Concerns: Clearly separate frontend (user interaction and presentation logic) from backend processing (code execution and tree generation).
• Extensibility: The architecture supports plug-and-play components. For example, the runner steps can be thought of as a pipeline processing the user code, which is modular and testable.
• Serverless and Infrastructure as Code: Emphasize the serverless nature of the Lambda component along with Terraform-managed deployment.
Additional details
• You may also include a note that tests (found under the “lambda/tests” and “web/tests” directories) ensure each module works as expected, which adds quality assurance to the system’s design.
• Do not leave out the README-provided demo video and live project links that help contextualize how a user would interact with the system.