update readme

Gemfile

@@ -3,6 +3,7 @@ source 'https://rubygems.org'
 gem 'quickbooks-ruby'
 gem 'oauth2'
 gem 'roxml'
+gem 'nhtsa_vin'
 gem 'will_paginate'
 gem 'rails-jquery-autocomplete'
 gem 'jquery-ui-rails'

README.md

@@ -92,7 +92,9 @@ To enable automatic Time Activity entries for an Issue, you simply need to assig
 
 ## TODO
     
-*   Add hooks to intergrate other plugins, i.e. customer vehicles for example
+*   Separate Vehicles into a separate plugin (I use Redmine for my automotive shop management 😉)
+    *   Checkout branch dev-6 for a stripped down version 
+    
 *   MORE Stuff as I make it up...
     
 

app/controllers/customers_controller.rb

@@ -38,6 +38,12 @@ class CustomersController < ApplicationController
     params.require(:customer).permit(:name, :email, :primary_phone, :mobile_phone, :phone_number, :notes)
   end
 
+  # getter method for a customer's vehicles
+  # used for customer autocomplete field / issue form
+  def filter_vehicles_by_customer
+    @filtered_vehicles = Vehicle.all.where(customer_id: params[:selected_customer])
+  end
+
   # getter method for a customer's invoices
   # used for customer autocomplete field / issue form
   def filter_invoices_by_customer
@@ -81,6 +87,7 @@ class CustomersController < ApplicationController
   def show
     begin
       @customer = Customer.find_by_id(params[:id])
+      @vehicles = @customer.vehicles.paginate(:page => params[:page])
       @issues = @customer.issues.order(id: :desc)
       @billing_address = address_to_s(@customer.billing_address)
       @shipping_address = address_to_s(@customer.shipping_address)

app/controllers/vehicles_controller.rb

@@ -0,0 +1,125 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# This controller class will handle map management
+class VehiclesController < ApplicationController
+
+  include AuthHelper
+
+  before_action :require_user
+
+  def allowed_params
+    params.require(:vehicle).permit(:year, :make, :model, :customer_id, :notes, :vin)
+  end
+
+  # display a list of all vehicles
+  def index
+    if params[:customer_id]
+      begin
+        @vehicles = Customer.find_by_id(params[:customer_id]).vehicles.paginate(:page => params[:page])
+      rescue ActiveRecord::RecordNotFound
+        render_404
+      end
+    end
+
+    # search for a vehicle by vin
+    if params[:search]
+      @vehicles = Vehicle.search(params[:search]).paginate(:page => params[:page])
+      if only_one_non_zero?(@vehicles)
+        redirect_to @vehicles.first
+      end
+    end
+  end
+
+  # return an HTML form for creating a new vehicle
+  def new
+    @vehicle = Vehicle.new
+    @customer = Customer.find_by_id(params[:customer_id]) if params[:customer_id]
+  end
+
+  # create a new vehicle
+  def create
+    @vehicle = Vehicle.new(allowed_params)
+    if @vehicle.save
+      flash[:notice] = "New Vehicle Created"
+      redirect_to @vehicle
+    else
+      flash[:error] = @vehicle.errors.full_messages.to_sentence
+      redirect_to Vehicle.find_by_vin @vehicle.vin
+    end
+  end
+
+  # display a specific vehicle
+  def show
+    begin
+      @vehicle = Vehicle.find_by_id(params[:id])
+      @vin = @vehicle.vin.scan(/.{1,9}/) if @vehicle.vin
+      @issues = @vehicle.issues.order(id: :desc)
+      @closed_issues = (@issues - @issues.open)
+    rescue 
+      render_404
+    end
+  end
+
+  # return an HTML form for editing a vehicle
+  def edit
+    begin
+      @vehicle = Vehicle.find_by_id(params[:id])
+      @customer = @vehicle.customer
+    rescue 
+      render_404
+    end
+  end
+
+  # update a specific vehicle
+  def update
+    @customer = params[:customer]
+    begin
+      @vehicle = Vehicle.find_by_id(params[:id])
+      if @vehicle.update(allowed_params)
+        flash[:notice] = "Vehicle updated"
+        redirect_to @vehicle
+      else
+        redirect_to edit_vehicle_path
+      end
+      #show any errors anyways
+      flash[:error] = @vehicle.errors.full_messages.to_sentence unless @vehicle.errors.empty?
+    rescue 
+      render_404
+    end
+  end
+
+  # delete a specific vehicle
+  def destroy
+    begin
+      Vehicle.find_by_id(params[:id]).destroy
+      flash[:notice] = "Vehicle deleted successfully"
+      redirect_to action: :index
+    rescue 
+      render_404
+    end
+  end
+
+  private
+
+  # checks to see if there is only one item in an array
+  # @return true if array only has one item
+  def only_one_non_zero?( array )
+    found_non_zero = false
+    array.each do |val|
+      if val!=0
+        return false if found_non_zero
+        found_non_zero = true
+      end
+    end
+    found_non_zero
+  end
+
+end

