decidim-voca 0.0.6

data/lib/decidim/voca/backup/app_backup.rb

@@ -0,0 +1,169 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Voca
+    class AppBackup
+      def initialize
+        logger.info "⚙️ starts backup (##{now})"
+      end
+
+      ##
+      # Run a backup of :
+      #   public/uploads
+      #   current database
+      # And store it in a .tar.gz file.
+      # @return [String] the absolute path of the backuped file
+      def run!
+        Dir.mktmpdir do |dir|
+          logger.debug "Prepare backup in tmp dir '#{dir}'"
+          dump_database(dir)
+          compress_source_path(uploads_path, dir)
+          compress_source_path(logs_path, dir)
+          generate_metadatas(dir)
+          with_backup_dir do |backup_dir|
+            backup_file = "#{backup_dir}/#{now}-backup.tar.gz"
+            compress_tar!("#{dir}/", backup_file)
+            backup_file
+          end
+        end
+      end
+
+      private
+        ##
+        # Generates a metadata.json file that will be included in the
+        # given dir. Give information about date, instance identification,
+        # timezone and decidim version.
+        # @returns [String] the filename of the generate file
+        def generate_metadatas(dir)
+          filename = "#{dir}/metadatas.json"
+          metadatas = {
+            date: now,
+            decidim_version: ENV.fetch("DECIDIM_VERSION", nil),
+            instance_uuid: ENV.fetch("INSTANCE_UUID", nil),
+            timezone: ENV.fetch("TZ", nil),
+          }
+          File.open(filename, "w") do |f|
+            f.write(JSON.pretty_generate(metadatas))
+          end
+          filename
+        end
+
+        ##
+        # Compress a directory in a tar.gz file.
+        def compress_source_path(source_path, destination_dir)
+          logger.debug "Running compress_dir for #{source_path}"
+          source_path_name = File.basename(source_path)
+          compressed_file = "#{destination_dir}/#{source_path_name}-#{now}.tar.gz"
+          compress_tar!("#{source_path}/", "#{compressed_file}")
+          logger.info "⚙️ backup #{source_path_name}: #{compressed_file}"
+          compressed_file
+        rescue Exception => e
+          logger.error e.message
+          raise e
+        end
+
+        ##
+        # Dump the posgres database.
+        def dump_database(destination_dir)
+          with_pg_pass do
+            logger.debug "Running dump_database"
+            db_host = ENV.fetch("DATABASE_HOST")
+            db_user = ENV.fetch("DATABASE_USERNAME")
+            db_pass = ENV.fetch("DATABASE_PASSWORD")
+            db_name = ENV.fetch("DATABASE_DATABASE")
+
+            dump_file = "#{destination_dir}/#{db_name}-#{now}.dump"
+            exec_command!("pg_dump -Fc \
+          -d #{db_name} -h #{db_host} -U #{db_user} -w \
+          -f #{dump_file}")
+
+            logger.info "⚙️ backup db: #{dump_file}"
+            dump_file
+          rescue Exception => e
+            logger.error e.message
+            raise e
+          end
+        end
+
+        ##
+        # Create if not exists a .pgpass file.
+        # Needed to be able to use pg_dump from this image.
+        def with_pg_pass(&block)
+          # Check /root/.pgpass exists if not create it
+          File.open("/root/.pgpass", "w") do |f|
+            db_host = ENV.fetch("DATABASE_HOST")
+            db_user = ENV.fetch("DATABASE_USERNAME")
+            db_pass = ENV.fetch("DATABASE_PASSWORD")
+            db_name = ENV.fetch("DATABASE_DATABASE")
+            f.write("#{db_host}:*:#{db_name}:#{db_user}:#{db_pass}")
+            f.chmod(0600)
+          end unless File.exists?("/root/.pgpass")
+          block.call()
+        end
+
+        ##
+        # exec a system command.
+        def exec_command!(command)
+          logger.debug "exec '#{command}'"
+          command_output = system(command)
+          if command_output == true
+            logger.debug "exec worked: #{command}"
+          else
+            raise "exec failed: #{command}"
+          end
+        rescue Exception => e
+          logger.error e.message
+          raise e
+        end
+
+        ##
+        # Ensure backup directory exists and then run the given block with
+        # backup directory path as argument.
+        def with_backup_dir(&block)
+          @backup_dir ||= "#{ENV.fetch('RAILS_ROOT')}/decidim-module-voca/backup_dir"
+          backup_dir = @backup_dir
+          Dir.mkdir(backup_dir) unless Dir.exists?(backup_dir)
+          if Dir.exists?(backup_dir)
+            block.call(backup_dir)
+          else
+            raise "Fails to create #{backup_dir}"
+          end
+        end
+
+        ##
+        # tar a source directory into a destination file.
+        # the compressed file will have the source directory content only
+        def compress_tar!(source, destination)
+          exec_command! "tar -czf #{destination} . -C #{source}"
+        rescue Exception => e
+          logger.error "can not tar file."
+          logger.error e.message
+          raise e
+        end
+
+        ##
+        # Define logger for the class.
+        def logger
+          @logger ||= Rails.logger
+        end
+
+        ##
+        # Time at the start of the backup task
+        def now
+          @now ||= Time.new.strftime("%Y-%m-%d_%H-%M-%S")
+        end
+
+        ##
+        # Directory where the user's uploads are.
+        def uploads_path
+          @uploads_path ||= "#{ENV.fetch('RAILS_ROOT')}/public/uploads"
+        end
+
+        ##
+        # Directory where the app's logs are.
+        def logs_path
+          @logs_path ||= "#{ENV.fetch('RAILS_ROOT')}/log"
+        end
+    end
+  end
+end

