Web Access to Generative Procedures in a Narrative Engine

Praca magisterska skupia się na stworzeniu aplikacji umożliwiającej internetowy dostęp do możliwości silnika fabularnego StoryGraph. Początkowo zamierzano oprzeć projekt na technologii .NET, jednak ze względu na trudności integracyjne z silnikiem napisanym w Pythonie, zdecydowano się na użycie frameworka fastAPI. Główne wyzwanie polegało na przechowywaniu stanu gry rozpoczętej przez użytkownika. Rozważano trzy opcje: bazę danych, kolekcje danych oraz zapis w pliku. Ostatecznie wybrano zapis w plikach JSON, co wymusiło przechowywanie stanu gry w plikach o takim samym rozszerzeniu. W celu zapewnienia autoryzacji i autentykacji użytkowników, zastosowano JWT Bearer. W rozdziale technologicznym omówiono użyte technologie, w tym API, REST API, Python, fastAPI, Swagger oraz JSON Web Token (JWT). W implementacji opisano strukturę programu oraz kod, w tym pliki index.py, routers, services, engine i models. Rozdział wdrożenia opisuje proces umieszczenia aplikacji na platformie Azure oraz wykorzystanie Blob Service do przechowywania plików JSON. Na zakończenie, autor podkreśla, że pisanie aplikacji w Pythonie było rozwijającym doświadczeniem, mimo napotkanych problemów z wdrożeniem na platformę Azure. Wnioski z pracy wskazują na konieczność dalszej rozbudowy i optymalizacji aplikacji.

The master's thesis focuses on creating an application that allows internet access to the StoryGraph narrative engine's capabilities. Initially, the project was intended to be based on .NET technology, but due to integration difficulties with the engine written in Python, the decision was made to use the fastAPI framework. The main challenge was to store the state of the game started by the user. Three options were considered: a database, data collections, and file storage. Ultimately, JSON file storage was chosen, necessitating the storage of game states in files with the same extension. To ensure user authorization and authentication, JWT Bearer was used. The technology chapter discusses the technologies used, including API, REST API, Python, fastAPI, Swagger, and JSON Web Token (JWT). The implementation section describes the program structure and code, including files such as index.py, routers, services, engine, and models. The deployment chapter outlines the process of placing the application on the Azure platform and using Blob Service for storing JSON files. In conclusion, the author emphasizes that writing the application in Python was a rewarding experience, despite encountering problems with deployment on the Azure platform. The findings of the work indicate the need for further development and optimization of the application.