app/models/customer.rb

@@ -13,6 +13,7 @@ class Customer < ActiveRecord::Base
   has_many :issues
   has_many :invoices
   has_many :estimates
+  has_many :vehicles
   
   validates_presence_of :id, :name
   

app/models/invoice.rb

@@ -109,15 +109,30 @@ class Invoice < ActiveRecord::Base
     # TODO break if Invoice.find(invoice.id).cf_sync_confict
     is_changed = false
     
-    logger.debug "Calling :process_invoice_custom_fields hook"
-    context = Redmine::Hook.call_hook :process_invoice_custom_fields, { issue: issue, invoice: invoice } 
+    # update the invoive custom fields with infomation from the issue if available
+    invoice.custom_fields.each { |cf|
       
-    unless context.nil?
-      logger.debug "We have a context!"
-      context= context.first
-      issue = context[:issue]
-      invoice = context[:invoice]
-      is_changed = context[:is_changed]
+      # VIN from the attached vehicle
+      # TODO move this into seperate plugin
+      # TODO create hook for seperate plugin 
+      begin
+        if cf.name.eql? "VIN"
+          # Only update if blank to prevent infite loops
+          # TODO check cf_sync_confict flag once implemented
+          if cf.string_value.to_s.blank?
+            logger.info " VIN was blank, updating the invoice vin in quickbooks"
+            vin = Vehicle.find(issue.vehicles_id).vin
+            break if vin.nil?
+            if not cf.string_value.to_s.eql? vin
+              cf.string_value = vin.to_s
+              logger.info "VIN has changed"
+              is_changed = true
+            end
+
+          end
+        end
+      rescue
+        #do nothing
       end
       
       # Custom Values
@@ -136,6 +151,7 @@ class Invoice < ActiveRecord::Base
       rescue
         # Nothing to do here, there is no match
       end
+    }
 
     # Push updates
     begin

app/models/vehicle.rb

