Guia de Onboarding no Ecossistema

Este tutorial orienta a configuração do ambiente de desenvolvimento local para atuar nos repositórios da organização Yzex Tech.

1. Pré-Requisitos de Máquina

Para interagir com o ecossistema distribuído, as seguintes ferramentas devem estar instaladas localmente:

  • Git (>= 2.40) com suporte a LF/CRLF configurado defensivamente.

  • Node.js (>= 20.x LTS) e gerenciador de pacotes pnpm ou npm.

  • PostgreSQL Client Tools (psql >= 16) e utilitário dbmate para migrações.

  • Infisical CLI para injeção dinâmica de variáveis e segredos em memória (Secret Zero).

2. Autenticação e Gestão de Segredos

O ecossistema adota a política estrita de Secret Zero e Zero .env:

# Login no Infisical SaaS
infisical login

# Inicialização do projeto no repositório ativo
infisical init

Toda execução de scripts locais ou daemons deve ser envelopada pelo comando infisical run — <comando>.