diff --git a/Gemfile b/Gemfile
index 00fb92d3e..13d8aeb47 100644
--- a/Gemfile
+++ b/Gemfile
@@ -160,4 +160,7 @@ group :development do
gem 'guard-rspec', '~> 4.3.1'
gem 'rubocop', '~> 0.26.1'
gem 'guard-rubocop', '~> 1.1.0'
+
+ # to generate database diagrams
+ gem 'railroady'
end
diff --git a/Gemfile.lock b/Gemfile.lock
index 3175db835..e6b6cfc1d 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -210,6 +210,7 @@ GEM
rack (1.5.2)
rack-test (0.6.2)
rack (>= 1.0)
+ railroady (1.2.0)
rails (4.1.4)
actionmailer (= 4.1.4)
actionpack (= 4.1.4)
@@ -403,6 +404,7 @@ DEPENDENCIES
phantomjs-binaries (~> 1.9.2.4)
poltergeist (~> 1.5.1)
pry (~> 0.10.1)
+ railroady
rails (= 4.1.4)
rails-settings-cached (= 0.4.1)
ransack (~> 1.3.0)
diff --git a/README.md b/README.md
index a1ad4df70..072773aea 100644
--- a/README.md
+++ b/README.md
@@ -224,7 +224,9 @@ Copy the files from $mod_epp/examples/cgis to /usr/lib/cgi-bin/epp
Documentation
-------------
-[EPP request-response examples](https://github.com/internetee/registry/blob/master/doc/epp-doc.md)
+* [EPP request-response examples](https://github.com/internetee/registry/blob/master/doc/epp-doc.md)
+* [Database diagram](https://github.com/internetee/registry/blob/master/doc/models_complete.svg)
+* [Controllers diagram](https://github.com/internetee/registry/blob/master/doc/controllers_complete.svg)
Deployment
diff --git a/doc/controllers_brief.svg b/doc/controllers_brief.svg
new file mode 100644
index 000000000..12c11a890
--- /dev/null
+++ b/doc/controllers_brief.svg
@@ -0,0 +1,101 @@
+
+
+
+
+
diff --git a/doc/controllers_complete.svg b/doc/controllers_complete.svg
new file mode 100644
index 000000000..c4e29780c
--- /dev/null
+++ b/doc/controllers_complete.svg
@@ -0,0 +1,238 @@
+
+
+
+
+
diff --git a/doc/models_brief.svg b/doc/models_brief.svg
new file mode 100644
index 000000000..f0e13dbea
--- /dev/null
+++ b/doc/models_brief.svg
@@ -0,0 +1,421 @@
+
+
+
+
+
diff --git a/doc/models_complete.svg b/doc/models_complete.svg
new file mode 100644
index 000000000..3117c3bfa
--- /dev/null
+++ b/doc/models_complete.svg
@@ -0,0 +1,691 @@
+
+
+
+
+