@@ -0,0 +1,98 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class Vehicle < ActiveRecord::Base
+  
+  belongs_to :customer
+  has_many :issues, :foreign_key => 'vehicles_id'
+  
+  validates_presence_of :customer
+  validates :vin, uniqueness: true
+  before_save :decode_vin
+  
+  self.primary_key = :id
+  
+  # returns a human readable string
+  def to_s
+    if year.nil? or make.nil? or model.nil?
+      return "#{vin}"
+    else
+      split_vin = vin.scan(/.{1,9}/)
+      return "#{year} #{make} #{model} - #{split_vin[1]}"
+    end
+  end
+  
+  # returns the raw JSON details from NHTSA
+  def details
+    get_details if @details.nil?
+    return @details
+  end
+  
+  # Force Upper Case for make numbers
+  def make=(val)
+    # The to_s is in case you get nil/non-string
+    write_attribute(:make, val.to_s.titleize)
+  end
+  
+  # Force Upper Case for model numbers
+  def model=(val)
+    # The to_s is in case you get nil/non-string
+    write_attribute(:model, val.to_s.titleize)
+  end
+  
+  # Force Upper Case & strip VIN of all illegal chars (for barcode scanner)
+  def vin=(val)
+    val = val.to_s.upcase.gsub(/[^A-HJ-NPR-Za-hj-npr-z\d]+/,"")
+    write_attribute(:vin, val)
+  end
+  
+  # search for a vin
+  def self.search(search)
+    where("vin LIKE ?", "%#{search}%")
+  end
+	
+  # decodes a vin and updates self
+  def decode_vin
+    get_details
+    if @details
+      begin
+        self.year = @details.year unless @details.year.nil?
+        self.make = @details.make unless @details.make.nil?
+        self.model = @details.model unless @details.model.nil?
+        self.doors = @details.doors unless @details.doors.nil?
+        self.trim = @details.trim unless @details.trim.nil?
+      rescue Exception => e
+        errors.add(:vin, e.message)
+      end
+    end
+    self.name = to_s
+  end
+  
+  private
+  
+  # init method to pull JSON details from NHTSA
+  def get_details
+    if self.vin?
+      #validate the vin before calling a remote server
+      validation = NhtsaVin.validate(self.vin)
+      begin
+        #if the vin validation failed, raise an exception and exit
+        raise RuntimeError, validation.error unless validation.valid?
+        # query NHTSA for details on the vin
+        query = NhtsaVin.get(self.vin)
+        raise RuntimeError, query.error unless query.valid?
+        @details = query.response
+      rescue Exception => e
+        errors.add(:vin, e.message)
+      end
+    end
+  end
+  
+end

app/views/customers/filter_vehicles_by_customer.js.erb

@@ -0,0 +1 @@
+$('select#issue_vehicles_id').html('<%= j content_tag(:option,'',:value=>"")+options_from_collection_for_select(@filtered_vehicles, :id, :to_s) %>');

app/views/customers/show.html.erb

@@ -39,7 +39,11 @@
       </div>
         
       <div class="splitcontentleft">
-        <%= call_hook :show_customer_view_right, {customer: @customer} %>
+        <h4><%=t(:field_vehicles)%>:</h4>
+        <%= render :partial => 'vehicles/list' %>
+        <div style="float: right;">
+          <%= button_to "New Vehicle", new_customer_vehicle_path(@customer), method: :get %>
+        </div>
       </div>
     </div>
 

app/views/issues/_form_hook.html.erb

@@ -8,3 +8,7 @@
 <p>
     <%= select_estimate %>
 </p> 
+
+<p>
+    <%= vehicle %>
+</p>

app/views/issues/_show_details.html.erb

@@ -17,6 +17,23 @@
    </div>
       
   <div class="splitcontentleft">
-    <%= call_hook :show_issue_view_right, {issue: issue} %>
+    <div class="vehicle attribute">
+      <div class="label"><span><%=t(:field_vehicle)%></span>:</div>
+      <div class="value"><%= vehicle %></div>
+    </div>
+       
+    <div class="vehicle_vin attribute">
+      <div class="label"><span><%=t(:field_vin)%></span>:</div>
+      <div class="value"><%=split_vin[0] if split_vin%><b><%=split_vin[1] if split_vin%></b></div>
+    </div>
+       
+    <div class="vehicle_notes attribute">
+      <div class="label"><span><%=t(:field_notes)%></span>:</div>
+      <div class="value">
+        <pre id="note-display" style="text-align: left; white-space: pre-wrap; font-family: inherit; ">
+          <%=notes%>
+        </pre>
+      </div>
+    </div>
   </div>
 </div>

app/views/vehicles/_details.html.erb

