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