Nota de Resolução: Configuração de Ambiente Ruby 3.4.4 e Correção de Serialização

Objetivo

Configurar o ambiente de desenvolvimento do Chatwoot para a versão de Ruby exigida e resolver impedimentos de inicialização do banco de dados e servidor.

Contexto

O projeto Chatwoot exige Ruby 3.4.4 e Rails 7.1. Versões anteriores do Ruby ou ferramentas ausentes (Overmind) impossibilitavam a execução de lints e do servidor. Além disso, uma incompatibilidade no modelo InstallationConfig causava erros de tipo durante o parse de YAML no Ruby 3.4.

Passos Realizados

Instalação de Ferramentas:
- brew install ruby-install chruby overmind
- ruby-install ruby 3.4.4
Configuração de Shell:
- Adicionado source /opt/homebrew/opt/chruby/share/chruby/chruby.sh e source /opt/homebrew/opt/chruby/share/chruby/auto.sh ao ~/.zshrc e ~/.bash_profile.
Dependências:
- gem install bundler:2.5.11
- bundle install
Correção de Código:
- Alterado InstallationConfig.rb para lidar com a coluna serialized_value (JSONB) de forma resiliente, permitindo parse de YAML legado caso necessário, mas evitando falhas de tipo no Rails 7.1.

Principais Arquivos Alterados

InstallationConfig.rb: Ajuste nos métodos value e remoção da macro serialize redundante.
~/.zshrc / ~/.bash_profile: Atualização de paths e scripts de ambiente.

Como Validar

Execute source ~/.zshrc.
Rode bundle exec rails db:chatwoot_prepare.
Inicie o stack com make run.

Como Reverter

Remover os source do ~/.zshrc.
Restaurar o modelo InstallationConfig.rb para o estado original (utilizando serialize ... coder: YAML).

1.9 KiB Raw Permalink Blame History