data/lib/decidim/voca/backup/app_decrypt_backup_file.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "openssl"
+
+module Decidim
+  module Voca
+    class AppDecryptBackupFile
+      attr_accessor :file_path
+
+      def initialize(file_enc)
+        logger.info "⚙️ starts decrypt file"
+        raise ArgumentError, "encrypted file cannot be nil" if file_enc.nil?
+        @file_enc = file_enc
+      end
+
+      def decrypt!
+        setup_decipher!
+        file_name = File.basename(@file_enc, ".enc")
+        @file_path = File.join(File.dirname(@file_enc), file_name)
+
+        File.open(@file_path, "w:BINARY") do |decrypted_file|
+          File.open(@file_enc, "r:BINARY") do |encrypted_file|
+            data = encrypted_file.read
+            decrypted_data = @decipher.update(data) + @decipher.final
+            decrypted_file.write(decrypted_data)
+          end
+        end
+        raise Error, "decrypted file not created" unless File.exists?(@file_path)
+      rescue Exception => e
+        logger.error e.message
+        raise e
+      end
+
+      def setup_decipher!
+        @decipher ||= OpenSSL::Cipher::AES.new(256, :CBC).decrypt
+        @decipher.key = Base64.decode64(ENV.fetch("BACKUP_CIPHER_KEY"))
+        @decipher.iv = Base64.decode64(ENV.fetch("BACKUP_CIPHER_IV"))
+      rescue Exception => e
+        logger.error e.message
+        raise e
+      end
+
+      ##
+      # Define logger for the class.
+      def logger
+        @logger ||= Rails.logger
+      end
+    end
+  end
+end

data/lib/decidim/voca/backup/app_encrypt_backup_file.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "openssl"
+
+module Decidim
+  module Voca
+    class AppEncryptBackupFile
+      attr_accessor :file_enc, :cipher, :file_path
+
+      def initialize(file_path)
+        logger.info "⚙️ starts encrypt file"
+        raise ArgumentError, "file cannot be nil" if file_path.nil?
+        @file_path = file_path
+      end
+
+      def encrypt!
+        setup_cipher!
+        @file_enc = @file_path + ".enc"
+        File.open(@file_enc, "w:BINARY") do |encrypted_file|
+          File.open(@file_path, "r:BINARY") do |file|
+            data = file.read
+            encrypted_data = @cipher.update(data) + @cipher.final
+            encrypted_file.write(encrypted_data)
+          end
+        end
+        raise Error, "encrypted file not created" unless File.exists?(@file_enc)
+      rescue Exception => e
+        logger.error e.message
+        raise e
+      end
+
+      private
+        def setup_cipher!
+          @cipher ||= OpenSSL::Cipher::AES.new(256, :CBC).encrypt
+          @cipher.key = Base64.decode64(ENV.fetch("BACKUP_CIPHER_KEY"))
+          @cipher.iv = Base64.decode64(ENV.fetch("BACKUP_CIPHER_IV"))
+        rescue Exception => e
+          logger.error e.message
+          raise e
+        end
+
+        ##
+        # Define logger for the class.
+        def logger
+          @logger ||= Rails.logger
+        end
+    end
+  end
+end

