commit 8e217116550d32fd0bc7500d3c2d6cd357f3c7f6 Author: Git Admin Ipiranga Agroindustrial S.A Date: Thu Aug 27 12:38:52 2026 +0000 Adicionar README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..1acc5b1 --- /dev/null +++ b/README.md @@ -0,0 +1,123 @@ +# Bem-vindo(a) ao ambiente de desenvolvimento — Ipiranga Agroindustrial + +Este documento reúne as premissas e regras de negócio dos sistemas: +* **Git** (repositórios de código). +* **Portainer** (gestão de containers). +Leia com atenção — ele explica o que você pode acessar, como fazer login e a quem +recorrer quando precisar de algo novo. + +--- + +## Princípios gerais (valem para os dois sistemas) + +Nosso ambiente segue três princípios básicos: + +1. **Acesso mínimo.** Cada pessoa enxerga e manipula apenas os recursos do seu setor. + Você não verá repositórios ou containers de outras áreas — isso é **intencional** e + protege todo mundo de acidentes. +2. **Cadastro controlado.** Contas não são criadas por autocadastro. Um administrador + cria a sua conta manualmente, com o seu e-mail corporativo, e te adiciona ao setor + correto. Ninguém entra sozinho, mesmo tendo conta Microsoft válida. +3. **Login pela Microsoft.** A autenticação é feita com a sua conta corporativa + (`@ipirangaagro.com.br`) via Microsoft. Você não precisa memorizar uma senha + separada para esses sistemas. + +--- + +## Como fazer login + +Ambos os sistemas ficam atrás do nosso firewall e são acessados por HTTPS: + +- **Gitea:** https://git.ipirangaagroindustrial.com.br +- **Portainer:** https://hub-ipiranga/portainer/#!/home + +Na tela de login, clique em **"Entrar com a Microsoft"** e use sua conta corporativa. + +> **Primeiro acesso ao Gitea:** na primeira vez, o sistema pode pedir uma vinculação +> única entre sua conta Microsoft e a conta local. O T.I. te orienta nesse passo — +> ele acontece só uma vez; depois disso, o login é direto pela Microsoft. + +--- + +## Gitea — regras de negócio + +O Gitea guarda nosso código-fonte, organizado **por setor**. + +**Organizações por setor.** Cada área tem sua própria organização (ex.: `ipiranga-agricola`, +`ipiranga-fiscal`, `ipiranga-ti`). Uma organização é isolada das outras — você só enxerga +a(s) organização(ões) da(s) qual(is) é membro. + +**Repositórios são privados.** Todo repositório é **privado** e visível apenas para os +**membros do setor** com acesso a ele. Não crie repositórios públicos. + +**Papéis dentro do setor.** Cada organização de setor tem: +- Um ou mais **gestores** (acesso de administrador aos repositórios do setor: podem + criar, configurar e gerenciar repositórios daquela área). +- **Membros** com acesso de leitura ou escrita, conforme a necessidade da função. +- O **T.I. central**, que pode ter acesso de leitura para dar suporte. + +**O que você provavelmente NÃO pode fazer** (a menos que seja liberado): +- Criar novas organizações (esse direito é concedido individualmente, caso a caso). +- Apagar a organização do setor (isso é exclusivo dos administradores). +- Ver ou acessar repositórios de outros setores. + +**Precisa de um repositório novo ou de acesso a um existente?** Fale com o gestor do +seu setor (para repositórios da sua área) ou com o T.I. (para acessos entre áreas). + +--- + +## Portainer — regras de negócio + +O Portainer gerencia os containers das aplicações. O acesso também é **por setor**. + +**Segmentação por time.** Cada setor é um "time" no Portainer. Você é adicionado ao +time da sua área e passa a ver apenas os recursos (stacks e containers) daquele time. + +**Acesso restrito às stacks do seu setor.** As aplicações do seu setor são organizadas +em *stacks* marcadas como restritas ao seu time. Você consegue operar (iniciar, parar, +reiniciar, ver logs) apenas os containers do seu setor. + +**O que você NÃO vê:** stacks, containers, volumes e redes de outros setores, nem +recursos administrativos do servidor. + +**Precisa de acesso a uma nova aplicação?** Fale com o T.I. — a inclusão de um recurso +ao seu time é feita por um administrador. + +--- + +## Como pedir mudanças de acesso + +Como o modelo é de acesso mínimo, mudanças são feitas por um administrador. Ao pedir, +informe: + +- Seu nome e e-mail corporativo. +- O setor / organização em questão. +- O que você precisa (ex.: acesso a um repositório específico, criar uma nova aplicação, + permissão para criar organizações). +- O motivo / contexto do pedido. + +Isso agiliza a liberação e mantém o registro de quem tem acesso a quê. + +--- + +## Contatos + +- **Gestor do seu setor:** responsável pelos repositórios e aplicações da sua área. +- **T.I. central:** para acessos entre setores, novas contas, novas organizações/stacks + e suporte geral. + +--- + +## Resumo rápido + +| Tema | Gitea | Portainer | +|------|-------|-----------| +| Unidade de isolamento | Organização (por setor) | Time (por setor) | +| Visibilidade | Só a(s) sua(s) organização(ões) | Só as stacks do seu time | +| Login | Microsoft | Microsoft | +| Criação de conta | Manual, pelo admin | Manual, pelo admin | +| Repositórios / recursos | Sempre privados | Restritos ao time | +| Pedir mais acesso | Gestor do setor ou T.I. | T.I. | + +*Este documento reflete as premissas atuais do ambiente e pode ser atualizado conforme +a empresa cresce. Em caso de dúvida, procure o T.I.* \ No newline at end of file