Document the Game Engine

As a developer, I want the game engine code to be well-documented, so that other developers can understand and contribute to it.

• Write docstrings for all functions and classes.
• Document the structure and flow of the game engine code.
• Document how to run the tests for the game engine.
• Produce process flow diagrams with mermaid