thecore_ui_commons 3.3.4 → 3.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b139db37d97713ea9f025376e438e9bca180afc0be792219089cdf53e94a9a16
-  data.tar.gz: 37e112968a59444921342aac4b3a20dc895319097fc690d967f28c0baf9dfe49
+  metadata.gz: 7d1091f859ef05f14096826e8d5cd82712958819de284543dfc26120e90c0dc4
+  data.tar.gz: aea72ad38d7f5ac1f53af37faef3fc7f3f5b8d7f0000f918bb568093950433f8
 SHA512:
-  metadata.gz: a1eab6f1db0ddcd41569c1044088e3a70755b9156746273eb552d98c25d19edb0990fbe9c2d7196287f2aa4a89d04c2662dcc7c61ad82e1fbf6a2710ed7f5e67
-  data.tar.gz: 3ca02b2607961e1cb9e1ecfca1f0399593ec01d947a13f4d9fd750902c07dec1525d72bcdbf26734f549fa03b242263e3ccfc3f9ef24721d687a28c40744ddc3
+  metadata.gz: 2a7096802f754f1f38d48adaf8491798e61f1cf725d850e53f5f7d40e209ecab3470371e04dc2d4bad5716fa5dcf27f1accfd0cab7c03693d30d54e8e244c9da
+  data.tar.gz: acc0f1101c996dab5ccce5673f0e415265fa3e49437c6f7cecba832d96909756e5927ecd2bc39bf3e7b62b00e7e42ed3966881625955974c989ee0b5b08b5b4d

data/README.md

@@ -1 +1,27 @@
-This is part of Thecore framework: https://github.com/gabrieletassoni/thecore/tree/release/3
+# thecore_ui_commons
+
+A Rails engine providing shared UI artifacts for [Thecore](https://github.com/gabrieletassoni/thecore/tree/release/3)-based host applications.
+
+## What it provides
+
+- **Layouts** — Devise session page, Swagger UI, mailer (HTML + text)
+- **Partials** — Bootstrap flash alerts, Kaminari pagination, drag-drop file uploader, logos
+- **ECharts helpers** — Ruby classes for building Apache ECharts config server-side (`Vector`, `MultipleVectors`, `Binary`, `BinarySeries`, `Speedometer`, `Map`)
+- **Swagger versioning** — `/info/swagger/:version` with automatic version discovery from mounted routes
+- **Assets** — shared CSS/JS manifests, Active Job monitor, Devise i18n injection
+
+## Installation
+
+Add to your host app's `Gemfile`:
+
+```ruby
+gem 'thecore_ui_commons', '~> 3.0'
+```
+
+The engine mounts automatically. No configuration required.
+
+## Swagger UI
+
+The Swagger UI is available at `/info/swagger` (redirects to `/info/swagger/v2`).
+
+If your app mounts `model_driven_api`, the engine discovers all available API versions at startup by scanning `Rails.application.routes` for paths matching `api/vN/info/swagger`. A version nav banner appears automatically above the Swagger UI — no configuration needed.

data/app/controllers/info_controller.rb

@@ -1,8 +1,10 @@
 class InfoController < ApplicationController
-    # This is a model-less controller just to render che swagger page using a custom layout
     layout 'swagger'
     def swagger
+        @version = params[:version].to_s.gsub(/[^a-zA-Z0-9]/, '')
+        @versions = ThecoreUiCommons.swagger_api_versions
         uri = URI(request.url)
-        @swagger_json_url = "#{uri.scheme}://#{uri.host}#{":#{uri.port}" if uri.port.present?}#{ENV.fetch("RAILS_RELATIVE_URL_ROOT", "")}/api/v2/info/swagger.json"
+        @base_url = "#{uri.scheme}://#{uri.host}#{":#{uri.port}" if uri.port.present?}#{ENV.fetch("RAILS_RELATIVE_URL_ROOT", "")}"
+        @swagger_json_url = "#{@base_url}/api/#{@version}/info/swagger.json"
     end
-end
+end

data/app/views/info/swagger.html.erb

@@ -1,28 +1,55 @@
-<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.19.5/swagger-ui-bundle.js"> </script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.19.5/swagger-ui-standalone-preset.js"> </script>
-    <script>
-        function get(yourUrl){
-            var Httpreq = new XMLHttpRequest(); // a new request
-            Httpreq.open("GET",yourUrl,false);
-            Httpreq.send(null);
-            var json_obj = JSON.parse(Httpreq.responseText);
-            return json_obj;          
-        }
-        window.onload = function() {
-            const ui = SwaggerUIBundle({
-            spec: get('<%= @swagger_json_url %>'),
-            dom_id: '#swagger-ui',
-            deepLinking: true,
-            presets: [
-                SwaggerUIBundle.presets.apis,
-                SwaggerUIStandalonePreset
-            ],
-            plugins: [
-                SwaggerUIBundle.plugins.DownloadUrl
-            ],
-            layout: "StandaloneLayout"
-            })
-        
-            window.ui = ui
-        }
-</script>
+<% if @versions.length > 1 %>
+  <% content_for :version_nav do %>
+    <style>
+      #version-nav {
+        display: flex;
+        align-items: center;
+        gap: 0.4rem;
+        padding: 0.55rem 1rem;
+        background: #f1f5f9;
+        border-bottom: 1px solid #e2e8f0;
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        font-size: 0.82rem;
+        color: #64748b;
+      }
+      #version-nav .vn-label { margin-right: 0.2rem; }
+      #version-nav a {
+        display: inline-block;
+        padding: 0.22rem 0.7rem;
+        border-radius: 999px;
+        text-decoration: none;
+        border: 1px solid #3b82f6;
+        color: #3b82f6;
+        font-weight: 500;
+        transition: background 0.15s, color 0.15s;
+      }
+      #version-nav a:hover { background: #3b82f6; color: #fff; }
+      #version-nav a.current { background: #3b82f6; color: #fff; pointer-events: none; }
+    </style>
+    <div id="version-nav">
+      <span class="vn-label">API version:</span>
+      <% @versions.each do |v| %>
+        <% if v == @version %>
+          <a href="#" class="current"><%= v %></a>
+        <% else %>
+          <a href="<%= request.path.sub(/[^\/]+$/, v) %>"><%= v %></a>
+        <% end %>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.19.5/swagger-ui-bundle.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.19.5/swagger-ui-standalone-preset.js"></script>
+<script>
+  window.addEventListener('load', function () {
+    SwaggerUIBundle({
+      url: '<%= j @swagger_json_url %>',
+      dom_id: '#swagger-ui',
+      deepLinking: true,
+      presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
+      plugins: [SwaggerUIBundle.plugins.DownloadUrl],
+      layout: 'StandaloneLayout'
+    });
+  });
+</script>

