feat: implementa sistema de responsabilidades e instâncias - Adiciona responsabilidades de Finanças e Imprensa para todas as instâncias - Cria templates genéricos para gerenciamento de instâncias - Implementa sistema de permissões baseado em RBAC - Adiciona status de Aspirante com avaliação obrigatória - Atualiza documentação com novas regras e responsabilidades - Cria testes para validação das permissões - Adiciona migração para novos campos no banco de dados
This commit is contained in:
165
docs/README.md
Normal file
165
docs/README.md
Normal file
@@ -0,0 +1,165 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user