lesli 5.0.0

data/app/helpers/lesli/navigation_helper.rb

@@ -0,0 +1,349 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Your Smart Business Assistant.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// ·
+
+=end
+
+module Lesli
+    module NavigationHelper
+        # Prints a html link inside a list item
+        def navigation_item(path, label, icon = nil, reload: false)
+            # default vue router links for single page applications
+            html_element = "router-link"
+            html_options = { to: path }
+
+            # if reload is nedeed, we use a standard "a" tag
+            if reload
+                html_element = "a"
+                html_options = { href: path }
+            end
+
+            content_tag(:li) do
+                content_tag(html_element, html_options) do
+                    # print a simple menu item (without icon)
+                    concat content_tag(:span, label, class: "text iconless") unless icon
+
+                    # print a full menu item if icon was requested
+                    if icon
+                        concat content_tag("span", nil, class: [icon, "icono"])
+                        concat content_tag(:span, label, class: "text")
+                    end
+                end
+            end
+        end
+
+        # Prints a separator line
+        def navigation_separator
+            content_tag(:li) do
+                content_tag(:hr)
+            end
+        end
+
+        # 00.00 System administration
+        def navigation_engine_admin(title: "Administration", subtitle: "Users, privileges, access roles.")
+            navigation_engine_item(title, subtitle, "admin", lesli_admin.root_path, controller_path.include?("lesli_admin"))
+        end
+
+        # ADMINISTRATION
+
+        # 01.01 Team engine
+        def navigation_engine_team(title: "Team", subtitle: "Human Resources Management")
+            return unless defined? CloudTeam
+
+            navigation_engine_item(title, subtitle, "team", cloud_team.root_path,
+                                   controller_path.include?("cloud_team"))
+        end
+
+        # SALES & MARKETING
+
+        # 02.03 Drop engine
+        def navigation_engine_word(title: "Word", subtitle: "Content Management System")
+            return unless defined? CloudWord
+
+            navigation_engine_item(title, subtitle, "word", cloud_word.root_path,
+                                   controller_path.include?("cloud_word"))
+        end
+
+        # 02.04 House engine
+        def navigation_engine_house(title: "House", subtitle: "cloud_house/house-logo.svg")
+            return unless defined? CloudHouse
+
+            navigation_engine_item(title, subtitle, "house", cloud_house.root_path,
+                                   controller_path.include?("cloud_house"))
+        end
+
+        # 02.05 Mailer engine
+        def navigation_engine_mailer(title: "Mailer", subtitle: "Email automation system")
+            return unless defined? CloudMailer
+
+            navigation_engine_item(title, subtitle, "mailer", cloud_mailer.root_path,
+                                   controller_path.include?("cloud_mailer"))
+        end
+
+        # 02.08 Proposal engine
+        def navigation_engine_proposal(title: "Proposal", subtitle: "cloud_proposal/proposal-logo.svg")
+            return unless defined? CloudProposal
+
+            navigation_engine_item(title, subtitle, "proposal", cloud_proposal.root_path,
+                                   controller_path.include?("cloud_proposal"))
+        end
+
+        # PRODUCTIVITY & TEAMWORK
+
+        # 03.01 Driver engine
+        def navigation_engine_driver(title: "Driver", subtitle: "Calendar")
+            return unless defined? CloudDriver
+
+            navigation_engine_item(title, subtitle, "driver", cloud_driver.root_path,
+                                   controller_path.include?("cloud_driver"))
+        end
+
+        # 03.02 Work engine
+        def navigation_engine_work(title: "Work", subtitle: "Dynamic Project Management")
+            return unless defined? CloudWork
+
+            navigation_engine_item(title, subtitle, "work", cloud_work.root_path,
+                                   controller_path.include?("cloud_work"))
+        end
+
+        # 03.03 Focus engine
+        def navigation_engine_focus(title: "Tasks", subtitle: "Task Management")
+            return unless defined? CloudFocus
+
+            navigation_engine_item(title, subtitle, "focus", cloud_focus.root_path,
+                                   controller_path.include?("cloud_focus"))
+        end
+
+        # 03.05 Text engine
+        def navigation_engine_text(title: "Text", subtitle: "cloud_text/text-logo.svg")
+            return unless defined? CloudText
+
+            navigation_engine_item(title, subtitle, "text", cloud_text.root_path,
+                                   controller_path.include?("cloud_text"))
+        end
+
+        # 03.07 Social engine
+        def navigation_engine_social(title: "Social", subtitle: "Team social network")
+            return unless defined? CloudSocial
+
+            navigation_engine_item(title, subtitle, "social", cloud_social.root_path,
+                                   controller_path.include?("cloud_social"))
+        end
+
+        # 03.08 Bell engine
+        def navigation_engine_bell(title: "Notifications", subtitle: "Announcements and notifications")
+            return unless defined? LesliBell
+
+            navigation_engine_item(title, subtitle, "bell", lesli_bell.root_path,
+                                   controller_path.include?("lesli_bell"))
+        end
+
+        # 03.09 Time engine
+        def navigation_engine_time(title: "Time managment", subtitle: "Track your time")
+            return unless defined? CloudTime
+
+            navigation_engine_item(title, subtitle, "time", cloud_time.root_path,
+                                   controller_path.include?("cloud_time"))
+        end
+
+        # 03.10 Talk engine
+        def navigation_engine_talk(title: "Talk", subtitle: "Real-time communication")
+            return unless defined? CloudTalk
+
+            navigation_engine_item(title, subtitle, "talk", cloud_talk.root_path,
+                                   controller_path.include?("cloud_talk"))
+        end
+
+        # 03.11 Storage engine
+        def navigation_engine_storage(title: "Storage", subtitle: "Cloud files management")
+            return unless defined? CloudStorage
+
+            navigation_engine_item(title, subtitle, "storage", cloud_storage.root_path,
+                                   controller_path.include?("cloud_storage"))
+        end
+
+        # FINANCE
+
+        # 04.01 Books engine
+        def navigation_engine_books(title: "Books", subtitle: "cloud_books/books-logo.svg")
+            return unless defined? CloudBooks
+
+            navigation_engine_item(title, subtitle, "books", cloud_books.root_path,
+                                   controller_path.include?("cloud_books"))
+        end
+
+        # 04.03 Things engine
+        def navigation_engine_things(title: "Things", subtitle: "cloud_things/things-logo.svg")
+            return unless defined? CloudThings
+
+            navigation_engine_item(title, subtitle, "things", cloud_things.root_path,
+                                   controller_path.include?("cloud_things"))
+        end
+
+        # 04.05 Realty engine
+        def navigation_engine_realty(title: "Realty", subtitle: "cloud_realty/realty-logo.svg")
+            return unless defined? CloudRealty
+
+            navigation_engine_item(title, subtitle, "realty", cloud_realty.root_path,
+                                   controller_path.include?("cloud_realty"))
+        end
+
+        # ANALYTICS
+
+        # 05.04 Insights engine
+        def navigation_engine_insights(title: "Insights", subtitle: "cloud_insights/insights-logo.svg")
+            return unless defined? CloudInsights
+
+            navigation_engine_item(title, subtitle, "insights", cloud_insights.root_path,
+                                   controller_path.include?("cloud_insights"))
+        end
+
+        # INTELLIGENCE
+
+        # 06.06 Scraper engine
+        def navigation_engine_scraper(title: "Scraper", subtitle: "Scraper")
+            return unless defined? CloudScraper
+
+            navigation_engine_item(title, subtitle, "scraper", cloud_scraper.root_path,
+                                   controller_path.include?("cloud_scraper"))
+        end
+
+        # IT & HELP DESK
+
+        # 07.01 Kb engine
+        def navigation_engine_kb(title: "Kb", subtitle: "cloud_kb/kb-logo.svg")
+            return unless defined? CloudKb
+
+            navigation_engine_item(title, subtitle, "kb", cloud_kb.root_path, controller_path.include?("cloud_kb"))
+        end
+
+        # 07.02 Help engine
+        def navigation_engine_help(title: "Help", subtitle: "Support Ticket System")
+            return unless defined? CloudHelp
+
+            navigation_engine_item(title, subtitle, "help", cloud_help.root_path,
+                                   controller_path.include?("cloud_help"))
+        end
+
+        # 07.03 Portal engine
+        def navigation_engine_portal(title: "Portal", subtitle: "cloud_portal/portal-logo.svg")
+            return unless defined? CloudPortal
+
+            navigation_engine_item(title, subtitle, "portal", cloud_portal.root_path,
+                                   controller_path.include?("cloud_portal"))
+        end
+
+        # 07.05 Shared engine
+        def navigation_engine_shared(title: "Shared", subtitle: "Shared & Open resources")
+            return unless defined? CloudShared
+
+            navigation_engine_item(title, subtitle, "shared", cloud_shared.root_path,
+                                   controller_path.include?("cloud_shared"))
+        end
+
+        # SECURITY & PRIVACY
+
+        # 08.01 Vault engine
+        def navigation_engine_vault(title: "Vault", subtitle: "")
+            return unless defined? LesliVault
+
+            navigation_engine_item(title, subtitle, "vault", lesli_vault.root_path,
+                                    controller_path.include?("lesli_vault"))
+        end
+
+        # 08.03 Audit engine
+        def navigation_engine_audit(title: "Audit", subtitle: "Activity, logs, security and more")
+            return unless defined? CloudAudit
+
+            navigation_engine_item(title, subtitle, "audit", cloud_audit.root_path,
+                                   controller_path.include?("cloud_audit"))
+        end
+
+        # INTEGRATIONS
+
+        # 09.01 Babel engine
+        def navigation_engine_babel(title: "Babel", subtitle: "Translations")
+            return unless defined? LesliBabel
+
+            navigation_engine_item(title, subtitle, "babel", lesli_babel.root_path,
+                                   controller_path.include?("lesli_babel"))
+        end
+
+        # 09.02 Dispatcher engine
+        def navigation_engine_dispatcher(title: "Dispatcher", subtitle: "cloud_dispatcher/dispatcher-logo.svg")
+            return unless defined? CloudDispatcher
+
+            navigation_engine_item(title, subtitle, "api", cloud_dispatcher.root_path,
+                                   controller_path.include?("cloud_dispatcher"))
+        end
+
+        # 09.03 Federation engine
+        def navigation_engine_federation(title: "Federation", subtitle: "cloud_federation/federation-logo.svg")
+            return unless defined? CloudFederation
+
+            navigation_engine_item(title, subtitle, "federation", cloud_federation.root_path,
+                                   controller_path.include?("cloud_federation"))
+        end
+
+        # 09.04 One engine
+        def navigation_engine_one(title: "One", subtitle: "Cloud Enterprise Resource Management")
+            return unless defined? CloudOne
+
+            navigation_engine_item(title, subtitle, "one", cloud_one.root_path,
+                                   controller_path.include?("cloud_one"))
+        end
+
+        # 09.06 Development engine
+        def navigation_engine_development(title: "Dev", subtitle: "Development notes")
+            return unless defined? CloudDevelopment
+
+            navigation_engine_item(title, subtitle, "development", cloud_development.root_path,
+                                   controller_path.include?("cloud_development"))
+        end
+
+        private
+
+        # build a html link for an engine path
+        def navigation_engine_item(title, subtitle, icon, path, is_active)
+            # get hidden modules if there are modules to hide
+            modules_hidden = [] # Rails.application.config.lesli.dig(:modules_hidden) || []
+
+            # stop rendering module navigation if need to hide the module
+            return nil if modules_hidden.include?(path)
+
+            # render module navigation item :)
+            content_tag(:a, href: path, class: is_active ? "is-active" : nil) do
+                lesli_svg("cloud-#{icon}") << content_tag(:div) do
+                    content_tag(:span, title) << content_tag(:p, subtitle)
+                end
+            end
+        end
+    end
+end

