add code

NOTES.md

@@ -0,0 +1,54 @@
+## Files
+The current python code revolves around the implementation of the Cell and Player classes primarily used for creating and keeping track of move paths.
+* The Cell class represents a cell on a chessboard which is capable of initiating moves. It houses a make_moves() method which generates possible new moves 
+from the cell's current pose.
+
+* The Player class is a child class that inherits from Cell. The Player has additional methods for plotting paths and finding shortest paths from the source to the destination.
+
+## Main Topics & Sub Topic References
+* Scripted Graph Path Management: The focus of this script is on managing paths in a graph-like structure. It uses Cell and Player classes to map out the structure and traverse it effectively.
+* Graph Rendering & Visualization: The extension to this script mainly refers to the rendering of paths into a .dot file using graphviz package. This enhances visualization of the paths generated by the script.
+* Tree Traversal: The script generates possible moves from every cell, effectively generating a tree. It shapes up to be a Breadth-first search (BFS) based traversal.
+* Reuse and Extend Code: All methods are generalized and can be inherited. With slight modification, you can use the Cell class for any game that has movement defined in x-y coordinates. For further extension, you can inherit from these classes and define custom movements.
+Extending the Current Script
+* Render Graphs in Realtime: While currently the paths are getting saved in a '.dot' file, it is possible to extend the script to render the graph in real time, using libraries like matplotlib.
+* Calculate Shortest Path: A method can be added to not just store all possible paths but calculate the shortest path between the Player and target cells.
+* Add Error Handling: Add further error handling to check if destination provided by user is within board limits and if there's any possible path beforehand.
+* Add User Interface: For ease of use, a graphical user interface could be implemented where users can interactively put in their source and target cells and the script would visually lay out the shortest path.
+
+## Creating a Dataset for a Classifier for Valid Knight Moves
+* Data Structure: You could structure each observation in the dataset as a pair (or "tuple") of positions (x, y), which represent the board position of the knight and the potential move to a target square.
+* Positive Examples: Start by generating a set of valid moves. For each position on the board, calculate where a knight's valid moves would land you. Each of these represents a positive example in your training set, a valid move.
+* Negative Examples: For negative examples, you may consider moves that land outside of the chess board or moves that are not L-shaped (2 squares in one direction, 1 square in the perpendicular direction).
+* Labels: Your dataset should have labels marking whether a particular move is valid or not. Once you have a sizable dataset, you could feed this into a classification model to identify whether potential knight moves are valid or not.
+
+## The existing script can be transformed into a secure cloud service using myriad of cloud providers such as AWS, Google Cloud Platform (GCP), Azure, etc. 
+Here's a general approach:
+
+### API Development
+
+Wrap the logic of script into an API using a web framework such as Flask or Django. This API should accept the source and target locations as inputs and return the shortest path or paths.
+
+### Deployment
+
+Deploy API on a cloud platform using the following steps.
+
+1. **Infrastructure as Code**: Tools like Terraform can be used for defining and providing your infrastructure as code. This ensures your infrastructure setup is repeatable, reliable and version controlled.
+
+2. **Containerize with Docker**: Docker can be used to create a containerized version of your application ensuring it runs identically in every environment.
+
+3. **Manage with Kubernetes**: Kubernetes is a popular choice for deploying and managing containerized applications. It provides features for scaling and self-healing your application.
+
+4. **Automate with CI/CD pipelines**: Incorporate Continuous Integration/Continuous Deployment pipelines to automate the building, testing and deployment of your application. Platforms such as Jenkins, GitLab CI, and CircleCI can facilitate this.
+
+### Security 
+
+Secure API endpoints using SSL encryption (HTTPS). Use API keys or JWT tokens for the authentication and authorization of requests.
+
+### Scaling
+
+Take advantage of load balancing and auto-scaling features to ensure your service can handle varying loads and maintain resilience.
+
+### Database
+
+Consider adding a database to store users' queries and results. This can be useful for tracking and monitoring purposes, and also enables the return of cached results for previously made requests.