re #1 added phpDoc to all services classes + some fixes and refactoring