data/app/views/layouts/swagger.html.erb

@@ -2,14 +2,10 @@
   <head>
     <meta charset="UTF-8">
     <link rel="stylesheet" type="text/css" href="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.19.5/swagger-ui.css" >
-    <style>
-    .swagger-ui .topbar {
-      display: none;
-    }
-    </style>
   </head>
 
   <body>
+    <%= yield :version_nav %>
     <div id="swagger-ui"></div>
     <%=yield%>
   </body>

data/config/locales/en.ra_settings.yml

@@ -1,4 +1,6 @@
 en:
-    activerecord:
-        models:
-            thecore_settings/setting: Configurations
+  settings: Settings
+  master_data: Registries
+  activerecord:
+    models:
+      thecore_settings/setting: Configurations

data/config/locales/it.yml

@@ -4,45 +4,45 @@ it:
       charts:
         menu: Analisi
         title: Grafici
-        breadcrumb: Grafici  
+        breadcrumb: Grafici
     links:
       label: Collegamenti
     settings:
       label: Impostazioni
       advanced: Avanzate
       registries: Anagrafiche
-      operations: Operatività      
+      operations: Operatività
     tools:
       label: "Strumenti"
-  advanced: Impostazioni        
-  contact: "Aiutaci a Migliorare"        
-  current_user: Utente corrente        
-  dashboard: "Pagina Iniziale"     
+  advanced: Impostazioni
+  contact: "Aiutaci a Migliorare"
+  current_user: Utente corrente
+  dashboard: "Pagina Iniziale"
   devise:
     omniauth:
       labels:
-        entra_id: 
+        entra_id:
           html: Sign in con Microsoft <i class="fa fa-microsoft"></i>
