NoIdle/GIT_INSTRUCTIONS.md

📚 Instruções Git - NoIdle

✅ Repositório Configurado com Sucesso!

Seu projeto NoIdle foi enviado para: https://meurepositorio.com/sergio.correa/NoIdle.git

---

📊 Status Atual

✅ Commit inicial enviado:

• Commit: 6086c13
• Mensagem: "feat: Implementação completa do NoIdle - Cliente, Backend e Scripts"
• Branch: main
• Arquivos: 58 arquivos (10.693+ linhas)

---

🔄 Comandos Git Úteis

Ver Status

cd /var/www/pointcontrol
git status

Ver Histórico

git log --oneline

Fazer Novos Commits

# Adicionar arquivos modificados
git add .

# Fazer commit
git commit -m "Sua mensagem aqui"

# Enviar para o repositório
git push

Criar Nova Branch

# Criar e mudar para nova branch
git checkout -b feature/nova-funcionalidade

# Fazer push da nova branch
git push -u origin feature/nova-funcionalidade

Atualizar do Repositório Remoto

# Baixar atualizações
git pull origin main

Ver Branches

# Listar branches locais
git branch

# Listar branches remotas
git branch -r

# Listar todas
git branch -a

---

🌐 Acessar Repositório Web

Abra no navegador: https://meurepositorio.com/sergio.correa/NoIdle

---

📦 Estrutura do Repositório

NoIdle/
├── README.md                              # Documentação principal
├── LEIA_PRIMEIRO.md                       # Guia rápido
│
├── CLIENTE_CORRIGIDO.py                   # Cliente Windows (Python)
│
├── BUILD_NOIDLE.ps1                       # Build Windows
├── BUILD_LINUX.sh                         # Build Linux
├── BUILD_CLIENTE.md                       # Documentação de build
├── COMANDOS_BUILD.md                      # Quick reference
├── Dockerfile.build                       # Docker build
│
├── CONFIGURAR_AUTOSTART_NOIDLE.ps1       # Script de configuração
├── VERIFICAR_E_CORRIGIR_NOIDLE.ps1       # Script de diagnóstico
├── DIAGNOSTICO_CLIENTE_WINDOWS.ps1       # Diagnóstico detalhado
│
├── SOLUCAO_AUTOSTART.md                   # Documentação técnica
├── GUIA_RAPIDO_AUTOSTART.md              # Guia do usuário
├── README_SOLUCAO_AUTOSTART.md           # Visão geral da solução
│
├── backend/                               # API Node.js
│   ├── server.js
│   ├── routes/
│   └── config/
│
└── frontend/                              # Dashboard Next.js
    └── ...

---

🚀 Próximos Passos

1. Clone em Outra Máquina

git clone https://meurepositorio.com/sergio.correa/NoIdle.git
cd NoIdle

2. Build no Windows

# Clonar repositório
git clone https://meurepositorio.com/sergio.correa/NoIdle.git
cd NoIdle

# Build
.\BUILD_NOIDLE.ps1

3. Desenvolver Localmente

# Backend
cd backend
npm install
npm run dev

# Frontend
cd frontend
npm install
npm run dev

---

🔐 Segurança

⚠️ Token no Remote URL

O token de acesso está na URL do remote. Para maior segurança:

Opção 1: Remover token da URL após configurar SSH

# Configurar SSH
ssh-keygen -t ed25519 -C "sergio.correa@meurepositorio.com"
cat ~/.ssh/id_ed25519.pub
# Adicionar chave pública no Gitea

# Mudar para SSH
git remote set-url origin git@meurepositorio.com:sergio.correa/NoIdle.git

Opção 2: Usar Git Credential Helper

# Cache de credenciais (1 hora)
git config --global credential.helper cache

# Ou armazenar permanentemente (menos seguro)
git config --global credential.helper store

---

📝 Boas Práticas

Mensagens de Commit

# Formato recomendado
feat: Nova funcionalidade
fix: Correção de bug
docs: Atualização de documentação
refactor: Refatoração de código
test: Adição de testes
chore: Tarefas de manutenção

# Exemplos
git commit -m "feat: Adiciona suporte a proxy HTTP"
git commit -m "fix: Corrige problema de auto-start no Windows 11"
git commit -m "docs: Atualiza README com instruções de instalação"

Workflow Recomendado

# 1. Criar branch para nova feature
git checkout -b feature/minha-feature

# 2. Fazer alterações e commitar
git add .
git commit -m "feat: Implementa minha feature"

# 3. Push da branch
git push -u origin feature/minha-feature

# 4. Criar Pull Request no Gitea
# 5. Após aprovação, merge para main

---

🔄 Atualizar Repositório

Sempre que fizer alterações:

cd /var/www/pointcontrol

# Ver o que mudou
git status

# Adicionar arquivos
git add .

# Commitar
git commit -m "Sua mensagem aqui"

# Enviar
git push

---

📊 Ver Diferenças

# Ver mudanças não commitadas
git diff

# Ver mudanças já em staging
git diff --staged

# Ver mudanças entre branches
git diff main..outra-branch

---

🏷️ Tags (Versões)

# Criar tag
git tag -a v1.0.0 -m "Versão 1.0.0 - Release inicial"

# Enviar tags
git push --tags

# Listar tags
git tag

---

🆘 Comandos de Emergência

Desfazer Último Commit (mantém alterações)

git reset --soft HEAD~1

Desfazer Alterações Locais

git checkout -- arquivo.txt

Voltar para Commit Específico

git checkout <hash-do-commit>

Limpar Arquivos Não Rastreados

git clean -fd

---

📞 Ajuda

Documentação Git

git help
git help commit
git help push

Links Úteis

• Repositório: https://meurepositorio.com/sergio.correa/NoIdle
• Gitea Docs: https://docs.gitea.io/

---

✅ Checklist Pós-Setup

• Repositório inicializado
• Arquivos commitados
• Remote configurado
• Push realizado com sucesso
• Git user configurado
• SSH configurado (opcional)
• Colaboradores adicionados (se necessário)
• Proteção de branch configurada (se necessário)

---

Repositório pronto para uso! 🎉

Para começar a trabalhar em outro lugar:

git clone https://meurepositorio.com/sergio.correa/NoIdle.git