data/lib/decidim/voca/backup/app_upload_to_s3.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "aws-sdk-s3"
+
+module Decidim
+  module Voca
+    class Uploader
+      attr_accessor :filename, :folder
+
+      def initialize(filename, folder)
+        logger.info "⚙️ starts upload file to S3"
+        raise ArgumentError, "filename cannot be nil" if filename.nil?
+        @filename = filename
+        raise ArgumentError, "folder cannot be nil" if folder.nil?
+        @folder = folder
+      end
+
+      def upload!
+        instance_uuid = ENV.fetch("INSTANCE_UUID")
+        destination = File.join(
+          "#{instance_uuid}/",
+          "#{@folder}/",
+          File.basename(filename)
+        )
+        logger.info "Uploading file: #{@filename} for client: #{instance_uuid}"
+        bucket.object(destination).upload_file(filename)
+        logger.info "Backup file: #{@filename} upload success"
+      rescue Exception => e
+        logger.error e.message
+        raise e
+      end
+
+      private
+        def bucket
+          s3_endpoint ||= ENV.fetch("ENDPOINT") unless nil
+          s3 ||= Aws::S3::Resource.new(endpoint: "#{s3_endpoint}")
+          s3_bucket = s3.bucket("vocacity")
+          raise Error if s3_bucket.name.nil?
+          s3_bucket
+        end
+
+        ##
+        # Define logger for the class.
+        def logger
+          @logger ||= Rails.logger
+        end
+    end
+  end
+end

data/lib/decidim/voca/engine.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "rails"
+require "decidim/core"
+module Decidim
+  module Voca
+    # This is the engine that runs on the public interface of voca.
+    class Engine < ::Rails::Engine
+      isolate_namespace Decidim::Voca
+
+      routes do
+        # Add engine routes here
+        # resources :voca
+        # root to: "voca#index"
+      end
+
+      initializer "decidim_voca.middleware" do |app| 
+        app.config.middleware.insert_after(Warden::Manager, Decidim::Voca::DynamicConfigMiddleware, Redis.new(
+            url: ENV.fetch("REDIS_CONFIG_URL", "redis://127.0.0.1:6379/2"),
+        ), "config")
+      end
+
+      initializer "decidim_voca.gruf" do |app|
+        ::Gruf.configure do |c|
+          c.server_binding_url = ENV.fetch("GRPC_HOST", "0.0.0.0") + ":" + ENV.fetch("GRPC_PORT", "4445")
+          c.rpc_server_options = c.rpc_server_options.merge(pool_size: [ENV.fetch("RAILS_MAX_THREADS", 5).to_i - 1, 1].max)
+        end
+      end
+    end
+  end
+end

data/lib/decidim/voca/middleware/dynamic_config_middleware.rb

@@ -0,0 +1,42 @@
+module Decidim
+  module Voca
+    class DynamicConfigMiddleware
+      # Initializes the middleware with a Redis client and a Redis key name
+      #
+      # @param app [Object] Rack application to call
+      # @param redis_client [Redis] Redis client instance
+      # @param redis_key [String] Redis key name to retrieve configuration data from
+      def initialize(app, redis_client, redis_key)
+        @app = app
+        @redis_client = redis_client
+        @redis_key = redis_key
+      end
+
+      # Calls the Rack application and sets configuration data from Redis key
+      #
+      # @param env [Hash] Rack environment variables
+      # @return [Array] Rack response array
+      def call(env)
+        configure_decidim_with_redis_data
+        # Call Rack application
+        @app.call(env)
+      end
+
+      private
+
+      def configure_decidim_with_redis_data
+        config_data = @redis_client.hgetall(@redis_key)
+        return unless config_data.present?
+      
+        # Set configuration attributes using config_data
+        if config_data["currency_unit"].present?
+          Decidim.currency_unit = config_data["currency_unit"]
+        end
+        if config_data["timezone"].present?
+          ENV["TZ"] = config_data["timezone"] || ENV.fetch("TZ", "UTC")
+          Rails.application.config.time_zone = ActiveSupport::TimeZone[ENV["TZ"]] 
+        end
+      end
+    end
+  end
+end

