updated design doc, sequence diagram