data/app/helpers/lesli/profiles_helper.rb

@@ -0,0 +1,4 @@
+module Lesli
+  module ProfilesHelper
+  end
+end

data/app/helpers/lesli/system_helper.rb

@@ -0,0 +1,57 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.dev
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// ·
+=end
+
+module Lesli
+    module SystemHelper
+        # return the engine code of the controller that is handling the http request
+        def lesli_controller
+            controller_path.split("/")[0]
+        end
+
+        # retun the code of the instance builder engine
+        # example: lesli_cloud, deutsche_leibrenten, mitwerken_cloud
+        def lesli_instance_code
+            return "lesli"
+            Lesli::System.instance[:code]
+        end
+
+        # return the information about the current engine
+        def lesli_engine(property = nil)
+            Lesli::System.engine(lesli_controller.camelize, property)
+        end
+
+        # return true if the controller requested belongs to the administration area
+        def is_lesli_onboarding?
+            lesli_controller == "onboardings"
+        end
+    end
+end

data/app/lib/date2.rb

@@ -0,0 +1,192 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+class Date2
+
+    def initialize(datetime = Time.current, format = "%Y-%m-%d %H:%M:%S")
+
+        # NOTE: user should be able to change this through settings table
+        # get initial datetime configuration
+        config = Lesli.config.datetime
+
+
+        # NOTE: Do not modify settings here,
+        # if you need a different date format you should change it in the config file
+        # Check the docs for more information: /development/docs/rails-lib-time
+
+        # configuration example
+        # @settings = {
+        #     :time_zone => config[:time_zone],
+        #     :start_week_on => config[:start_week_on],
+        #     :format => {
+        #         :date => "%d.%m.%Y",
+        #         :time => "%H:%M %p", # 12 hours datetime format
+        #         :time => "%H:%M",    # 24 hours datetime format (default)
+        #         :date_time => "%d.%m.%Y %I:%M %p", # 12 hours datetime format
+        #         :date_time => "%d.%m.%Y %H:%M",    # 24 hours datetime format (default)
+        #         :date_words => "%A, %B %d, %Y",
+        #         :date_time_words => "%A, %B %d, %Y, %I:%M %p", # 12 hours datetime in words format
+        #         :date_time_words => "%A, %B %d, %Y, %H:%M"    # 24 hours datetime in words format (default)
+        #     }
+        # }
+
+        @settings = {
+            :time_zone => config[:time_zone],
+            :start_week_on => config[:start_week_on],
+            :format => {
+                :date => "%d.%m.%Y",
+                :time => "%H:%M",
+                :date_time => config[:formats][:date_time],
+                :date_words => "%A, %B %d, %Y",
+                :date_time_words => "%A, %B %d, %Y, %I:%M %p", # 12 hours datetime in words format
+                :date_time_words => "%A, %B %d, %Y, %H:%M"    # 24 hours datetime in words format (default)
+            }
+        }
+
+
+        # default date format
+        @format = set_format(:date)
+
+
+        # get a valid timezone
+        @zone = ActiveSupport::TimeZone.new(@settings[:time_zone])
+
+
+        # get datetime object from user params
+        @datetime = parse_initial_datetime(datetime, format).in_time_zone(@zone)
+
+    end
+
+    # set date format and return Date2 instance
+    def date
+        set_format(:date)
+        self
+    end
+
+    # set time format and return Date2 instance
+    def time
+        set_format(:time)
+        self
+    end
+
+    # set date_time format and return Date2 instance
+    def date_time
+        set_format(:date_time)
+        self
+    end
+
+    # set date_words format and return Date2 instance
+    def date_words
+        set_format(:date_words)
+        self
+    end
+
+    # set date_time_words format and return Date2 instance
+    def date_time_words
+        set_format(:date_time_words)
+        self
+    end
+
+    # return query string to get timestamps columns from database
+    def db_timestamps table=""
+
+        # avoid ambiguous columns
+        table = table.concat(".") if table != ""
+
+        # get right format for dates
+        format = self.db_format
+
+        "TO_CHAR(#{table}created_at at time zone 'utc' at time zone '#{@settings[:time_zone]}', '#{format}') as created_at_date, TO_CHAR(#{table}updated_at at time zone 'utc' at time zone '#{@settings[:time_zone]}', '#{format}') as updated_at_date"
+
+    end
+
+    # return query string to get a datetime column from database
+    def db_column column, table=""
+
+        # avoid ambiguous columns
+        table = table.concat(".") if table != ""
+
+        # get right format for dates
+        format = self.db_format
+
+        "TO_CHAR(#{table}#{column} at time zone 'utc' at time zone '#{@settings[:time_zone]}', '#{format}') as #{column}_string"
+
+    end
+
+    # convert a datetime object to string representation using defined format
+    def to_s
+        @datetime.strftime(@format)
+    end
+
+    def get
+        @datetime
+    end
+
+    private
+
+
+    # get datetime object or string datetime and return a datetime object
+    def parse_initial_datetime datetime, format
+
+        return datetime if datetime.is_a?(Time)
+
+        if datetime.is_a?(::String) and datetime.size == 25 and datetime[10] == "T"
+            return ::DateTime.iso8601(datetime)
+        end
+
+        return ::DateTime.strptime(datetime, format)
+    end
+
+
+    def set_format format
+        @format = @settings[:format][format || :date]
+    end
+
+
+    def db_format
+        format = @format
+
+        # Convert Ruby to postgresql date format
+        format = format.gsub("%Y", "YYYY")
+        format = format.gsub("%m", "MM")
+        format = format.gsub("%d", "DD")
+
+        # Convert Ruby to postgresql time format
+        format = format.gsub("%H", "HH24") # 24 hours format
+        format = format.gsub("%I", "HH12") # 12 hours format
+        format = format.gsub("%p", "AM") # Meridian indicator (AM/PM)
+        format = format.gsub("%M", "MI")
+
+        format
+    end
+
+end

