chore: format code and update readme

feat: df for extra info and pydantic validator

feat: behavior circumstance processing with pydantic

feat: json schema set-up

refactor: folders for code subparts and pydantic classes