data/lib/decidim/voca/rpc/decidim_pb.rb

@@ -0,0 +1,134 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: decidim.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/timestamp_pb'
+require 'google/protobuf/empty_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("decidim.proto", :syntax => :proto3) do
+    add_message "voca_decidim.GetSettingsResponse" do
+      optional :id, :uint64, 1
+      proto3_optional :permission_settings, :message, 2, "voca_decidim.DecidimOrganizationPermissionSettings"
+      proto3_optional :naming_settings, :message, 3, "voca_decidim.DecidimOrganizationNamingSettings"
+      proto3_optional :locale_settings, :message, 4, "voca_decidim.DecidimOrganizationLocaleSettings"
+      proto3_optional :smtp_settings, :message, 5, "voca_decidim.DecidimOrganizationSMTPSettings"
+      proto3_optional :color_settings, :message, 6, "voca_decidim.DecidimOrganizationColorSettings"
+      proto3_optional :file_upload_settings, :message, 7, "voca_decidim.DecidimOrganizationFileUploadSettings"
+      proto3_optional :feature_settings, :message, 8, "voca_decidim.DecidimOrganizationFeatureFlagSettings"
+      optional :created_at, :message, 9, "google.protobuf.Timestamp"
+    end
+    add_message "voca_decidim.SetSettingsRequest" do
+      proto3_optional :permission_settings, :message, 1, "voca_decidim.DecidimOrganizationPermissionSettings"
+      proto3_optional :naming_settings, :message, 2, "voca_decidim.DecidimOrganizationNamingSettings"
+      proto3_optional :locale_settings, :message, 3, "voca_decidim.DecidimOrganizationLocaleSettings"
+      proto3_optional :smtp_settings, :message, 4, "voca_decidim.DecidimOrganizationSMTPSettings"
+      proto3_optional :color_settings, :message, 5, "voca_decidim.DecidimOrganizationColorSettings"
+      proto3_optional :file_upload_settings, :message, 6, "voca_decidim.DecidimOrganizationFileUploadSettings"
+      proto3_optional :feature_settings, :message, 7, "voca_decidim.DecidimOrganizationFeatureFlagSettings"
+    end
+    add_message "voca_decidim.DecidimOrganizationPermissionSettings" do
+      proto3_optional :force_users_to_authenticate_before_access_organization, :bool, 1
+      optional :users_registration_mode, :enum, 2, "voca_decidim.SETTINGS_REGISTER_MODE_OPTION"
+    end
+    add_message "voca_decidim.DecidimOrganizationNamingSettings" do
+      optional :host, :string, 1
+      repeated :secondary_hosts, :string, 2
+      optional :name, :string, 3
+      optional :reference_prefix, :string, 4
+    end
+    add_message "voca_decidim.DecidimOrganizationLocaleSettings" do
+      optional :default_locale, :string, 1
+      repeated :available_locales, :string, 2
+      optional :currency_unit, :string, 3
+      optional :timezone, :string, 4
+    end
+    add_message "voca_decidim.DecidimOrganizationSMTPSettings" do
+      optional :from_label, :string, 1
+      optional :from_email, :string, 2
+      optional :address, :string, 3
+      optional :port, :string, 4
+      optional :authentication, :enum, 5, "voca_decidim.SETTINGS_SMTP_AUTHENTICATION_OPTION"
+      optional :username, :string, 6
+      optional :password, :string, 7
+      optional :domain, :string, 8
+      optional :enable_starttls_auto, :bool, 9
+      optional :openssl_verify_mode, :enum, 10, "voca_decidim.SETTINGS_SMTP_OPENSSL_OPTION"
+    end
+    add_message "voca_decidim.DecidimOrganizationColorSettings" do
+      optional :alert, :string, 1
+      optional :primary, :string, 2
+      optional :success, :string, 3
+      optional :warning, :string, 4
+      optional :highlight, :string, 5
+      optional :secondary, :string, 6
+      optional :highlight_alternative, :string, 7
+    end
+    add_message "voca_decidim.DecidimOrganizationFileUploadSettings" do
+      optional :maximum_file_size_avatar, :float, 1
+      optional :maximum_file_size_default, :float, 2
+      repeated :allowed_content_types_admin, :string, 3
+      repeated :allowed_content_types_default, :string, 4
+      repeated :allowed_file_extensions_admin, :string, 5
+      repeated :allowed_file_extensions_default, :string, 6
+    end
+    add_message "voca_decidim.DecidimOrganizationFeatureFlagSettings" do
+      repeated :available_authorizations, :string, 1
+      optional :badges_enabled, :bool, 2
+      optional :user_groups_enabled, :bool, 3
+      optional :enable_machine_translations, :bool, 4
+      optional :machine_translation_display_priority, :enum, 5, "voca_decidim.SETTINGS_MACHINE_TRANSLATION_PRIORITY_OPTION"
+    end
+    add_message "voca_decidim.SeedAdminRequest" do
+      optional :admin_email, :string, 1
+      optional :system_email, :string, 2
+      optional :system_password, :string, 3
+    end
+    add_message "voca_decidim.SeedAdminResponse" do
+      optional :admin_email, :string, 1
+      optional :admin_password, :string, 2
+    end
+    add_message "voca_decidim.PingResponse" do
+      optional :message, :string, 1
+    end
+    add_enum "voca_decidim.SETTINGS_REGISTER_MODE_OPTION" do
+      value :SETTINGS_REGISTER_MODE_REGISTER_AND_LOGIN, 0
+      value :SETTINGS_REGISTER_MODE_LOGIN, 1
+      value :SETTINGS_REGISTER_MODE_EXTERNAL, 2
+    end
+    add_enum "voca_decidim.SETTINGS_SMTP_AUTHENTICATION_OPTION" do
+      value :SETTINGS_SMTP_AUTHENTICATION_PLAIN, 0
+      value :SETTINGS_SMTP_AUTHENTICATION_LOGIN, 1
+      value :SETTINGS_SMTP_AUTHENTICATION_CRAM_MD5, 2
+      value :SETTINGS_SMTP_AUTHENTICATION_NONE, 3
+    end
+    add_enum "voca_decidim.SETTINGS_SMTP_OPENSSL_OPTION" do
+      value :SETTINGS_SMTP_OPENSSL_NONE, 0
+      value :SETTINGS_SMTP_OPENSSL_PEER, 1
+    end
+    add_enum "voca_decidim.SETTINGS_MACHINE_TRANSLATION_PRIORITY_OPTION" do
+      value :SETTINGS_MACHINE_TRANSLATION_PRIORITY_ORIGINAL, 0
+      value :SETTINGS_MACHINE_TRANSLATION_PRIORITY_TRANSLATED, 1
+    end
+  end
+end
+
+module VocaDecidim
+  GetSettingsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.GetSettingsResponse").msgclass
+  SetSettingsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SetSettingsRequest").msgclass
+  DecidimOrganizationPermissionSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationPermissionSettings").msgclass
+  DecidimOrganizationNamingSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationNamingSettings").msgclass
+  DecidimOrganizationLocaleSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationLocaleSettings").msgclass
+  DecidimOrganizationSMTPSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationSMTPSettings").msgclass
+  DecidimOrganizationColorSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationColorSettings").msgclass
+  DecidimOrganizationFileUploadSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationFileUploadSettings").msgclass
+  DecidimOrganizationFeatureFlagSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.DecidimOrganizationFeatureFlagSettings").msgclass
+  SeedAdminRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SeedAdminRequest").msgclass
+  SeedAdminResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SeedAdminResponse").msgclass
+  PingResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.PingResponse").msgclass
+  SETTINGS_REGISTER_MODE_OPTION = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SETTINGS_REGISTER_MODE_OPTION").enummodule
+  SETTINGS_SMTP_AUTHENTICATION_OPTION = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SETTINGS_SMTP_AUTHENTICATION_OPTION").enummodule
+  SETTINGS_SMTP_OPENSSL_OPTION = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SETTINGS_SMTP_OPENSSL_OPTION").enummodule
+  SETTINGS_MACHINE_TRANSLATION_PRIORITY_OPTION = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("voca_decidim.SETTINGS_MACHINE_TRANSLATION_PRIORITY_OPTION").enummodule
+end