@@ -0,0 +1,53 @@
+<div class="issue">
+  <div class="splitcontent">
+    <div class="splitcontentleft">
+      <h4><%=t(:label_details)%>:</h4>
+      
+      <table>
+        <tbody>
+
+          <tr>
+            <th><%= t(:field_customer)%></th>
+            <td><%= link_to vehicle.customer.name, customer_path(vehicle.customer) %></td>
+          </tr>
+        
+          <tr>
+            <th><%= t(:field_vehicle) %></th>
+            <td><%= vehicle.to_s %></td>
+          </tr>
+          
+          <tr>
+            <th><%= t(:field_vin) %></th>
+            <td><%= @vin[0] if @vin %><b><%=@vin[1] if @vin%></b></td>
+          </tr>
+          
+          <th><%= t(:label_trim) %></th>
+            <td><%= vehicle.doors %> <%=t(:label_door) if vehicle.doors? %> <%= vehicle.trim %></td>
+          </tr>
+        </tbody>
+      </table>
+      
+    </div>
+
+    <div class="splitcontentleft">
+
+      <h4><%=t(:field_notes)%>:</h4>
+        <pre id="note-display" style="text-align: left; white-space: pre-wrap; font-family: inherit; ">
+          <td><%= vehicle.notes %></td>
+        </pre>
+      </tr>
+
+      <script>
+        const preElement = document.getElementById('note-display');
+        // This takes the text, trims the edges, and puts it back
+        preElement.textContent = preElement.textContent.trim();
+      </script>
+
+    </div>
+  </div>
+</div>
+
+<div style="float: right;">
+  <%= button_to t(:label_edit), edit_vehicle_path(vehicle), method: :get%> 
+  <%= button_to t(:label_delete), vehicle, method: :delete, data: {confirm: t(:warn_ru_sure)} %> 
+</div>

app/views/vehicles/_form.html.erb

@@ -0,0 +1,56 @@
+<div class="row">
+  <div class="span6 columns">
+    <fieldset>
+
+      <%= form_for @vehicle do |f| %> 
+        <div class="clearfix">
+          <%=t(:field_customer)%>:
+          <div class="input">
+            <%= f.autocomplete_field :customer, autocomplete_customer_name_customers_path, :value => @customer.name, :update_elements => {:id => '#customer_id', :value => '#issue_customer'}, :required => true %>
+            <%= f.hidden_field :customer_id, :id => "customer_id", :value => @customer.id %>
+          </div>
+        </div>
+        
+        <div class="clearfix">
+          <%=t(:label_year)%>: 
+          <div class="input">
+            <%= f.number_field :year, :autocomplete => "off"  %>
+          </div>
+        </div>
+        
+        <div class="clearfix">
+          <%=t(:label_make)%>:
+          <div class="input">
+            <%= f.text_field :make, :autocomplete => "off"  %>
+          </div>
+        </div>
+        
+        <div class="clearfix">
+          <%=t(:label_model)%>:
+          <div class="input">
+            <%= f.text_field :model, :autocomplete => "off"  %>
+          </div>
+        </div>
+        
+        <div class="clearfix">
+          <%=t(:field_vin)%>:
+          <div class="input">
+            <%= f.text_field :vin , :autofocus => true %>
+          </div>
+        </div>
+        
+        <div class="clearfix">
+          <%=t(:field_notes)%>: 
+          <div class="input">
+            <%= f.text_area :notes, :cols => 60, :rows => 10, :no_label => true %>
+          </div>
+        </div>
+        
+       <div class="actions">
+        <%= f.submit %>
+       </div>
+      <% end %>
+
+    </fieldset>
+  </div>
+</div>

app/views/vehicles/_list.html.erb

