пришлось заменить модель
Нет, для этого придумана архитектура и неймспейсы :)
Техника, обычно, не делается такой, что бы к ней нужна была инструкция на 100 страниц.
Заваленная тонной подробных расшифровок каждого класса во всем фреймворке
чем в убогой доке.