Adicionar README.md

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.*