-        google_oauth2: 
+        google_oauth2:
           html: Sign in con Google <i class="fa fa-google"></i>
     sessions:
       new:
         login: Login
-        password: Password     
-  dont_leve_or_drag_here: Upload in corso, si prega di non lasciare la pagina o trascinare qui altri file. 
+        password: Password
+  dont_leve_or_drag_here: Upload in corso, si prega di non lasciare la pagina o trascinare qui altri file.
   errors:
     messages:
-      invalid: contiene caratteri invalidi   
-  file_upload: Descrizione della procedura, prego aggiungere una traduzione per file_upload al tuo file delle traduzioni.
-  file_upload_subtitle: Descrizione aggiuntiva, prego aggiungere una traduzione per file_upload_subtitle al tuo file delle traduzioni.
-  hello: "Ciao Mondo"  
+      invalid: contiene caratteri non validi
+  file_upload: Descrizione della procedura, prego aggiungere una traduzione per file_upload al file delle traduzioni.
+  file_upload_subtitle: Descrizione aggiuntiva, prego aggiungere una traduzione per file_upload_subtitle al file delle traduzioni.
+  hello: "Ciao Mondo"
   import_success: Importazione completata con successo
   loading: Caricamento
-  main_records: Anagrafiche  
-  manage: "Gestione"  
-  please_drag_and_drop_here: Trascinare qui i file da importare  
+  main_records: Anagrafiche
+  manage: "Gestione"
+  please_drag_and_drop_here: Trascinare qui i file da importare
   run_import: Forza l'importazione
-  sign_out: "Uscita"
+  sign_out: "Esci"
   tiered_times:
     dd:
       zero: "0 Giorni"
@@ -59,4 +59,4 @@ it:
     ss:
       zero: "0 Secondi"
       one: "%{count} Secondo"
-      other: "%{count} Secondi"
+      other: "%{count} Secondi"

data/config/routes.rb

@@ -3,7 +3,7 @@ Rails.application.routes.draw do
         controllers = {
             sessions: "users/sessions"
         }
-        controllers[:omniauth_callbacks] = 'users/omniauth_callbacks' if ThecoreAuthCommons.oauth_vars?
+        controllers[:omniauth_callbacks] = 'users/omniauth_callbacks' if ThecoreAuthCommons.respond_to?(:oauth_vars?) && ThecoreAuthCommons.oauth_vars?
         devise_for :users, controllers: controllers
     end
     
@@ -14,6 +14,7 @@ Rails.application.routes.draw do
     end
 
     scope ENV.fetch("RAILS_RELATIVE_URL_ROOT", "/") do
-        get '/info/swagger', to: 'info#swagger'
+        get '/info/swagger', to: redirect { |_params, req| "#{req.path}/v2" }
+        get '/info/swagger/:version', to: 'info#swagger'
     end
 end

data/lib/thecore_ui_commons/version.rb

@@ -1,3 +1,3 @@
 module ThecoreUiCommons
-  VERSION = "3.3.4".freeze
+  VERSION = "3.3.6".freeze
 end

data/lib/thecore_ui_commons.rb

@@ -16,6 +16,25 @@ require "omniauth/rails_csrf_protection"
 require "thecore_ui_commons/engine"
 
 module ThecoreUiCommons
+	@swagger_api_versions = nil
+
+	class << self
+		attr_writer :swagger_api_versions
+
+		def swagger_api_versions
+			@swagger_api_versions.nil? ? scan_swagger_routes(Rails.application.routes.routes) : @swagger_api_versions
+		end
+	end
+
+	def self.scan_swagger_routes(routes)
+		routes
+			.map { |r| r.path.spec.to_s }
+			.grep(/\/api\/(v\d+)\/info\/swagger/)
+			.map { |p| p.match(/\/api\/(v\d+)\/info\/swagger/)[1] }
+			.uniq
+			.sort_by { |v| v[1..].to_i }
+	end
+
 	def self.save_files files
 		files.each do |pic|
 			upload_dir = Rails.root.join(Settings.ns(:importer).import_from_folder, 'uploads')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thecore_ui_commons
 version: !ruby/object:Gem::Version
-  version: 3.3.4
+  version: 3.3.6
 platform: ruby
 authors:
 - Gabriele Tassoni