data/app/lib/lesli/system.rb

@@ -0,0 +1,80 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Your Smart Business Assistant.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// ·
+
+=end
+
+module Lesli
+    class System
+        ENGINES = {}
+
+        # engine("LesliAdmin")
+        # engine("LesliAdmin", "name")
+        def self.engine(engine, property=nil)
+
+            engines() if ENGINES.empty?
+
+            # return specific property if requested
+            return ENGINES[engine][property] unless property.blank?
+
+            # return the engine info
+            return ENGINES[engine]
+        end
+
+        def self.engines 
+
+            return ENGINES unless ENGINES.empty?
+
+            # due we do not know the engine mounted path we have to look up for it every
+            # time we load the html view so we can use the dynamic route from the main rails app
+            # we use this in the url plugin 
+            ["Lesli", "LesliAdmin", "LesliBabel"].each do |engine|
+                next unless Object.const_defined?(engine)
+                ENGINES[engine]= {
+                    :code => engine.underscore, 
+                    :name => lesli_engine_name(engine), 
+                    :path => "#{engine}::Engine".constantize.routes.find_script_name({}),
+                    :dir => Gem::Specification.find_by_name(engine.underscore).gem_dir
+                }
+            end 
+
+            ENGINES
+        end
+
+        private 
+
+        # Prints the name of the engine
+        def self.lesli_engine_name engine
+            name = engine.camelcase
+            return "Lesli" if name == "Lesli"
+            name.sub("Lesli", "")
+        end
+    end
+end