update architectural documentation and Gemfile specs