TRUNK-4159 Add Orded OrderFrequency to the data model

TRUNK-4159 added fixes for comments as a result reviewing my previous commit

Removed default value of null from order_frequency.retired_by column - TRUNK-4159

Added javadocs for OrderFrequency class - TRUNK-4159