chatwoot-develop/progresso/resolucao-ruby34-chatwoot.md

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

1. Instalação de Ferramentas:
   • brew install ruby-install chruby overmind
   • ruby-install ruby 3.4.4
2. 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.
3. Dependências:
   • gem install bundler:2.5.11
   • bundle install
4. 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

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

Como Reverter

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