controles/docs/README.md

# Sistema de Controle OCI

## Hierarquia e Permissões

### Níveis de Acesso

1. **Militante Básico**
   - Pode ver apenas os membros da sua própria célula
   - Não pode alterar níveis de outros usuários

2. **Secretário de Célula**
   - Pode ver e gerenciar apenas os membros da sua célula
   - Não pode alterar níveis de outros usuários

3. **Membro de Setor**
   - Pode ver apenas os dados do setor ao qual pertence
   - Não pode alterar níveis de outros usuários

4. **Secretário de Setor**
   - Pode ver e gerenciar todos os dados do seu setor
   - Pode alterar níveis de militantes do setor, transformando-os em secretários
   - Não pode alterar níveis de membros de outros setores

5. **Membro de CR**
   - Pode ver apenas os dados do CR ao qual pertence
   - Não pode alterar níveis de outros usuários

6. **Secretário de CR**
   - Pode ver e gerenciar todos os dados do seu CR
   - Pode alterar níveis de membros do CR
   - Não pode alterar níveis de membros de outros CRs

7. **Membro do CC**
   - Pode ver todos os dados do sistema
   - Não pode alterar níveis de outros usuários

8. **Secretário Geral e Secretário de Organização**
   - Pode ver todos os dados do sistema
   - Pode alterar níveis de qualquer usuário em qualquer instância

### Regras de Visualização

- Cada militante só pode ver os membros da sua própria célula
- Membros de setor só veem dados do setor ao qual pertencem
- Membros de CR só veem informações do CR ao qual pertencem
- Membros do CC podem ver todas as informações do sistema

### Regras de Edição

- Apenas o Secretário Geral e o Secretário de Organização podem alterar níveis em todas as instâncias
- Secretários de CR podem alterar níveis apenas dentro do seu CR
- Secretários de Setor podem alterar níveis apenas dentro do seu setor, transformando militantes em secretários
- Outros níveis não podem alterar níveis de outros usuários 

## Responsabilidades

O sistema suporta as seguintes responsabilidades para militantes:

- Militante Básico (1)
- Secretário de Célula (2)
- Secretário de Setor (4)
- Secretário de CR (8)
- Secretário de CC (16)
- Secretário Geral (32)
- Quadro-Orientador (64)
- Responsável de Finanças (256)
- Responsável de Imprensa (512)

### Status de Aspirante

Todo novo militante começa como Aspirante. Este status tem as seguintes características:

1. **Duração Mínima**: O status de Aspirante deve ser mantido por pelo menos 3 meses após a integração do militante.

2. **Avaliação Obrigatória**: Para remover o status de Aspirante, é necessário:
   - Ter passado o período mínimo de 3 meses
   - Registrar uma avaliação detalhada da atuação do militante durante este período

3. **Quem pode Avaliar**: A avaliação e remoção do status de Aspirante pode ser feita por:
   - Secretário Geral
   - Secretário de Organização
   - Secretários de CR (para militantes de seu CR)
   - Secretários de Setor (para militantes de seu setor)

4. **Registro da Avaliação**: A avaliação deve incluir:
   - Análise da participação do militante nas atividades
   - Desenvolvimento político e organizativo
   - Pontos fortes e aspectos a melhorar
   - Recomendações para o desenvolvimento futuro

5. **Histórico**: O sistema mantém registro de:
   - Data de início do período como Aspirante
   - Data da avaliação
   - Texto completo da avaliação

O Quadro-Orientador é uma responsabilidade especial que pode ser atribuída a militantes em qualquer nível hierárquico, incluindo membros de CR e CC. Esta responsabilidade indica que o militante tem a função de orientar e apoiar outros militantes em sua formação política e organizativa.

A atribuição da responsabilidade de Quadro-Orientador pode ser feita por:
- Secretário Geral
- Secretário de Organização
- Secretários de CR (para militantes de seu CR)
- Secretários de Setor (para militantes de seu setor)

### Responsáveis de Finanças e Imprensa

Cada instância (Célula, Setor, CR e CC) possui três responsáveis:

1. **Responsável Geral**: Obrigatório para todas as instâncias. É o principal responsável pela instância.

2. **Responsável de Finanças**: Opcional. Responsável por:
   - Controle financeiro da instância
   - Arrecadação de contribuições
   - Prestação de contas
   - Planejamento financeiro

3. **Responsável de Imprensa**: Opcional. Responsável por:
   - Comunicação externa da instância
   - Produção de materiais de divulgação
   - Gestão de redes sociais
   - Relacionamento com a mídia

Os responsáveis de finanças e imprensa são designados pelo responsável geral da instância, com aprovação da instância superior.

## Hierarquia de Instâncias

1. **Comitê Central (CC)**
   - Instância máxima da organização
   - Possui responsável geral, de finanças e de imprensa
   - Coordena todos os CRs

2. **Comitê Regional (CR)**
   - Subordinado ao CC
   - Possui responsável geral, de finanças e de imprensa
   - Coordena os setores da sua região

3. **Setor**
   - Subordinado ao CR
   - Possui responsável geral, de finanças e de imprensa
   - Coordena as células do seu setor

4. **Célula**
   - Subordinada ao Setor
   - Possui responsável geral, de finanças e de imprensa
   - Unidade básica de organização

## Permissões

As permissões no sistema são baseadas nas responsabilidades do militante e na hierarquia das instâncias:

1. **Visualização**
   - Militantes básicos veem apenas sua célula
   - Secretários de célula veem sua célula
   - Secretários de setor veem seu setor e células
   - Secretários de CR veem seu CR, setores e células
   - Secretários de CC veem todos os dados

2. **Edição**
   - Cada nível pode gerenciar apenas os níveis abaixo
   - Responsáveis de finanças e imprensa podem editar apenas suas áreas
   - Quadros-Orientadores podem avaliar militantes

3. **Responsabilidades**
   - Apenas o nível superior pode atribuir responsabilidades
   - Responsáveis de finanças e imprensa são designados pelo responsável geral
   - O status de Quadro-Orientador segue regras específicas