finish the bd logic
corrected somes models to reflect serialisation changes
updated the readme file