AI DEVELOPMENT STANDARD

Manual de Padronização:
Biofy Git Flow

Diretrizes fundamentais para a gestão de código e IA. Este manual estabelece como nossas ramificações devem operar para garantir escalabilidade, segurança e deploys contínuos.

01. Mapeamento de Ambientes

Instável

Ambiente DEV

Integração contínua de novas funcionalidades e modelos de IA em fase de teste.

develop
Validação

Ambiente HOMOLOG

Mirror de produção para QA, testes de estresse e homologação de clientes.

release/*
Estável

Ambiente PRD

Versão estável servida aos usuários finais. Código de alta disponibilidade.

main

02. Estrutura de Ramificações

Tipo
feature/*
Objetivo

Desenvolvimento de novas funcionalidades ou componentes de IA.

Fluxo

Nasce na develop ➔ Retorna para develop.

Tipo
hotfix/*
Objetivo

Correções críticas imediatas em ambiente de produção.

Fluxo

Nasce na main ➔ Merge em main e develop.

03. Workflow na Prática

Inicialização

Repositório nasce com a branch main. A branch develop é criada imediatamente como base de trabalho.

Desenvolvimento Paralelo

Equipes de IA e Software criam suas feature/ a partir da develop.

Criação da Release

Quando a develop atinge maturidade, abre-se a release/v* para testes em Homologação.

Deploy Final & Tagging

Merge da release para main. É obrigatório criar uma Tag de versão (ex: v1.1.0) para rastreabilidade histórica.

Nota Biofy: Se o projeto exige deploy contínuo de modelos (CD/MLOps) ou é um micro-serviço agnóstico, o time técnico pode optar pelo GitHub Flow para maior agilidade.