More design notes including new class diagram