data/lib/decidim/voca/rpc/decidim_services_pb.rb

@@ -0,0 +1,30 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: decidim.proto for package 'voca_decidim'
+
+require 'grpc'
+require_relative './decidim_pb'
+
+module VocaDecidim
+  module Decidim
+    class Service
+
+      include ::GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'voca_decidim.Decidim'
+
+      # region/Health
+      rpc :Ping, ::Google::Protobuf::Empty, ::VocaDecidim::PingResponse
+      # region/Settings
+      rpc :GetSettings, ::Google::Protobuf::Empty, ::VocaDecidim::GetSettingsResponse
+      rpc :SetSettings, ::VocaDecidim::SetSettingsRequest, ::Google::Protobuf::Empty
+      # region/Seed
+      rpc :CompileAssets, ::Google::Protobuf::Empty, ::Google::Protobuf::Empty
+      rpc :SetupDb, ::Google::Protobuf::Empty, ::Google::Protobuf::Empty
+      rpc :SeedAdmin, ::VocaDecidim::SeedAdminRequest, ::VocaDecidim::SeedAdminResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/decidim/voca/test/factories.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "decidim/core/test/factories"
+
+FactoryBot.define do
+
+
+  # Add engine factories here
+end

data/lib/decidim/voca/updater.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Decidim
+  module Voca
+    class Updater
+      class << self
+        def update!(options)
+          ActiveSupport::Deprecation.warn('deprecated.')
+
+          updater = self.new(options.deep_symbolize_keys)
+        end
+      end
+
+      attr_reader :options
+      def initialize(options)
+        @options = options
+        validate_options!
+        update!
+      end
+
+    private
+      def validate_options!
+        allowed_attributes = [
+          :org_name,
+          :org_prefix,
+          :host,
+          :default_locale,
+          :available_locales
+        ]
+        options.each do |k, v|
+          raise Decidim::Voca::Error.new("invalid option #{k}") unless allowed_attributes.include?(k)
+        end
+      end
+
+      def update!
+        Decidim::Organization.first!.update!(transformed_options)
+      end
+
+      def transformed_options
+        transform = {}
+        transform[:host] = options[:host] if options[:host].present?
+        transform[:name] = options[:org_name] if options[:org_name].present?
+        transform[:default_locale] = options[:default_locale] if options[:default_locale].present?
+        transform[:available_locales] = options[:available_locales].split(",").map(&:strip).map(&:to_sym) if options[:available_locales].present?
+        transform[:reference_prefix] = options[:org_prefix] if options[:org_prefix].present?
+        transform
+      end
+    end
+  end
+end

data/lib/decidim/voca/version.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# This holds the decidim-meetings version.
+module Decidim
+  module Voca
+    def self.version
+      "0.0.6"
+    end
+    def self.decidim_version
+      ">= 0.26"
+    end
+  end
+end

data/lib/decidim/voca.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "gruf"
+require_relative "voca/admin"
+require_relative "voca/engine"
+require_relative "voca/admin_engine"
+require_relative "voca/version"
+
+require_relative "voca/backup/app_backup"
+require_relative "voca/backup/app_upload_to_s3"
+require_relative "voca/backup/app_encrypt_backup_file"
+require_relative "voca/backup/app_decrypt_backup_file"
+require_relative "voca/updater"
+require_relative "voca/rpc/decidim_services_pb"
+require_relative "voca/middleware/dynamic_config_middleware"
+
+require "active_support/core_ext"
+module Decidim
+  module Voca
+    class Error < StandardError; end
+  end
+end