jinda_mind 1.0.0

data/lib/generators/jinda/install_generator.rb

@@ -0,0 +1,269 @@
+module Jinda
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Install jinda component to existing Rails app "
+      def self.source_root
+        File.dirname(__FILE__) + "/templates"
+      end
+      def setup_gems
+        # define required gems: jinda_gem, jinda_dev_gem
+        jinda_gem = 
+          [
+            ["bson", "4.4.2"],
+            ["maruku", "~> 0.7.3"],
+            ["bcrypt"],
+            ["rouge"],
+            ["normalize-rails"],
+            ["font-awesome-rails"],
+            ["font-awesome-sass", "~> 5.12.0"],
+            ["meta-tags"],
+            ["jquery-turbolinks", "2.1.0"],
+            ["mongo", "2.11.3"],
+            ["turbolinks_render"],
+            ["haml-rails", "~> 2.0.1"],
+            ["haml", "~> 5.1", ">= 5.1.2"],
+            ["mail"],
+            ["prawn"],
+            ["redcarpet"],
+            ["oauth2", "1.4.4"],
+            ["omniauth", "1.9.1"],
+            ["omniauth-oauth2", "1.6.0"],
+            ["omniauth-identity", "~> 1.1.1"],
+            ["omniauth-facebook", "6.0.0"],
+            ["omniauth-google-oauth2", "0.8.0"],
+            ["dotenv-rails"],
+            ["cloudinary", "1.13.2"],
+            ["kaminari", "1.2.0"],
+            ["jquery-rails", "4.3.5"],
+            ["mongoid"],
+            ["rexml", "~> 3.2.4"]
+
+        ]
+
+        jinda_custom = 
+          [
+            ["mongoid-paperclip", require: "mongoid_paperclip"],
+            ["kaminari-mongoid", "1.0.1"],
+            ["nokogiri", "~> 1.11.0"]
+          ]
+
+        jinda_dev_gem =
+          [
+            ["shoulda"],
+            ["rspec"],
+            ["rspec-rails"],
+            ["better_errors"],
+            ["binding_of_caller"],
+            ["pry-byebug"],
+            ["factory_bot_rails"],
+            ["database_cleaner-mongoid"],
+            ["guard"],
+            ["guard-rspec"],
+            ["guard-minitest"],
+            ["capybara"],
+            ["selenium-webdriver"],
+            ["rb-fsevent"],
+            ["valid_attribute"],
+            ["faker"]
+          ]
+
+        # Check each jinda_gem and create new array if found one otherwise just create.
+        # Open Gemfile add gem if not exist
+        jinda_gem.each do |g|
+          unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+            if g.count == 2
+                gem g[0], g[1]
+            else
+              gem g[0]
+            end
+          else
+            if g.count == 2
+              xgem_0 = %x(gem list -e #{g[0]})
+              unless xgem_0.include?(("#{g[1]}").gsub(/[~> ]/, ''))
+                say "    Found existing #{xgem_0} in Gemfile or System, Please edit Gemfile", :red
+                gem g[0], g[1]
+              else  
+                say "     Checking #{g[0]} found Ver. #{g[1]} already exist in Gemfile", :green
+              end 
+            end
+            say "     SKIP adding #{g[0]} in Gemfile", :yellow
+          end
+        end
+
+        # create list of gem in sub-group dev and test
+        jinda_dev_new  = Array.new
+        jinda_dev_gem.each do |g|
+          unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+            jinda_dev_new << g
+          else
+            say "     #{g[0]} already exist in Gemfile", :yellow
+          end
+        end
+        unless jinda_dev_new.count == 0
+          gem_group :development, :test do
+            jinda_dev_new.each do |n|
+              if n.count == 1
+                gem n[0]
+              else
+                gem n[0], n[1]
+              end
+            end
+          end
+        end
+
+        # create list of custom gem
+        jinda_custom_new = Array.new
+        jinda_custom.each do |g|
+          unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+            jinda_custom_new << g
+          else
+            say "     #{g[0]} already exist in Gemfile", :yellow
+          end
+        end
+        unless jinda_custom_new.count == 0
+            jinda_custom_new.each do |c|
+            say "     Checking if #{c[0]} already exist in Gemfile", :yellow
+              if c.count == 1
+                gem c[0]
+              else
+                gem c[0], c[1]
+              end
+            end
+        end
+        
+      end
+      def setup_app
+        # inside("public") { run "FileUtils.mv index.html index.html.bak" }
+        inside("db") {(File.file? "seeds.rb") ? (FileUtils.mv "seeds.rb", "seeds.rb.bak") : ( say "no seeds.rb", :green)}
+        inside("app/views/layouts") {(File.file? "application.html.erb") ? (FileUtils.mv 'application.html.erb', 'application.html.erb.bak') : ( say "no app/views/layout/ application.html.erb", :blue )}
+        inside("app/controllers") {(File.file? "application_controller.rb") ? (FileUtils.mv 'application_controller.rb', 'application_controller.rb.bak' ) : ( say "no app/controller/application_controller.rb, :blue ")}
+        inside("app/helpers") {(File.file? "application_helper.rb") ? (FileUtils.mv 'application_helper.rb', 'application_helper.rb.bak') : ( say "no app/helpers/application_helper.rb", :blue)}
+        inside("app/assets/javascripts") {(File.file? 'application.js') ? (FileUtils.mv 'application.js', 'application.js.bak') : ( say "no application.js", :blue)}
+        inside("app/assets/stylesheets") {(File.file? "application.css") ? (FileUtils.mv 'application.css', 'application.css.bak') : ( say "no application.css", :blue)}
+        inside("config/initializers") {(File.file? "omniauth.rb") ? (FileUtils.mv 'omniauth.rb', 'omniauth.rb.bak') : (say "no omniauth.rb", :blue)}
+        inside("config/initializers") {(File.file? "mongoid.rb") ? (FileUtils.mv 'mongoid.rb', 'mongoid.rb.bak') : (say "no mongoid.rb")}
+        inside("app/assets/config") {(File.file? "manifest.js") ? (FileUtils.mv "manifest.js", "manifest.js-rails") : (puts "backup to manifest.js-rails")}
+        directory "app"
+        directory "spec"
+        directory "db"
+        directory "config"
+        directory "dot"
+        # 
+        # CHECK IF EXISTING CODE THEN REQUIRED MANUAL MIGRATION
+        # If no javascripts.js or css (New application), then can use javascript.js or css from org files.
+        # inside("app/assets/javascripts") {(File.file? "application.js") ? ( say "Please include application-org.js in application.js", :red) : (FileUtils.mv 'application-org.js', 'application.js')}
+        # inside("app/assets/stylesheets") {(File.file? "application.css") ? ( say "Please include application-org.css in application.css", :red) : (FileUtils.mv 'application-org.css', 'application.css')}
+        # inside("app/assets/stylesheets") {(File.file? "application.css.scss") ? ( say "Please include application-org.css.scss in application.css.scss", :red) : (FileUtils.mv 'application-org.css.scss', 'application.css.scss')}
+        inside("app/controllers") {(File.file? "admins_controller.rb") ? ( say "   Please merge existing jinda_org/admins_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/admins_controller.rb', 'admins_controller.rb')}
+        inside("app/controllers") {(File.file? "articles_controller.rb") ? ( say "   Please merge existing jinda_org/articles_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/articles_controller.rb', 'articles_controller.rb')}
+        inside("app/controllers") {(File.file? "comments_controller.rb") ? ( say "   Please merge existing jinda_org/comments_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/comments_controller.rb', 'comments_controller.rb')}
+        inside("app/controllers") {(File.file? "docs_controller.rb") ? ( say "   Please merge existing jinda_org/docs_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/docs_controller.rb', 'docs_controller.rb')}
+        inside("app/controllers") {(File.file? "identities_controller.rb") ? ( say "   Please merge existing jinda_org/identities_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/identities_controller.rb', 'identities_controller.rb')}
+        inside("app/controllers") {(File.file? "application_controller.rb") ? ( say "   Pleas merge existing jinda_org/application_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/application_controller.rb', 'application_controller.rb')}
+        ## Moved to Engine
+        # inside("app/controllers") {(File.file? "jinda_controller.rb") ? ( say "   Please merge existing jinda_org/jinda_controller.rb after this installation", :red) : (FileUtils.mv 'jinda_org/jinda_controller.rb', 'jinda_controller.rb')}
+        inside("app/controllers") {(File.file? "password_resets_controller.rb") ? ( say "   Please merge existing jinda_org/password_resets_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/password_resets_controller.rb', 'password_resets_controller.rb')}
+        inside("app/controllers") {(File.file? "password_resets.rb") ? ( say "   Please merge existing jinda_org/password_resets.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/password_resets.rb', 'password_resets.rb')}
+        inside("app/controllers") {(File.file? "sessions_controller.rb") ? ( say "   Please merge existing jinda_org/sessions_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/sessions_controller.rb', 'sessions_controller.rb')}
+        inside("app/controllers") {(File.file? "users_controller.rb") ? ( say "   Please merge existing jinda_org/users_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/users_controller.rb', 'users_controller.rb')}
+        inside("app/controllers") {(File.file? "sitemap_controller.rb") ? ( say "   Please merge existing jinda_org/sitemap_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/sitemap_controller.rb', 'sitemap_controller.rb')}
+        inside("app/controllers") {(File.file? "notes_controller.rb") ? ( say "   Please merge existing jinda_org/notes_controller.rb after this installation", :yellow) : (FileUtils.mv 'jinda_org/notes_controller.rb', 'notes_controller.rb')}
+      end
+      # routes created each line as reversed order in routes
+      # Moved routes to Engine
+      def setup_routes
+        route "root :to => 'jinda#index'"        
+      end
+
+      def setup_env
+        FileUtils.mv "README.md", "README.md.bak"
+        create_file 'README.md', ''
+        application do
+          %q{
+  # Jinda default
+  config.generators do |g|
+    g.orm             :mongoid
+    g.template_engine :haml
+    g.test_framework  :rspec
+    g.integration_tool :rspec
+  end
+
+  # config time zone
+  config.time_zone = "Central Time (US & Canada)"
+
+  # gmail config
+  # config.action_mailer.delivery_method = :smtp
+  # config.action_mailer.smtp_settings = {
+  #   :address              => "smtp.gmail.com",
+  #   :port                 => 587,
+  #   :user_name            => 'user@gmail.com',
+  #   :password             => 'secret',
+  #   :authentication       => 'plain',
+  #   :enable_starttls_auto => true  }
+  # config.action_mailer.raise_delivery_errors = true
+  # config.action_mailer.perform_deliveries = true
+          }
+        end
+        initializer "jinda.rb" do
+          %q{# encoding: utf-8
+MM = "#{Rails.root}/app/jinda/index.mm"
+DEFAULT_TITLE = 'Jinda'
+DEFAULT_HEADER = 'Jinda'
+DEFAULT_DESCRIPTION = 'Rails Application Generator'
+DEFAULT_KEYWORDS = %w[Jinda Rails ruby Generator, Prateep Kul]
+GMAP = false
+# ADSENSE = true
+NEXT = "Next >"
+# comment IMAGE_LOCATION to use cloudinary (specify params in config/cloudinary.yml)
+IMAGE_LOCATION = "upload"
+# for debugging
+# DONT_SEND_MAIL = true
+          }
+        end
+        # Move mongoid.rb to jinda:config
+        # To avoid repeate install jinda:install crash
+        initializer "mongoid.rb" do
+          %q{# encoding: utf-8
+  #
+  # Mongoid 6 follows the new pattern of AR5 requiring a belongs_to relation to always require its parent
+  # belongs_to` will now trigger a validation error by default if the association is not present.
+  # You can turn this off on a per-association basis with `optional: true`.
+  # (Note this new default only applies to new Rails apps that will be generated with
+  # `config.active_record.belongs_to_required_by_default = true` in initializer.)
+  #
+  Mongoid::Config.belongs_to_required_by_default = false
+          }
+        end
+
+        inject_into_file 'config/environment.rb', :after => "initialize!"  do
+          "\n\n# hack to fix cloudinary error https://github.com/archiloque/rest-client/issues/141" +
+            "\nclass Hash\n  remove_method :read\nrescue\nend"
+        end
+        inject_into_file 'config/environments/development.rb', :after => 'config.action_mailer.raise_delivery_errors = false' do
+          "\n  config.action_mailer.default_url_options = { :host => 'localhost:3000' }"
+          "\n  config.assets.check_precompiled_asset = false"
+        end
+        inject_into_file 'config/environments/production.rb', :after => 'config.assets.compile = false' do
+          "\n  config.assets.compile = true"
+        end
+        inject_into_file 'config/initializers/assets.rb', :after => '# Precompile additional assets.
+        ' do        
+          "Rails.application.config.assets.precompile += %w( sarabun.css )" +
+            "\nRails.application.config.assets.precompile += %w( disable_enter_key.js )\n"
+        end
+      end
+
+      def finish
+        say "\n"
+        say "Jinda gem ready for next configuration install.\n"
+        say "Normally you will use  the following command:\n"
+        say "----------------------------------------\n"
+        say "bundle install\n"
+        say "rails generate jinda:config\n"
+        say "rake jinda:seed\n"
+        say 
+        say "----------------------------------------\n"
+      end
+    end
+  end
+end

data/lib/generators/jinda/installer/gems_install.rb

@@ -0,0 +1,132 @@
+def setup_gems
+	#         # define required gems: jinda_gem, jinda_dev_gem
+	jinda_gem = 
+		[
+			["bson", "4.4.2"],
+			["maruku", "~> 0.7.3"],
+			["bcrypt"],
+			["rouge"],
+			["normalize-rails"],
+			["font-awesome-rails"],
+			["font-awesome-sass", "~> 5.12.0"],
+			["meta-tags"],
+			["jquery-turbolinks", "2.1.0"],
+			["mongo", "2.11.3"],
+			["turbolinks_render"],
+			["haml-rails", "~> 2.0.1"],
+			["haml", "~> 5.1", ">= 5.1.2"],
+			["mail"],
+			["prawn"],
+			["redcarpet"],
+			["oauth2", "1.4.4"],
+			["omniauth", "1.9.1"],
+			["omniauth-oauth2", "1.6.0"],
+			["omniauth-identity", "~> 1.1.1"],
+			["omniauth-facebook", "6.0.0"],
+			["omniauth-google-oauth2", "0.8.0"],
+			["dotenv-rails"],
+			["cloudinary", "1.13.2"],
+			["kaminari", "1.2.0"],
+			["jquery-rails", "4.3.5"]
+	]
+	# 
+	jinda_custom_gem = 
+		[
+			["mongoid-paperclip", require: "mongoid_paperclip"],
+			["kaminari-mongoid", "1.0.1"],
+			["nokogiri", "~> 1.11.0"],
+			["mongoid", git: "git@github.com:kul1/mongoid-jinda.git"]
+	# ["mongoid", "~> 7.1.0"]
+	]
+	# 
+	jinda_dev_gem =
+		[
+			["shoulda"],
+			["rspec"],
+			["rspec-rails"],
+			["better_errors"],
+			["binding_of_caller"],
+			["pry-byebug"],
+			["factory_bot_rails"],
+			["database_cleaner"],
+			["guard"],
+			["guard-rspec"],
+			["guard-minitest"],
+			["capybara"],
+			["selenium-webdriver"],
+			["rb-fsevent"],
+			["valid_attribute"],
+			["faker"]
+	]
+
+	# Check each jinda_gem and create new array if found one otherwise just create.
+	# Open Gemfile add gem if not exist
+	jinda_gem.each do |g|
+		unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+			if g.count == 2
+				gem g[0], g[1]
+			else
+				gem g[0]
+			end
+		else
+			if g.count == 2
+				xgem_0 = %x(gem list -e #{g[0]})
+				unless xgem_0.include?(("#{g[1]}").gsub(/[~> ]/, ''))
+					# puts "    Found existing #{xgem_0} in Gemfile or System, Please edit Gemfile", :red
+					puts "    Found existing #{xgem_0} in Gemfile or System, Please edit Gemfile"
+					gem g[0], g[1]
+				else  
+					# puts "     Checking #{g[0]} found Ver. #{g[1]} already exist in Gemfile", :green
+					puts "     Checking #{g[0]} found Ver. #{g[1]} already exist in Gemfile"
+				end 
+			end
+			# puts "     SKIP adding #{g[0]} in Gemfile", :yellow
+			puts "     SKIP adding #{g[0]} in Gemfile"
+		end
+	end
+
+	# create list of gem in sub-group dev and test
+	jinda_dev_new  = Array.new
+	jinda_dev_gem.each do |g|
+		unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+			jinda_dev_new << g
+		else
+			# puts "     #{g[0]} already exist in Gemfile", :yellow
+			puts "     #{g[0]} already exist in Gemfile"
+		end
+	end
+	unless jinda_dev_new.count == 0
+		gem_group :development, :test do
+			jinda_dev_new.each do |n|
+				if n.count == 1
+					gem n[0]
+				else
+					gem n[0], n[1]
+				end
+			end
+		end
+	end
+
+	# create list of custom gem
+	jinda_custom_new = Array.new
+	jinda_custom_gem.each do |g|
+		# unless (%x(gem list -e --no-versions #{g[0]})) == "#{g[0]}\n"
+		unless File.read("Gemfile").include?("#{g[0]}, #{g[1]}")
+			jinda_custom_new << g
+		else
+			puts "     #{g[0]} already exist in Gemfile", :yellow
+			puts "     #{g[0]} already exist in Gemfile", :yellow
+		end
+	end
+	unless jinda_custom_new.count == 0
+		jinda_custom_new.each do |c|
+			# puts "     Checking if #{c[0]} already exist in Gemfile", :yellow
+			puts "     Checking if #{c[0]} already exist in Gemfile"
+			if c.count == 1
+				gem c[0]
+			else
+				gem c[0], c[1]
+			end
+		end
+	end
+end

data/lib/generators/jinda/installer/test.rb

@@ -0,0 +1,6 @@
+binding.pry
+puts 'This is test'
+puts 'This is test'
+puts 'This is test'
+puts 'This is test'
+puts 'This is test'

data/lib/generators/jinda/minitest_generator.rb

@@ -0,0 +1,30 @@
+module Jinda
+  module Generators
+    class MinitestGenerator < Rails::Generators::Base
+      def self.source_root
+        File.dirname(__FILE__) + "/templates"
+      end
+
+      desc "config minitest"
+      def gen_minitest
+        #copy test directory with jinda test for minitest
+        directory "test"
+        run "guard init minitest"
+      end
+
+      desc "Finish guard init minitest"
+      def finish 
+        puts "      Finish guard init minitest.\n"
+        puts "      Finish copy test directory for minitest\n"
+        puts "      Finish copy jinda test for minitest\n"
+        puts "-----------------------------------------\n"
+        puts "      Please remove spec directory if exist\n"
+        puts "      To start guard run:\n"
+        puts "-----------------------------------------\n"
+        puts "guard \n"
+        puts "-----------------------------------------\n"
+      end      
+    end
+  end
+end
+

data/lib/generators/jinda/rspec_generator.rb

@@ -0,0 +1,30 @@
+module Jinda
+  module Generators
+    class RspecGenerator < Rails::Generators::Base
+      def self.source_root
+        File.dirname(__FILE__) + "/templates"
+      end
+
+      desc "config rspec"
+      def gen_rspec
+        # generate "rspec:install"
+        # empty_directory "spec/support" 
+        # empty_directory "spec/model"
+        # empty_directory "spec/routing"
+        # copy_file ".rspec", ".rspec.bak"
+        run "guard init"
+        copy_file "dotrspec",".rspec"
+      end
+
+      desc "Finish generate rspec:install"
+      def finish 
+        puts "      Finish generate rspec:install.\n"
+        puts "      To start guard run:\n"
+        puts "-----------------------------------------\n"
+        puts "guard \n"
+        puts "-----------------------------------------\n"
+      end      
+    end
+  end
+end
+

data/lib/generators/jinda/templates/Dockerfile

@@ -0,0 +1,26 @@
+# https://docs.docker.com/compose/rails/
+FROM ruby:2.6.8
+RUN apt-get update -qq 
+RUN mkdir /myapp
+WORKDIR /myapp
+COPY Gemfile /myapp/Gemfile
+COPY Gemfile.lock /myapp/Gemfile.lock
+# Fix from here
+RUN  gem install bundler:2.2.27
+# Fix end here
+RUN bundle install
+COPY . /myapp
+
+# Set Rails environment to production
+# ENV RAILS_ENV production
+# RUN curl -sL https://deb.nodesource.com/setup_10.x | bash - \
+#    && apt install -y nodejs
+
+# Add a script to be executed every time the container starts.
+COPY entrypoint.sh /usr/bin/
+RUN chmod +x /usr/bin/entrypoint.sh
+ENTRYPOINT ["entrypoint.sh"]
+EXPOSE 3000
+
+# Start the main process.
+CMD ["rails", "server", "-b", "0.0.0.0"]

data/lib/generators/jinda/templates/README.md

@@ -0,0 +1,173 @@
+# Jinda
+Rails Application Generator using Freemind
+
+* [jinda](https://github.com/kul1/jinda)
+  - ![jinda-screen](https://user-images.githubusercontent.com/3953832/41832753-0143339a-7813-11e8-9ef9-c1601443c604.png)
+
+## Additional Extension themes also available at 
+* [jinda_adminlte](https://github.com/kul1/jinda_adminlte)
+  - ![j18-screen](https://user-images.githubusercontent.com/3953832/34298172-faa7e962-e6e1-11e7-93e2-19dfd4ab42af.png)
+
+* [jinda_adminbsb](https://github.com/kul1/jinda_adminbsb)
+  - ![jinda-bsb](https://user-images.githubusercontent.com/3953832/34320779-bb0980d2-e7c6-11e7-855c-fafc23487ba5.png)
+
+## Prerequisites
+
+These versions works for sure but others may do.
+
+* Ruby 2.7.0
+* Rails 6.0.3
+* MongoDB 6
+* Freemind 1.0.1
+
+## Convention
+
+* database is MongoDB
+* images stored in upload directory, unset IMAGE_LOCATION in `initializer/jinda.rb` to use Cloudinary
+* mail use Gmail SMTP, config in `config/application.rb`
+* authentication use omniauth-identity
+
+## Sample Application
+
+Supposed we want to create ecommerce web site, first create a Rails
+app without ActiveRecord
+
+    $ rails new YOURAPP -BOTJ
+
+## Add jinda to your Gemfile:
+
+    gem 'jinda'
+
+For Development (most updated)
+
+    gem 'jinda', github:'kul1/jinda'
+
+depend on your operating system, you may need to uncomment
+
+    gem 'therubyracer', :platforms => :ruby
+
+install gems
+
+    $ bundle
+
+generate jinda application
+
+    $ rails generate jinda:install
+
+Then run bundle again to install additional gems added by jinda
+
+    $ bundle
+
+    (or run all with "sh install.sh" )
+
+configure mongoid, omniauth
+
+    $ rails generate jinda:config
+
+    Please make sure mongod is running then create admin user
+
+    $ rails jinda:seed
+
+now the application is ready, start it as any Rails application
+
+    $ rails server
+
+go to http://localhost:3000, click *Sign In* on the left menu, and enter user name `admin` and password `secret`
+
+![login](https://user-images.githubusercontent.com/3953832/41832924-d868f8f0-7813-11e8-93bb-19c0357cf604.png)
+
+Now open file `app/jinda/index.mm` using Freemind
+
+![index mm](https://user-images.githubusercontent.com/3953832/34680350-7906fbe8-f45e-11e7-8df5-969b4c735c6e.png)
+
+The 3 main branches are
+
+* models - this defines all the models to use in the application
+* services - this defines services which will be come the menu on the left of the screen. There will be 2 levels; the first sub branch is the main menu (modules) and the second sub branch is the sub menu (services)
+* roles - this defines role for all users
+
+### models
+
+Fiirst, we need to create some product so we click on models we'll see 2 models person and address. These are sample only. You can delete them or modify them however you want. We'll take a look at them first
+
+![models](https://user-images.githubusercontent.com/3953832/34681380-50b27dd6-f461-11e7-8472-3a14d76e0f16.png)
+
+The first sub branch (e.g. person) is the model name. According to Rails convention, this should be a singular word. The next sub branch are columns in the database. Let's take a look at each:
+
+* `fname` - this create a column (field) called fname which is a String by default
+* `sex: integer` - this create a column called sex, it is integer so must be explicity defined. The next sub branch (1: male) is disregarded by Jinda so we can put whatever we want. Here I just put some reminder.
+* `belongs_to :address` - here we have ![pen](https://cloud.githubusercontent.com/assets/3953832/25600038/3a4ffb66-2f0b-11e7-9f03-b875e550eefe.png)
+ icon. this means whatever text on this line will be added as is to the model Jinda generates. You use this to specify anything you want such as  association, index, remarks in code, etc. according to mongoid gem. To draw the icon, rest mouse on the branch and hit &ltAlt-I&gt.
+* `dob: date` - use any type that mongoid provides.
+* `photo` - for file field, just use String here. Jinda will receive the binary file and store in file system or cloudinary then generate a url link to it.
+
+In this example we just want a product model, so delete the person and address model and add a product branch like so
+
+![freemind1](https://user-images.githubusercontent.com/3953832/34680349-78f1eea6-f45e-11e7-8e43-50d9025bb449.png)
+
+Save the mind map then run:
+
+    rake jinda:update
+
+This will create file `app/models/product.rb`. In this file, note the comment lines   `# jinda begin` and ` # jinda end`. Everything inside these comments will get overwritten when you change the models branch in the mind map so if you need to put anything inside here, use the mind map instead. You can add anything outside these comment lines which will be preserved when doing jinda:update.
+
+### services
+
+Next we'll add some product into the database, we'll first take a look at the services branch, which already has 3 sub branches; users, admins, and devs. Unlike models person and address branches, these branches are actively used by the system so I recommend that you leave them alone. Let's open the users branch
+
+![image](https://cloud.githubusercontent.com/assets/3953832/25599895/ecf46466-2f09-11e7-82aa-81ade6b9cd83.png)
+
+The text `users:User` on the sub branch has these implications:
+
+* `users` correspond to `app/controllers/users_controller.rb` which already exist when you do rails generate jinda:install. New branch will create new controller if not exist. In Jinda term, this will be called module.
+* `User` will create entry in main menu on the left of the screen. You don't see it in the screenshot above because it's controlled by the sub branch `role:m` which means this menu only available for login member. If you already signed in as admin, you should see it now.
+
+The next sub branches has the following:
+
+* `role: m` - means that this module (menu) is available only to user who has role m (if you open the role branch now will see that role m is member). All registered user has role m by default. User who is not log on would not be able to access this module.
+* `link:info: /users` - means that this is a link, the format is link: *submenu label* : *url* where submenu label is the text to show in the submenu and url is the link to go to, in this case, it woud go to http://localhost:3000/users which will perform index action of UsersController.
+* `user:edit` the branch that do not start with role:, rule:, nor link: will be a Jinda service. You will then specify the sequence of the execution as in this example there are 3 sub branches - enter_user, update_user, and rule:login? Let's take a look at them:
+
+* `enter_user:edit` - the first step is to display a form to input user information, this is accompanied by icon ![image](https://cloud.githubusercontent.com/assets/3953832/25599946/47c32cf6-2f0a-11e7-80a8-2c02c6294c9a.png)
+ which means user interface screen. and will correspond to a view file `app/views/users/user/enter_user.html.erb` where `/users` comes from the module name (the sub branch of services), `/user` comes from the service name (the sub branch of users), and `enter_user.html.erb` comes from the first part of this branch. The `edit` after the colon is just a description of this step. This branch also has sub branch `rule:login? && own_xmain?` which specify rule for this step that the user must be login and can continue this task if he is the one who started it. *task* in here means each instance of service.
+* `update_user` - this icon ![image](https://cloud.githubusercontent.com/assets/3953832/25599976/87b69ad2-2f0a-11e7-9aba-1bd4e9546d3e.png) means to execute method update_user within `users_controller.rb`
+
+Armed with this knowledge, we are ready to add new product into our application like so:
+
+![add_enter](https://cloud.githubusercontent.com/assets/3953832/25600158/582d1fbe-2f0c-11e7-9bde-01a195a45b6c.png)
+
+
+To generate controller and views we save this mind map and run
+
+    rake jinda:update
+
+open file `app/views/products/add/enter.html.erb` you'll see some sample view already in there but commented. edit the file so it look like this
+
+
+![product_enter](https://cloud.githubusercontent.com/assets/3953832/25600363/e5cc8282-2f0d-11e7-81f7-273c9bdc1a63.png)
+
+
+Note that we do not specify form_tag and submit_tag, these will be supplied by Jinda.
+
+then open file `app/controllers/products_controller.rb` and add `create` method as follow. The method name has to be correspond to the ![bookmark](http://songrit.googlecode.com/files/bookmark.png) branch.
+
+![products_controller](http://songrit.googlecode.com/files/products_controller.png)
+
+## Testing
+
+run following command:
+
+    rails generate jinda:rspec
+    guard init
+    guard
+
+![rspec](https://user-images.githubusercontent.com/3953832/34680352-7931d426-f45e-11e7-9f40-8b85b94c61bf.png)
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request