@@ -0,0 +1,28 @@
+<% if @vehicles.present? %>
+
+  <% @vehicles.each do |vehicle| %>
+    <div class="row">
+      <div>
+        <b><%= link_to "##{vehicle.id}", vehicle_path(vehicle) %> </b>
+      </div>
+      
+      <div>
+        <%= vehicle.to_s %>
+        <br/>
+        <%= vehicle.customer %>
+        <br/>
+        <%= vehicle.vin.scan(/.{1,9}/)[0] if vehicle.vin %><b><%=vehicle.vin.scan(/.{1,9}/)[1] if vehicle.vin%></b>
+      </div>
+    </div>
+    <br/>
+  <% end %>
+
+  <div class="actions">
+    <%= will_paginate @vehicles %>
+  </div>
+
+<p><%=t(:label_matching)%> <%=@vehicles.count%> <%=t(:field_vehicles) %> </p>
+
+<% else %>
+  <p><%=t(:label_no_vehicles)%> <%= params[:search] %>.</p>
+<% end %>

app/views/vehicles/_search.html.erb

@@ -0,0 +1,4 @@
+<%= form_tag(vehicles_path, :method => "get", id: "search-form") do %>
+  <%= text_field_tag :search, params[:search], placeholder: t(:label_search_vin), :autocomplete => "off" %>
+  <%= submit_tag t(:label_search) %>
+<% end %>

app/views/vehicles/_vehicle.html.erb

@@ -0,0 +1 @@
+<option value="<%= vehicle.id %>"><%= vehicle.to_s.titleize %></option>

app/views/vehicles/edit.html.erb

@@ -0,0 +1,3 @@
+<h1><%=t(:label_edit_customer_vehicle)%></h1> 
+<br/> 
+<%= render :partial => 'vehicles/form' %>

app/views/vehicles/index.html.erb

@@ -0,0 +1,4 @@
+<h2><%=t(:label_cusomer_vehicles)%> <span style="float:right"> <%= render :partial => 'vehicles/search' %> </span> </h2> 
+<br/> 
+
+<%= render :partial => 'vehicles/list' %>

app/views/vehicles/new.html.erb

@@ -0,0 +1,3 @@
+<h2><%=t(:label_new_vehicle)%></h2> 
+<br/> 
+<%= render :partial => 'vehicles/form' %>

app/views/vehicles/show.html.erb

@@ -0,0 +1,11 @@
+<h2><%=t(:field_vehicle)%> #<%=@vehicle.id%></h2>
+
+<%= render :partial => 'vehicles/details', locals: {vehicle: @vehicle} %>
+
+<h3><%=@issues.open.count%> <%=t(:label_open_issues)%></h3>
+
+<%= render :partial => 'issues/list_simple', locals: {issues: @issues.open} %>
+
+<h3><%=@closed_issues.count%> <%=t(:label_closed_issues)%></h3>
+
+<%= render :partial => 'issues/list_simple', locals: {issues: (@closed_issues)} %>

assets/javascripts/application.js

@@ -1,5 +1,10 @@
 $(function() {
   $("input#issue_customer_id").on("change", function() {
+    $.ajax({
+      url: "/filter_vehicles_by_customer",
+      type: "GET",
+      data: { selected_customer: $("input#issue_customer_id").val() }
+    });
     
     $.ajax({
       url: "/filter_estimates_by_customer",
@@ -8,4 +13,11 @@ $(function() {
     });
   });
     
+  $("input#project_customer_id").on("change", function() {
+    $.ajax({
+      url: "/filter_vehicles_by_customer",
+      type: "GET",
+      data: { selected_customer: $("input#project_customer_id").val() }
+    });
+  });
 });

config/locales/en.yml

@@ -16,6 +16,9 @@ en:
   field_employee: "Employee"
   field_invoice: "Invoice"
   field_estimate: "Estimate" 
+  field_vehicles: "Vehicles"
+  field_vehicle: "Vehicle"
+  field_vin: "VIN"
   field_notes: "Notes"
   field_billed: "Billed"
   label_week: "Week"
@@ -28,8 +31,13 @@ en:
   label_year: "Year"
   label_make: " Make"
   label_model: "Model"
+  label_no_vehicles: "There are no vehicles containing the term(s)"
   label_no_customers: "There are no customers containing the term(s)"
   label_matching: "Matching "
+  label_search_vin: "Search Vehicles by VIN"
+  label_edit_customer_vehicle: "Edit Customer Vehicle"
+  label_cusomer_vehicles: "Customer Vehicles"
+  label_new_vehicle: "New Customer Vehicle"
   label_open_issues: "Open Issues"
   label_closed_issues: "Closed Issues"
   label_sync: "Sync"

config/routes.rb

@@ -31,9 +31,15 @@ get 'customers/view/:token', :to => 'customers#view', as: :view
 get 'customers/share/:id', :to => 'customers#share', as: :share
 
 #java script routes
+get 'filter_vehicles_by_customer' => 'customers#filter_vehicles_by_customer'
 get 'filter_estimates_by_customer' => 'customers#filter_estimates_by_customer'
 get 'filter_invoices_by_customer' => 'customers#filter_invoices_by_customer'
 
+# Nest Vehicles under customers
 resources :customers do
+  resources :vehicles
   get :autocomplete_customer_name, :on => :collection
 end
+
+#allow for just vehicles too
+resources :vehicles

db/migrate/016_create_vehicles.rb

@@ -0,0 +1,24 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class CreateVehicles < ActiveRecord::Migration[5.1]
+  
+  def change  
+    create_table :vehicles do |t| 
+      t.integer :year
+      t.string  :make
+      t.string  :model
+      t.string  :vin
+      t.text    :notes
+    end
+    
+    add_reference :vehicles, :qbo_customer, index: true
+  end
+end

db/migrate/017_update_issues_with_vehicles.rb

@@ -0,0 +1,15 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class UpdateIssuesWithVehicles < ActiveRecord::Migration[5.1]
+  def change
+    add_reference :issues, :vehicles, index: true
+  end
+end

db/migrate/018_update_vehicles.rb

@@ -0,0 +1,15 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class UpdateVehicles < ActiveRecord::Migration[5.1]
+  def change
+    add_column :vehicles, :name, :text
+  end
+end

db/migrate/019_qbocustomers_to_customers.rb

@@ -12,5 +12,6 @@ class QbocustomersToCustomers< ActiveRecord::Migration[5.1]
   def change
     rename_table :qbo_customers, :customers
     rename_column :issues, :qbo_customer_id, :customer_id
+    rename_column :vehicles, :qbo_customer_id, :customer_id
   end 
 end

db/migrate/025_update_projects.rb

@@ -11,5 +11,6 @@
 class UpdateProjects < ActiveRecord::Migration[5.1]
   def change
     add_reference :projects, :customer, index: true
+    add_reference :projects, :vehicle, index: true
   end
 end

db/migrate/033_update_vehicles_trim.rb

@@ -0,0 +1,33 @@
+#The MIT License (MIT)
+#
+#Copyright (c) 2016 - 2026 rick barrette
+#
+#Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+#
+#The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+#
+#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+class UpdateVehiclesTrim < ActiveRecord::Migration[5.1]
+  def change
+    begin
+      add_column :vehicles, :doors, :text
+      add_column :vehicles, :trim, :text
+
+      reversible do |direction|
+        direction.up {
+
+          # Update local vehicle database by forcing a save, look at before_save
+          vehicles = Vehicle.all
+          vehicles.each { |vehicle|
+              vehicle.save!
+          }
+      }
+      end
+    rescue
+      logger.error "Failed to update vehicles"
+    end
+
+  end
+
+end

init.rb

@@ -11,7 +11,7 @@
 Redmine::Plugin.register :redmine_qbo do
   
   # About
-  name 'Redmine QBO DEVELOPMENT plugin'
+  name 'Redmine Quickbooks Online plugin'
   author 'Rick Barrette'
   description 'This is a plugin for Redmine to intergrate with Quickbooks Online to allow for seamless intergration CRM and invoicing of completed issues'
   version '2026.1.0'
@@ -25,9 +25,11 @@ Redmine::Plugin.register :redmine_qbo do
   Issue.safe_attributes 'item_id'
   Issue.safe_attributes 'estimate_id'
   Issue.safe_attributes 'invoice_id'
+  Issue.safe_attributes 'vehicles_id'
   User.safe_attributes 'employee_id'
   TimeEntry.safe_attributes 'billed'
   Project.safe_attributes 'customer_id'
+  Project.safe_attributes 'vehicle_id'
 
   # set per_page globally
   WillPaginate.per_page = 20
@@ -35,9 +37,11 @@ Redmine::Plugin.register :redmine_qbo do
   # Permissions for security
   permission :view_customers, :customers => :index, :public => false
   permission :add_customers, :customers => :new, :public => false
+  permission :view_vehicles, :vehicles => :new, :public => false
 
   # Register top menu items
   menu :top_menu, :customers, { :controller => :customers, :action => :index }, :caption => 'Customers', :if => Proc.new {User.current.logged?}
+  menu :top_menu, :vehicles, { :controller => :vehicles, :action => :index }, :caption => 'Vehicles', :if => Proc.new { User.current.logged? }
     
 end
 

lib/hooks/issues_form_hook_listener.rb

@@ -22,11 +22,13 @@ module Hooks
       # This is done to preload customer information if the entire project is dedicated to a customer
       if context[:project]
         selected_customer = context[:project].customer ? context[:project].customer.id : nil
+        selected_vehicle = context[:project].vehicle ? context[:project].vehicle.id : nil
       end
 
       # Check to see if the issue already belongs to a customer
       selected_customer = issue.customer ? issue.customer.id  : nil
       selected_estimate = issue.estimate ? issue.estimate.id  : nil
+      selected_vehicle = issue.vehicles_id ? issue.vehicles_id : nil
 
       # Gernerate edit.js link
       js_link = issue.new_record? ? "updateIssueFrom('/projects/rmt/issues/new.js', this)" : "updateIssueFrom('/issues/#{issue.id}/edit.js', this)"
@@ -49,15 +51,22 @@ module Hooks
         :id => "issue_customer_id",
         :onchange => js_link
 
-      # Load estimates
+      # Load estimates & vehicles
       if issue.customer
+        if customer.vehicles
+          vehicles = customer.vehicles.pluck(:name, :id)
+        else
+          vehicles = [nil].compact
+        end
         estimates = customer.estimates.pluck(:doc_number, :id).sort! {|x, y| y <=> x}
       else
+        vehicles = [nil].compact
         estimates = [nil].compact
       end
 
-      # Generate the drop down list of quickbooks estimates
+      # Generate the drop down list of quickbooks estimates & vehicles
       select_estimate = f.select :estimate_id, estimates, :selected => selected_estimate, include_blank: true
+      vehicle = f.select :vehicles_id, vehicles, :selected => selected_vehicle, include_blank: true
 
       # Pass all prebuilt form components to our partial
       context[:controller].send(:render_to_string, {
@@ -67,6 +76,7 @@ module Hooks
             customer_id: customer_id, 
             js_link: js_link, 
             select_estimate: select_estimate,
+            vehicle: vehicle
           } 
         }
       )

lib/hooks/issues_show_hook_listener.rb

@@ -38,13 +38,26 @@ module Hooks
         end
       end
       
+      begin
+        v = Vehicle.find(issue.vehicles_id)
+        vehicle = link_to v.to_s, vehicle_path( v.id )
+        vin = v.vin 
+        notes = v.notes
+      rescue
+        #do nothing
+      end
+      
+      split_vin = vin.scan(/.{1,9}/) if vin
+
       context[:controller].send(:render_to_string, {
         :partial => 'issues/show_details',
           locals: {
             customer: customer, 
             estimate_link: estimate_link, 
             invoice_link: invoice_link, 
-            issue: issue
+            vehicle: vehicle, 
+            split_vin: split_vin,
+            notes: notes
           } 
         })
     end

lib/hooks/projects_form_hook_listener.rb

@@ -18,13 +18,22 @@ module Hooks
   
       # Check to see if there is a quickbooks user attached to the issue
       selected_customer = context[:project].customer ? context[:project].customer : nil
+      selected_vehicle = context[:project].vehicle_id ? context[:project].vehicle_id : nil
       
       # Load customer information
       customer = Customer.find_by_id(selected_customer) if selected_customer
       search_customer = f.autocomplete_field :customer, autocomplete_customer_name_customers_path, :selected => selected_customer, :update_elements => {:id => '#project_customer_id', :value => '#project_customer'}
       customer_id = f.hidden_field :customer_id, :id => "project_customer_id"
       
-      return "<p><label for=\"project_customer\">Customer</label>#{search_customer} #{customer_id}</p>"
+      if context[:project].customer
+        vehicles = customer.vehicles.pluck(:name, :id).sort!
+      else
+        vehicles = [nil].compact
+      end
+      
+      vehicle = f.select :vehicle_id, vehicles, :selected => selected_vehicle, include_blank: true
+      
+      return "<p><label for=\"project_customer\">Customer</label>#{search_customer} #{customer_id}</p> <p>#{vehicle}</p>"
     end
   end
 

lib/patches/issue_patch.rb

@@ -28,6 +28,7 @@ module Patches
         belongs_to :customer_token, primary_key: :id
         belongs_to :estimate, primary_key: :id
         has_and_belongs_to_many :invoices
+        belongs_to :vehicle, primary_key: :id
       end
       
     end

lib/patches/pdf_patch.rb

@@ -58,9 +58,13 @@ module Patches
         #left << [l(:field_category), issue.category] unless issue.disabled_core_fields.include?('category_id')
         #left << [l(:field_fixed_version), issue.fixed_version] unless issue.disabled_core_fields.include?('fixed_version_id')
         
-        logger.debug "Calling :pdf_left hook"
-        context = Redmine::Hook.call_hook :pdf_left, { array: left, issue: issue }
-        left << context.first unless context.nil?
+        v = Vehicle.find_by_id(issue.vehicles_id)
+        vehicle = v ? v.to_s : nil
+        vin = v ? v.vin : nil
+        notes = v ? v.notes : nil
+        left << [l(:field_vehicles), vehicle]
+        left << [l(:field_vin), vin ? vin.gsub(/(.{9})/, '\1 ') : nil]
+        #left << [l(:field_notes), notes]
         
         right = []
         right << [l(:field_start_date), format_date(issue.start_date)] unless issue.disabled_core_fields.include?('start_date')
@@ -68,10 +72,7 @@ module Patches
         right << [l(:field_done_ratio), "#{issue.done_ratio}%"] unless issue.disabled_core_fields.include?('done_ratio')
         right << [l(:field_estimated_hours), l_hours(issue.estimated_hours)] unless issue.disabled_core_fields.include?('estimated_hours')
         right << [l(:label_spent_time), l_hours(issue.total_spent_hours)] if User.current.allowed_to?(:view_time_entries, issue.project)
-        
-        logger.debug "Calling :pdf_right hook"
-        context = Redmine::Hook.call_hook :pdf_right, { array: right, issue: issue }
-        right << context.first unless context.nil?
+        right << [l(:field_notes), notes]
 
         rows = left.size > right.size ? left.size : right.size
         while left.size < rows

lib/patches/project_patch.rb

@@ -24,6 +24,7 @@ module Patches
       # Same as typing in the class 
       base.class_eval do
         belongs_to :customer, primary_key: :id
+        belongs_to :vehicle, primary_key: :id
       end
     end