Add Status

Telas de Administração #11

Makefile

@@ -11,10 +11,13 @@ init-db: clean
 seed: init-db
 	python seed.py
 
+init:
+	python app.py --init
+
 run:
 	python app.py
 
-run-with-seed: seed run
+run-with-seed: seed init run
 
 reset-admin: clean
 	python create_admin.py

app.py

@@ -51,6 +51,8 @@ from sqlalchemy.sql import func
 from flask_wtf.csrf import CSRFProtect
 import json
 from utils.date_utils import validar_data, converter_data, validar_sequencia_datas, calcular_idade
+from routes.admin import admin_bp  # Importar o blueprint administrativo
+import sys
 
 load_dotenv()
 
@@ -59,6 +61,9 @@ def create_app():
     app.secret_key = os.getenv('SECRET_KEY', secrets.token_hex(16))
     bootstrap = Bootstrap5(app)
 
+    # Registrar o blueprint administrativo
+    app.register_blueprint(admin_bp)
+
     # Configurar CSRF Protection
     csrf = CSRFProtect()
     csrf.init_app(app)
@@ -128,7 +133,30 @@ def create_app():
             if 'user_id' not in session:
                 flash('Por favor, faça login para acessar esta página.', 'warning')
                 return redirect(url_for('login'))
-            return f(*args, **kwargs)
+            
+            from sqlalchemy.orm import Session
+            db = get_db_connection()
+            try:
+                # Carregar o usuário com suas roles e permissões
+                user = db.query(Usuario).options(
+                    joinedload(Usuario.roles).joinedload(Role.permissions),
+                    joinedload(Usuario.militante),
+                    joinedload(Usuario.cr),
+                    joinedload(Usuario.setor),
+                    joinedload(Usuario.celula)
+                ).get(session['user_id'])
+                
+                if not user:
+                    flash('Usuário não encontrado.', 'danger')
+                    return redirect(url_for('login'))
+                
+                # Atualiza timestamp da última atividade
+                user.update_last_activity()
+                db.commit()
+                
+                return f(*args, **kwargs)
+            finally:
+                db.close()
         return decorated_function
 
     # Decorator para verificar se a sessão expirou
@@ -222,6 +250,7 @@ def create_app():
                 session['user_id'] = user.id
                 session['username'] = user.username
                 session['is_admin'] = user.is_admin
+                print(f"Login realizado: user_id={user.id}, username={user.username}, is_admin={user.is_admin}")
                 
                 # Redirecionar para home
                 return redirect(url_for("home"))
@@ -1361,34 +1390,36 @@ def create_app():
     @app.route('/usuarios/<int:user_id>/toggle_status', methods=['POST'])
     @require_login
     def toggle_user_status(user_id):
-        user = db_session.query(Usuario).get_or_404(user_id)
+        if not current_user.is_admin:
+            return jsonify({
+                'success': False,
+                'error': 'Você não tem permissão para alterar o status de usuários.'
+            }), 403
 
-        # Verificar permissões baseado na hierarquia
-        if not current_user.has_permission('system_config'):
-            if current_user.has_permission('manage_cr_sectors'):
-                # Secretário de CR só pode gerenciar membros do seu CR
-                if user.cr_id != current_user.cr_id:
-                    flash('Você não tem permissão para gerenciar este usuário.', 'danger')
-                    return redirect(url_for('dashboard_admin'))
-            elif current_user.has_permission('manage_sector_cells'):
-                # Secretário de Setor só pode gerenciar membros do seu setor
-                if user.setor_id != current_user.setor_id:
-                    flash('Você não tem permissão para gerenciar este usuário.', 'danger')
-                    return redirect(url_for('dashboard_admin'))
-            elif current_user.has_permission('manage_cell_members'):
-                # Secretário de Célula só pode gerenciar membros da sua célula
-                if user.celula_id != current_user.celula_id:
-                    flash('Você não tem permissão para gerenciar este usuário.', 'danger')
-                    return redirect(url_for('dashboard_admin'))
-            else:
-                # Militante básico não pode gerenciar ninguém
-                flash('Você não tem permissão para gerenciar usuários.', 'danger')
-                return redirect(url_for('dashboard_admin'))
+        db = get_db_connection()
+        try:
+            usuario = db.query(Usuario).get(user_id)
+            if not usuario:
+                return jsonify({
+                    'success': False,
+                    'error': 'Usuário não encontrado.'
+                }), 404
 
-        user.ativo = not user.ativo
-        db_session.commit()
+            usuario.ativo = not usuario.ativo
+            db.commit()
             
-        return jsonify({'success': True, 'message': 'Status do usuário alterado com sucesso!'})
+            return jsonify({
+                'success': True,
+                'message': f'Usuário {"ativado" if usuario.ativo else "desativado"} com sucesso!'
+            })
+        except Exception as e:
+            db.rollback()
+            return jsonify({
+                'success': False,
+                'error': str(e)
+            }), 500
+        finally:
+            db.close()
 
     @app.route('/usuarios/<int:user_id>/alterar_nivel', methods=['POST'])
     @require_login
@@ -1683,18 +1714,18 @@ def init_system():
 def main():
     # Criar a aplicação
     app = create_app()
-    
-    # Inicializar o sistema
-    init_system()
-    
     return app
 
 # Criar a aplicação usando a função main
 app = main()
 
 if __name__ == '__main__':
-    app.run(
-        host='0.0.0.0',
-        port=5000,
-        debug=os.getenv('FLASK_ENV') == 'development'
-    )
+    # Verificar se é para inicializar o sistema
+    if '--init' in sys.argv:
+        init_system()
+    else:
+        app.run(
+            host='0.0.0.0',
+            port=5000,
+            debug=os.getenv('FLASK_ENV') == 'development'
+        )

create_admin.py

@@ -70,6 +70,15 @@ def create_admin_user():
                 admin.set_password("admin123")
                 admin.generate_otp_secret()
                 
+                # Buscar ou criar role de admin
+                admin_role = db.query(Role).filter_by(nome="admin").first()
+                if not admin_role:
+                    admin_role = Role(nome="admin", nivel=0)  # Nível 0 é o mais alto
+                    db.add(admin_role)
+                
+                # Adicionar role ao usuário
+                admin.roles.append(admin_role)
+                
                 # Adicionar e fazer commit
                 db.add(admin)
                 db.commit()

create_test_users.py

@@ -0,0 +1,56 @@
+from functions.database import get_db_connection, Usuario, Role
+from werkzeug.security import generate_password_hash
+
+def create_test_users():
+    """Cria usuários de teste"""
+    db = get_db_connection()
+    try:
+        # Lista de usuários de teste
+        test_users = [
+            {
+                'username': 'aligner',
+                'email': 'aligner@test.com',
+                'password': 'Test123!@#',
+                'is_admin': False
+            },
+            {
+                'username': 'tester',
+                'email': 'tester@test.com', 
+                'password': 'Test123!@#',
+                'is_admin': False
+            },
+            {
+                'username': 'deployer',
+                'email': 'deployer@test.com',
+                'password': 'Test123!@#',
+                'is_admin': False
+            }
+        ]
+
+        # Criar cada usuário
+        for user_data in test_users:
+            user = db.query(Usuario).filter_by(username=user_data['username']).first()
+            
+            if not user:
+                user = Usuario(
+                    username=user_data['username'],
+                    email=user_data['email'],
+                    is_admin=user_data['is_admin']
+                )
+                user.set_password(user_data['password'])
+                db.add(user)
+                print(f"Usuário {user_data['username']} criado")
+            else:
+                print(f"Usuário {user_data['username']} já existe")
+
+        db.commit()
+        print("Usuários de teste criados com sucesso")
+
+    except Exception as e:
+        print(f"Erro ao criar usuários de teste: {str(e)}")
+        db.rollback()
+    finally:
+        db.close()
+
+if __name__ == "__main__":
+    create_test_users() 

docs/STATUS_IMPLEMENTACAO.md

@@ -0,0 +1,428 @@
+# Status de Implementação do Sistema de Controles
+
+> Gerado em: 2026-03-05
+> Baseado na análise do código-fonte e na demanda original.
+
+---
+
+## Legenda de Status
+
+| Ícone | Significado |
+|-------|-------------|
+| ✅ | Implementado e funcional |
+| ⚠️ | Parcialmente implementado |
+| ❌ | Não implementado |
+
+---
+
+## Resumo Geral
+
+| Requisito | Status | Progresso |
+|-----------|--------|-----------|
+| 1. Gerenciamento de Militantes | ⚠️ Parcial | 80% |
+| 2. Gestão de Células e Setores | ⚠️ Parcial | 75% |
+| 3. Registros de Depósitos | ⚠️ Parcial | 50% |
+| 4. Cadastro de Objetivos | ❌ Não iniciado | 0% |
+| 5. Relatórios Financeiros | ⚠️ Parcial | 40% |
+| 6. Controle Hierárquico (RBAC) | ✅ Implementado | 90% |
+| 7. Alterações de Responsáveis | ⚠️ Parcial | 60% |
+| 8. Auditoria e Rastreabilidade | ❌ Não iniciado | 5% |
+| 9. Segurança | ⚠️ Parcial | 70% |
+| 10. Compatibilidade com Planilhas | ❌ Não iniciado | 0% |
+| 11. Usabilidade / Responsividade | ⚠️ Parcial | 65% |
+| 12. Carteirinha do Militante | ❌ Não iniciado | 0% |
+| 13. Desacoplamento | ✅ Implementado | 90% |
+
+---
+
+## Detalhamento por Requisito
+
+---
+
+### 1. Gerenciamento de Militantes
+
+**Status: ⚠️ Parcial (80%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Cadastro de militantes | ✅ | Formulário completo com dados pessoais, profissionais, acadêmicos e sindicais |
+| Edição de militantes | ✅ | Rota e modal de edição funcionais |
+| Listagem de militantes | ✅ | Tabela com filtros e ordenação |
+| Exclusão de militantes | ✅ | Com confirmação via modal |
+| Níveis de permissão (8 níveis) | ✅ | RBAC hierárquico implementado com 8 níveis |
+| Hierarquias de usuários | ✅ | Estrutura Célula → Setor → CR → CC |
+| Status do militante (ativo, suspenso, etc.) | ✅ | 4 estados: ATIVO, DESLIGADO, SUSPENSO, AFASTADO |
+| Status de Aspirante | ✅ | Período mínimo de 3 meses com avaliação obrigatória |
+| Quadro-Orientador | ✅ | Responsabilidade especial implementada |
+| Alterar nível do usuário | ✅ | Rota `/usuarios/<id>/alterar_nivel` |
+| Avaliação do aspirante | ⚠️ | Modelo prevê, mas interface de avaliação pode estar incompleta |
+| Histórico de avaliações | ⚠️ | Registro existe no modelo, verificar completude da UI |
+
+**O que falta:**
+- Verificar se a interface de avaliação do aspirante está completa com todos os campos (participação, desenvolvimento político, pontos fortes, recomendações)
+
+---
+
+### 2. Gestão de Células e Setores
+
+**Status: ⚠️ Parcial (75%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Cadastro de células | ✅ | Formulário e rotas funcionais |
+| Cadastro de setores | ✅ | Formulário e rotas funcionais |
+| Cadastro de CRs | ✅ | Comitês Regionais cadastráveis |
+| Cadastro de CC | ✅ | Comitê Central cadastrável |
+| Organização hierárquica | ✅ | Células → Setores → CRs → CC |
+| Responsável geral da célula | ✅ | Campo `responsavel` no modelo |
+| Responsável de finanças | ✅ | Adicionado via migration recente |
+| Responsável de imprensa | ✅ | Adicionado via migration recente |
+| Edição de células | ✅ | Template `editar_celula.html` existe |
+| Edição de setores | ⚠️ | Template de edição de setor não foi confirmado |
+| Listagem hierárquica visual | ⚠️ | Listagens existem, mas visualização em árvore pode estar incompleta |
+| Atribuição de responsáveis via UI | ⚠️ | Funcionalidade adicionada no banco, verificar interface |
+
+**O que falta:**
+- Confirmar que a UI de atribuição dos responsáveis de finanças e imprensa está completa
+- Verificar se a edição de setores está implementada
+- Adicionar visualização hierárquica em árvore (Célula → Setor → CR → CC)
+
+---
+
+### 3. Registros de Depósitos
+
+**Status: ⚠️ Parcial (50%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Registro de cotas mensais | ✅ | Modelo `CotaMensal` com cálculo automático |
+| Registro de pagamentos gerais | ✅ | Modelo `Pagamento` multi-tipo |
+| Pagamento por PIX | ✅ | Modelo `TransacaoPIX` com QR code |
+| Depósitos por célula | ✅ | Modelo `PagamentoCelula` |
+| Depósitos por setor | ⚠️ | Rota existe, verificar completude do modelo |
+| Depósitos por CR | ⚠️ | Rota existe, verificar completude do modelo |
+| Valor, data e fonte do depósito | ✅ | Campos presentes nos modelos |
+| Depósito vinculado a objetivo/material | ⚠️ | Parcialmente via `TipoMaterial`, mas sem `Objetivo` |
+| Depósitos em eventos específicos | ❌ | Não há modelo de `Evento` com depósitos vinculados |
+| Registro de coletas em plenárias | ❌ | Não implementado |
+| Registro de coletas em formações | ❌ | Não implementado |
+| Contribuintes permanentes (CF) | ⚠️ | Existe como tipo de pagamento, mas sem funcionalidade específica |
+
+**O que falta:**
+- Criar modelo `Evento` (plenária, formação, célula) para vincular depósitos/coletas a eventos específicos
+- Implementar registro de coletas por evento com informação de "para qual objetivo"
+- Separar claramente o registro de contribuintes permanentes (CF)
+
+---
+
+### 4. Cadastro de Objetivos
+
+**Status: ❌ Não implementado (0%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Modelo de Objetivos | ❌ | Não existe no banco de dados |
+| Objetivos por militante | ❌ | Não implementado |
+| Objetivos gerais por evento | ❌ | Não implementado |
+| Objetivos de venda de materiais | ❌ | Não implementado |
+| Objetivos de coleta em eventos | ❌ | Não implementado |
+| Objetivos por nível (Nacional, Regional, Setor, Célula) | ❌ | Não implementado |
+| Acompanhamento de progresso | ❌ | Não implementado |
+| Interface de cadastro de objetivos | ❌ | Nenhum template existe |
+| Relatório de atingimento de objetivos | ❌ | Não implementado |
+
+**O que falta (tudo):**
+- Criar modelo `Objetivo` com campos: tipo_evento, instancia (Célula/Setor/CR/CC/Nacional), militante (opcional), valor_meta, data_evento
+- Criar rotas CRUD para objetivos
+- Criar interface para cadastro e acompanhamento
+- Vincular depósitos/coletas a objetivos
+- Criar relatório de progresso por objetivo
+
+---
+
+### 5. Relatórios Financeiros
+
+**Status: ⚠️ Parcial (40%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Modelo de relatório de cotas | ✅ | `RelatorioCotasMensais` existe |
+| Modelo de relatório de vendas | ✅ | `RelatorioVendasMateriais` existe |
+| Template de criação de relatório | ✅ | Templates `novo_relatorio_*.html` existem |
+| Template de listagem de relatórios | ✅ | Templates `listar_relatorios_*.html` existem |
+| Lógica de geração de relatórios | ❌ | `functions/relatorio.py` está **vazio** |
+| Relatório por célula | ❌ | Não implementado na lógica |
+| Relatório por setor | ❌ | Não implementado na lógica |
+| Relatório por CR | ❌ | Não implementado na lógica |
+| Relatório por CC (nacional) | ❌ | Não implementado na lógica |
+| Filtro por período | ⚠️ | Parcialmente nos templates |
+| Cotas detalhadas | ⚠️ | Modelo existe, lógica de aggregação ausente |
+| Contribuintes financeiros (CF) | ⚠️ | Tipo de pagamento existe, sem relatório específico |
+| Contribuintes permanentes | ⚠️ | Sem segmentação clara nos relatórios |
+| Coletas para eventos | ❌ | Depende do módulo de Eventos/Objetivos |
+| Exportação (PDF/CSV/Excel) | ❌ | Não implementado |
+
+**O que falta:**
+- **Prioridade máxima:** Implementar `functions/relatorio.py` com toda a lógica de aggregação de dados
+- Criar queries de aggregação por nível hierárquico (célula, setor, CR, CC)
+- Adicionar exportação em PDF e/ou CSV
+- Criar relatórios consolidados com breakdown por categoria (cotas, CF, materiais, coletas)
+
+---
+
+### 6. Controle Hierárquico (RBAC)
+
+**Status: ✅ Implementado (90%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| 8 níveis de permissão | ✅ | De Militante Básico a Secretário Geral |
+| Tabelas RBAC no banco | ✅ | `roles`, `permissions`, `role_permissions`, `user_roles` |
+| Decorators de acesso | ✅ | `@require_login`, `@require_permission`, `@require_role`, etc. |
+| Permissões por instância | ✅ | `@require_instance_permission`, `@require_instance_access` |
+| Herança de permissões | ✅ | Nível superior herda permissões dos níveis abaixo |
+| Filtragem de dados por hierarquia | ✅ | Queries filtradas por nível de acesso |
+| Verificação de hierarquia entre usuários | ✅ | `user.is_higher_or_equal_than()` |
+| Permissões de finanças e imprensa | ✅ | Roles específicos por instância |
+| Testes de permissões | ✅ | `tests/test_permissions.py` existe |
+
+**O que falta:**
+- Garantir que o RBAC cobre os novos módulos a serem criados (Objetivos, Eventos, Auditoria)
+
+---
+
+### 7. Alterações de Responsáveis
+
+**Status: ⚠️ Parcial (60%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Alterar responsável de célula | ✅ | Campo `responsavel_id` editável |
+| Alterar responsável financeiro | ✅ | Adicionado via migration |
+| Alterar responsável de imprensa | ✅ | Adicionado via migration |
+| Rota para alterar nível do usuário | ✅ | `/usuarios/<id>/alterar_nivel` |
+| Registro histórico de mudanças | ❌ | Não há tabela de histórico de responsáveis |
+| Interface de histórico | ❌ | Sem template para visualizar mudanças |
+| Notificação ao alterar responsável | ❌ | Não implementado |
+
+**O que falta:**
+- Criar modelo `HistoricoResponsavel` com: instancia_tipo, instancia_id, responsavel_anterior_id, responsavel_novo_id, tipo_responsabilidade, data_mudanca, alterado_por_id
+- Criar interface para visualizar histórico de responsáveis por instância
+
+---
+
+### 8. Auditoria e Rastreabilidade
+
+**Status: ❌ Não iniciado (5%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Log de sessões | ⚠️ | `last_activity` e `logout_reason` no modelo `Usuario` |
+| Log de alterações | ❌ | Sem modelo de `AuditLog` |
+| Rastrear quem fez o quê e quando | ❌ | Não implementado |
+| Log de criação/edição/exclusão | ❌ | Não implementado |
+| Log de alterações financeiras | ❌ | Não implementado |
+| Interface de auditoria para admins | ❌ | Não implementado |
+| Filtro por usuário, data, ação | ❌ | Não implementado |
+
+**O que falta (tudo):**
+- Criar modelo `AuditLog` com: user_id, acao, modelo_afetado, registro_id, dados_anteriores (JSON), dados_novos (JSON), ip_address, timestamp
+- Implementar hooks automáticos nos modelos SQLAlchemy (usando `event.listen`) para capturar INSERT, UPDATE, DELETE
+- Criar interface de auditoria no painel admin
+- Adicionar filtros por usuário, data, entidade
+
+---
+
+### 9. Segurança
+
+**Status: ⚠️ Parcial (70%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Autenticação com usuário e senha | ✅ | bcrypt para hash de senha |
+| OTP / 2FA (autenticação em dois fatores) | ✅ | pyotp + QR code implementados |
+| Proteção CSRF | ✅ | Flask-WTF com tokens CSRF |
+| Timeout de sessão | ✅ | 30 minutos configurável |
+| Reset de OTP pelo admin | ✅ | Rota `/admin/users/<id>/reset-otp` |
+| Reset de senha pelo admin | ✅ | Rota `/admin/users/<id>/reset-password` |
+| Ativar/desativar usuários | ✅ | Toggle de status |
+| Criptografia de dados sensíveis | ⚠️ | `cryptography` está nas dependências, uso não confirmado |
+| HTTPS / TLS | ⚠️ | Dependente de configuração de produção (Nginx/gunicorn) |
+| Validação de CPF | ✅ | `functions/validations.py` |
+| Rate limiting (anti-brute force) | ❌ | Não implementado |
+| Logs de tentativas de login | ❌ | Não implementado |
+
+**O que falta:**
+- Implementar rate limiting nas rotas de login
+- Garantir que dados financeiros sensíveis (valores, CPF) estejam criptografados no banco
+- Documentar configuração de HTTPS para produção
+
+---
+
+### 10. Compatibilidade com Planilhas dos CRs
+
+**Status: ❌ Não iniciado (0%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Importação de planilhas Excel | ❌ | Não implementado |
+| Importação de planilhas CSV | ❌ | Não implementado |
+| Exportação para Excel | ❌ | Não implementado |
+| Exportação para CSV | ❌ | Não implementado |
+| Mapeamento de colunas da planilha | ❌ | Não implementado |
+| Validação de dados importados | ❌ | Não implementado |
+| Interface de importação/exportação | ❌ | Nenhum template existe |
+
+**O que falta (tudo):**
+- Adicionar biblioteca `openpyxl` ou `pandas` para leitura/escrita de Excel
+- Criar rota de importação com preview e validação antes de confirmar
+- Criar rota de exportação com filtros (por período, instância, tipo)
+- Documentar o formato esperado das planilhas dos CRs
+
+---
+
+### 11. Usabilidade e Responsividade
+
+**Status: ⚠️ Parcial (65%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Framework CSS responsivo | ✅ | Bootstrap via `Bootstrap-Flask` |
+| Templates com layout responsivo | ✅ | `base.html` usa Bootstrap grid |
+| Ordenação de tabelas | ✅ | `table_sort.js` implementado |
+| Formulários com validação | ✅ | `forms.js` implementado |
+| Modais para ações rápidas | ✅ | Modais para criar/editar/excluir militantes |
+| Navegação por breadcrumb | ⚠️ | Verificar se está completo em todas as páginas |
+| Otimização para mobile | ⚠️ | Bootstrap ajuda, mas tabelas complexas podem quebrar no mobile |
+| Feedback visual de ações (toast/alert) | ⚠️ | Parcialmente implementado |
+| Loading states | ⚠️ | Não confirmado |
+| Suporte a múltiplos idiomas | ❌ | Sistema apenas em português (OK para o caso de uso) |
+
+**O que falta:**
+- Revisar tabelas grandes para mobile (considerar scroll horizontal ou layout card)
+- Garantir feedback visual (mensagens de sucesso/erro) em todas as ações
+- Testar em dispositivos móveis reais
+
+---
+
+### 12. Carteirinha do Militante
+
+**Status: ❌ Não iniciado (0%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Geração de imagem PNG | ❌ | `Pillow` está nas dependências, mas sem uso para carteirinha |
+| Logo da organização na carteirinha | ❌ | Não implementado |
+| Número de cadastro do militante | ❌ | Verificar se existe campo de número único |
+| QR Code com chave de recuperação | ❌ | `qrcode` está nas dependências, mas sem uso para carteirinha |
+| Download da carteirinha | ❌ | Não implementado |
+| Geração automática no cadastro | ❌ | Não implementado |
+| Template visual da carteirinha | ❌ | Não implementado |
+
+**O que falta (tudo):**
+- Verificar/criar campo de número único de cadastro no modelo `Militante`
+- Criar função em `functions/` para gerar o PNG usando Pillow:
+  - Fundo com template da organização
+  - Nome do militante
+  - Número de cadastro
+  - QR code com token de recuperação de senha
+- Criar rota `/militantes/<id>/carteirinha` que gera e faz download do PNG
+- Adicionar botão "Baixar Carteirinha" na tela de visualização do militante
+
+---
+
+### 13. Desacoplamento
+
+**Status: ✅ Implementado (90%)**
+
+| Funcionalidade | Status | Observações |
+|----------------|--------|-------------|
+| Mínimo de frameworks | ✅ | Flask + SQLAlchemy + bibliotecas padrão |
+| Sem dependência de cloud | ✅ | Roda localmente com SQLite |
+| Containerização com Docker | ✅ | Dockerfile e docker-compose.yml presentes |
+| Build automatizado | ✅ | Makefile para comandos comuns |
+| Configuração via .env | ✅ | python-dotenv utilizado |
+| Banco de dados portável | ✅ | SQLite sem necessidade de servidor externo |
+
+**O que falta:**
+- Avaliar se `openpyxl/pandas` (para planilhas) adicionaria dependência pesada demais
+- Documentar como compilar e rodar do zero no README
+
+---
+
+## Backlog Priorizado
+
+### 🔴 Alta Prioridade (bloqueadores de uso em produção)
+
+| # | Tarefa | Requisito | Esforço |
+|---|--------|-----------|---------|
+| 1 | Implementar `functions/relatorio.py` com lógica de geração | Req. 5 | Alto |
+| 2 | Criar módulo de Objetivos (modelo, rotas, templates) | Req. 4 | Alto |
+| 3 | Criar módulo de Eventos com registro de coletas/depósitos | Req. 3 | Médio |
+| 4 | Implementar Auditoria (AuditLog automático) | Req. 8 | Médio |
+
+### 🟡 Média Prioridade (funcionalidades importantes)
+
+| # | Tarefa | Requisito | Esforço |
+|---|--------|-----------|---------|
+| 5 | Histórico de mudança de responsáveis | Req. 7 | Baixo |
+| 6 | Carteirinha do militante em PNG | Req. 12 | Médio |
+| 7 | Exportação de relatórios para PDF/CSV | Req. 5 | Médio |
+| 8 | Rate limiting no login | Req. 9 | Baixo |
+
+### 🟢 Baixa Prioridade (melhorias e integrações)
+
+| # | Tarefa | Requisito | Esforço |
+|---|--------|-----------|---------|
+| 9 | Importação/exportação de planilhas Excel | Req. 10 | Alto |
+| 10 | Revisão de responsividade mobile | Req. 11 | Médio |
+| 11 | Completar interface de avaliação do aspirante | Req. 1 | Baixo |
+| 12 | Verificar e completar edição de setores | Req. 2 | Baixo |
+
+---
+
+## Arquitetura de Arquivos — O que existe
+
+```
+controles/
+├── app.py                        ✅ 44 rotas implementadas
+├── functions/
+│   ├── database.py               ✅ 25+ modelos SQLAlchemy
+│   ├── rbac.py                   ✅ Sistema RBAC completo
+│   ├── permissions.py            ✅ Funções de checagem de permissão
+│   ├── decorators.py             ✅ Decorators de autorização
+│   ├── auth.py                   ✅ Utilitários de autenticação
+│   ├── cota_calculator.py        ✅ Cálculo automático de cotas
+│   ├── validations.py            ✅ Validação de CPF
+│   └── relatorio.py              ❌ ARQUIVO VAZIO — precisa ser implementado
+├── routes/
+│   └── admin.py                  ✅ Rotas do painel admin
+├── templates/                    ✅ ~64 templates HTML
+├── static/
+│   └── js/                       ✅ 9 módulos JavaScript
+├── tests/                        ✅ Testes de permissão e rotas admin
+└── docs/                         ✅ Documentação RBAC e hierarquia
+```
+
+---
+
+## Novos Arquivos a Criar
+
+| Arquivo | Propósito |
+|---------|-----------|
+| `functions/relatorio.py` | Lógica de geração de relatórios (já existe vazio) |
+| `functions/audit.py` | Sistema de auditoria e log |
+| `functions/carteirinha.py` | Geração de carteirinha em PNG |
+| `routes/objetivos.py` | Blueprint para CRUD de objetivos |
+| `routes/eventos.py` | Blueprint para CRUD de eventos/coletas |
+| `routes/relatorios.py` | Blueprint para geração/download de relatórios |
+| `templates/novo_objetivo.html` | Interface de cadastro de objetivo |
+| `templates/listar_objetivos.html` | Listagem de objetivos |
+| `templates/novo_evento.html` | Interface de cadastro de evento |
+| `templates/listar_eventos.html` | Listagem de eventos |
+| `templates/relatorio_consolidado.html` | Relatório financeiro consolidado |
+| `templates/auditoria.html` | Interface de auditoria para admin |
+
+---
+
+*Documento gerado automaticamente com base na análise do código-fonte em 2026-03-05.*

functions/database.py

@@ -441,6 +441,7 @@ class Usuario(Base, UserMixin):
     username = Column(String(50), unique=True, nullable=False)
     password_hash = Column(String(255), nullable=False)
     email = Column(String(100), unique=True, nullable=False)
+    nome = Column(String(100))  # Nome completo do usuário
     otp_secret = Column(String(32))
     role_id = Column(Integer, ForeignKey('roles.id'))
     setor_id = Column(Integer, ForeignKey('setores.id'))
@@ -464,11 +465,11 @@ class Usuario(Base, UserMixin):
     cr = relationship('ComiteRegional', back_populates='usuarios')
     celula = relationship('Celula', back_populates='usuarios')
 
-    def __init__(self, username, email=None, is_admin=False):
+    def __init__(self, username, email=None, is_admin=False, nome=None):
         self.username = username
         self.email = email
         self.is_admin = is_admin
-        self.email = email
+        self.nome = nome
         self.ativo = True
         self.session_timeout = 30
         self.tipo = "USUARIO"
@@ -549,6 +550,10 @@ class Usuario(Base, UserMixin):
         self.motivo_logout = "Logout manual"
         self.ultima_atividade = None
 
+    def is_admin_user(self):
+        """Verifica se o usuário é admin"""
+        return self.is_admin or any(role.nome == "admin" for role in self.roles)
+
 class PagamentoCelula(Base):
     __tablename__ = 'pagamentos_celula'
     

functions/decorators.py

@@ -2,7 +2,7 @@ from functools import wraps
 from flask import session, redirect, url_for, flash
 from flask_login import current_user, login_required
 from sqlalchemy.orm import joinedload
-from .database import get_db_connection, Usuario
+from .database import get_db_connection, Usuario, Role
 from .rbac import Permission
 
 def require_login(f):
@@ -15,9 +15,13 @@ def require_login(f):
         
         db = get_db_connection()
         try:
-            # Carregar o usuário com suas roles
+            # Carregar o usuário com suas roles e permissões
             user = db.query(Usuario).options(
-                joinedload(Usuario.roles)
+                joinedload(Usuario.roles).joinedload(Role.permissions),
+                joinedload(Usuario.militante),
+                joinedload(Usuario.cr),
+                joinedload(Usuario.setor),
+                joinedload(Usuario.celula)
             ).get(current_user.id)
             
             if not user:
@@ -28,7 +32,15 @@ def require_login(f):
             user.update_last_activity()
             db.commit()
             
+            # Substituir o current_user pelo usuário carregado
+            setattr(current_user, '_get_current_object', lambda: user)
+            
+            # Executar a função com o usuário carregado
             return f(*args, **kwargs)
+        except Exception as e:
+            db.rollback()
+            flash('Erro ao carregar dados do usuário.', 'danger')
+            return redirect(url_for('login'))
         finally:
             db.close()
     return decorated_function
@@ -39,14 +51,38 @@ def require_permission(permission_name):
         @wraps(f)
         def decorated_function(*args, **kwargs):
             if not current_user.is_authenticated:
-                flash('Por favor, faça login para acessar esta página.', 'danger')
+                flash('Você precisa estar logado para acessar esta página.', 'error')
                 return redirect(url_for('login'))
             
-            if not current_user.has_permission(permission_name):
-                flash('Você não tem permissão para acessar esta página.', 'danger')
-                return redirect(url_for('home'))
+            db = get_db_connection()
+            try:
+                # Carregar o usuário com suas roles e permissões
+                user = db.query(Usuario).options(
+                    joinedload(Usuario.roles).joinedload(Role.permissions),
+                    joinedload(Usuario.militante),
+                    joinedload(Usuario.cr),
+                    joinedload(Usuario.setor),
+                    joinedload(Usuario.celula)
+                ).get(current_user.id)
                 
-            return f(*args, **kwargs)
+                if not user:
+                    flash('Usuário não encontrado.', 'error')
+                    return redirect(url_for('login'))
+                
+                if not user.has_permission(permission_name):
+                    flash('Você não tem permissão para acessar esta página.', 'error')
+                    return redirect(url_for('index'))
+                
+                # Atualiza timestamp da última atividade
+                user.update_last_activity()
+                db.commit()
+                
+                # Substituir o current_user pelo usuário carregado
+                setattr(current_user, '_get_current_object', lambda: user)
+                
+                return f(*args, **kwargs)
+            finally:
+                db.close()
         return decorated_function
     return decorator
 

pytest.ini

@@ -0,0 +1,5 @@
+[pytest]
+pythonpath = .
+testpaths = tests
+python_files = test_*.py
+addopts = -v --cov=. --cov-report=term-missing 

routes/__init__.py

@@ -0,0 +1,2 @@
+# Este arquivo está intencionalmente vazio
+# Ele é usado para marcar o diretório como um pacote Python 

routes/admin.py

@@ -0,0 +1,128 @@
+from flask import Blueprint, render_template, flash, redirect, url_for, request, jsonify
+from functions.database import Usuario, get_db_connection
+from functions.decorators import require_permission, require_role, require_minimum_role
+from flask_login import login_required, current_user
+from sqlalchemy.orm import joinedload
+import pyotp
+from werkzeug.security import generate_password_hash
+import secrets
+from functools import wraps
+from sqlalchemy.exc import SQLAlchemyError
+import logging
+from datetime import datetime
+
+logger = logging.getLogger(__name__)
+
+admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
+
+def admin_required(f):
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        if not current_user.is_admin:
+            flash('Acesso não autorizado.', 'danger')
+            return redirect(url_for('main.index'))
+        return f(*args, **kwargs)
+    return decorated_function
+
+@admin_bp.route('/')
+@login_required
+@admin_required
+def dashboard():
+    """Dashboard principal da área administrativa com lista de usuários"""
+    db = get_db_connection()
+    try:
+        now = datetime.now()
+        
+        # Carregar estatísticas relevantes
+        total_users = db.query(Usuario).count()
+        active_users = db.query(Usuario).filter(Usuario.is_active == True).count()
+        inactive_users = total_users - active_users
+        
+        # Carregar lista de usuários
+        users = db.query(Usuario).options(
+            joinedload(Usuario.roles),
+            joinedload(Usuario.militante)
+        ).all()
+        
+        return render_template(
+            'admin/dashboard.html',
+            total_users=total_users,
+            active_users=active_users,
+            inactive_users=inactive_users,
+            users=users,
+            now=now
+        )
+    except SQLAlchemyError as e:
+        logger.error(f"Erro ao buscar dados do dashboard: {str(e)}")
+        flash('Erro ao carregar dados. Por favor, tente novamente.', 'danger')
+        return render_template('admin/dashboard.html',
+                            total_users=0,
+                            active_users=0,
+                            inactive_users=0,
+                            users=[])
+    finally:
+        db.close()
+
+@admin_bp.route('/users/<int:user_id>/reset-otp', methods=['POST'])
+@login_required
+@require_role('ADMIN')
+def reset_user_otp(user_id):
+    """Reseta o OTP de um usuário"""
+    db = get_db_connection()
+    try:
+        user = db.query(Usuario).get(user_id)
+        if not user:
+            flash('Usuário não encontrado.', 'danger')
+            return redirect(url_for('admin.dashboard'))
+        
+        # Gerar novo segredo OTP
+        user.otp_secret = pyotp.random_base32()
+        db.commit()
+        
+        flash(f'OTP resetado com sucesso para {user.email}.', 'success')
+        return redirect(url_for('admin.dashboard'))
+    finally:
+        db.close()
+
+@admin_bp.route('/users/<int:user_id>/reset-password', methods=['POST'])
+@login_required
+@require_role('ADMIN')
+def reset_user_password(user_id):
+    """Reseta a senha de um usuário"""
+    db = get_db_connection()
+    try:
+        user = db.query(Usuario).get(user_id)
+        if not user:
+            flash('Usuário não encontrado.', 'danger')
+            return redirect(url_for('admin.dashboard'))
+        
+        # Gerar nova senha aleatória
+        new_password = secrets.token_urlsafe(8)
+        user.password = generate_password_hash(new_password)
+        db.commit()
+        
+        flash(f'Senha resetada com sucesso. Nova senha: {new_password}', 'success')
+        return redirect(url_for('admin.dashboard'))
+    finally:
+        db.close()
+
+@admin_bp.route('/users/<int:user_id>/toggle-status', methods=['POST'])
+@login_required
+@require_role('ADMIN')
+def toggle_user_status(user_id):
+    """Ativa/desativa um usuário"""
+    db = get_db_connection()
+    try:
+        user = db.query(Usuario).get(user_id)
+        if not user:
+            flash('Usuário não encontrado.', 'danger')
+            return redirect(url_for('admin.dashboard'))
+        
+        user.is_active = not user.is_active
+        db.commit()
+        
+        status = 'ativado' if user.is_active else 'desativado'
+        flash(f'Usuário {status} com sucesso.', 'success')
+        return redirect(url_for('admin.dashboard'))
+    finally:
+        db.close() 

run_tests.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# Criar e ativar ambiente virtual
+python -m venv venv
+source venv/bin/activate
+
+# Instalar dependências de teste
+pip install -r tests/requirements-test.txt
+
+# Instalar o projeto em modo de desenvolvimento
+pip install -e .
+
+# Executar testes
+python -m pytest
+
+# Desativar ambiente virtual
+deactivate 

setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="controles",
+    version="0.1",
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        'flask',
+        'flask-login',
+        'flask-sqlalchemy',
+        'flask-wtf',
+        'flask-mail',
+        'python-dotenv',
+        'pyotp',
+        'qrcode',
+    ],
+) 

static/css/components.css

@@ -20,6 +20,10 @@
     --bs-success-dark: #157347;
     --bs-secondary: #6c757d;
     --bs-secondary-dark: #565e64;
+    
+    /* Variáveis para status */
+    --status-active: #28a745;
+    --status-inactive: #dc3545;
 }
 
 /* Tabelas */
@@ -609,3 +613,14 @@ input.btn-secondary:hover,
     background-color: #cff4fc;
     border-color: #b6effb;
 }
+
+/* Status styles */
+.status-active {
+    color: var(--status-active);
+    font-weight: 500;
+}
+
+.status-inactive {
+    color: var(--status-inactive);
+    font-weight: 500;
+} 

templates/admin/base.html

@@ -0,0 +1,102 @@
+{% extends "base.html" %}
+
+{% block title %}Área Administrativa{% endblock %}
+
+{% block content %}
+<div class="container-fluid">
+    <div class="row">
+        <!-- Sidebar -->
+        <nav id="sidebar" class="col-md-3 col-lg-2 d-md-block bg-light sidebar">
+            <div class="position-sticky pt-3">
+                <ul class="nav flex-column">
+                    <li class="nav-item">
+                        <a class="nav-link {% if request.endpoint == 'admin.dashboard' %}active{% endif %}" 
+                           href="{{ url_for('admin.dashboard') }}">
+                            <i class="fas fa-tachometer-alt me-2"></i>
+                            Dashboard
+                        </a>
+                    </li>
+                    <li class="nav-item">
+                        <a class="nav-link {% if request.endpoint == 'admin.list_users' %}active{% endif %}"
+                           href="{{ url_for('admin.list_users') }}">
+                            <i class="fas fa-users me-2"></i>
+                            Usuários
+                        </a>
+                    </li>
+                    <li class="nav-item">
+                        <a class="nav-link" href="{{ url_for('home') }}">
+                            <i class="fas fa-arrow-left me-2"></i>
+                            Voltar ao Sistema
+                        </a>
+                    </li>
+                </ul>
+            </div>
+        </nav>
+
+        <!-- Main content -->
+        <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
+            <div class="d-flex justify-content-between flex-wrap flex-md-nowrap align-items-center pt-3 pb-2 mb-3 border-bottom">
+                <h1 class="h2">{% block admin_title %}{% endblock %}</h1>
+            </div>
+
+            {% with messages = get_flashed_messages(with_categories=true) %}
+                {% if messages %}
+                    {% for category, message in messages %}
+                        <div class="alert alert-{{ category }} alert-dismissible fade show" role="alert">
+                            {{ message }}
+                            <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
+                        </div>
+                    {% endfor %}
+                {% endif %}
+            {% endwith %}
+
+            {% block admin_content %}{% endblock %}
+        </main>
+    </div>
+</div>
+{% endblock %}
+
+{% block extra_css %}
+<style>
+.sidebar {
+    position: fixed;
+    top: 0;
+    bottom: 0;
+    left: 0;
+    z-index: 100;
+    padding: 48px 0 0;
+    box-shadow: inset -1px 0 0 rgba(0, 0, 0, .1);
+}
+
+.sidebar .nav-link {
+    font-weight: 500;
+    color: #333;
+}
+
+.sidebar .nav-link.active {
+    color: #2470dc;
+}
+
+.sidebar-heading {
+    font-size: .75rem;
+    text-transform: uppercase;
+}
+
+main {
+    padding-top: 48px;
+}
+
+@media (max-width: 767.98px) {
+    .sidebar {
+        position: static;
+        padding-top: 0;
+    }
+    
+    main {
+        padding-top: 0;
+    }
+}
+</style>
+{% endblock %}
+
+{% block extra_scripts %}{% endblock %} 

templates/admin/dashboard.html

@@ -0,0 +1,227 @@
+{% extends "admin/base.html" %}
+
+{% block title %}Dashboard Administrativo{% endblock %}
+
+{% block extra_css %}
+<style>
+.card {
+    border: none;
+    border-radius: 12px;
+    box-shadow: 0 4px 12px rgba(0,0,0,0.05);
+    transition: all 0.3s ease;
+    overflow: hidden;
+}
+
+.card:hover {
+    transform: translateY(-5px);
+    box-shadow: 0 8px 24px rgba(0,0,0,0.1);
+}
+
+.bg-primary {
+    background: linear-gradient(135deg, #0d6efd, #0a58ca) !important;
+}
+
+.bg-success {
+    background: linear-gradient(135deg, #198754, #146c43) !important;
+}
+
+.bg-danger {
+    background: linear-gradient(135deg, #dc3545, #b02a37) !important;
+}
+
+.card .opacity-50 {
+    opacity: 0.2 !important;
+    transition: all 0.3s ease;
+}
+
+.card:hover .opacity-50 {
+    opacity: 0.3 !important;
+    transform: scale(1.1);
+}
+
+.card-title {
+    font-size: 0.9rem;
+    font-weight: 600;
+    margin-bottom: 1rem;
+    text-transform: uppercase;
+    color: rgba(255,255,255,0.8);
+}
+
+.display-4 {
+    font-size: 2.5rem;
+    font-weight: 600;
+    margin: 0.5rem 0;
+}
+
+.btn-group {
+    gap: 0.25rem;
+}
+
+/* Estilo da lista de usuários */
+.card.lista-usuarios {
+    border-radius: 0;
+    box-shadow: none;
+    transition: none;
+    border: 1px solid #dee2e6;
+}
+
+.card.lista-usuarios:hover {
+    transform: none;
+    box-shadow: none;
+}
+
+.card.lista-usuarios .card-header {
+    background: linear-gradient(to right, var(--secondary-dark), var(--secondary-color));
+    color: white;
+    border: none;
+    padding: 1rem 1.5rem;
+}
+
+.card.lista-usuarios .card-header h5 {
+    margin: 0;
+    font-size: 1.1rem;
+    font-weight: 500;
+}
+
+.card.lista-usuarios .table {
+    margin-bottom: 0;
+}
+
+.card.lista-usuarios .table th {
+    border-top: none;
+    font-weight: 600;
+    padding: 1rem;
+    background-color: #f8f9fa;
+}
+
+.card.lista-usuarios .table td {
+    padding: 1rem;
+    vertical-align: middle;
+}
+
+.card.lista-usuarios .badge {
+    padding: 0.5em 0.8em;
+    font-weight: 500;
+}
+
+.btn-group .btn {
+    padding: 0.375rem 0.75rem;
+    font-size: 0.875rem;
+}
+</style>
+{% endblock %}
+
+{% block content %}
+<h2 class="mb-4">
+    <i class="fas fa-users-cog"></i> 
+    Administração de Usuários
+</h2>
+
+<div class="row mb-4">
+    <div class="col-md-4">
+        <div class="card bg-primary text-white">
+            <div class="card-body">
+                <h5 class="card-title text-uppercase">Total de Usuários</h5>
+                <div class="d-flex justify-content-between align-items-center">
+                    <h2 class="display-4 mb-0">{{ total_users }}</h2>
+                    <i class="fas fa-users fa-3x opacity-50"></i>
+                </div>
+            </div>
+        </div>
+    </div>
+    <div class="col-md-4">
+        <div class="card bg-success text-white">
+            <div class="card-body">
+                <h5 class="card-title text-uppercase">Usuários Ativos</h5>
+                <div class="d-flex justify-content-between align-items-center">
+                    <h2 class="display-4 mb-0">{{ active_users }}</h2>
+                    <i class="fas fa-user-check fa-3x opacity-50"></i>
+                </div>
+            </div>
+        </div>
+    </div>
+    <div class="col-md-4">
+        <div class="card bg-danger text-white">
+            <div class="card-body">
+                <h5 class="card-title text-uppercase">Usuários Inativos</h5>
+                <div class="d-flex justify-content-between align-items-center">
+                    <h2 class="display-4 mb-0">{{ inactive_users }}</h2>
+                    <i class="fas fa-user-times fa-3x opacity-50"></i>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+
+<div class="card lista-usuarios">
+    <div class="card-header d-flex justify-content-between align-items-center">
+        <h5 class="mb-0">
+            <i class="fas fa-users me-2"></i>
+            Lista de Usuários
+        </h5>
+    </div>
+    <div class="card-body p-0">
+        <table id="users-table" class="table table-striped table-hover">
+            <thead>
+                <tr>
+                    <th>Nome</th>
+                    <th>Email</th>
+                    <th>Status</th>
+                    <th>Último Login</th>
+                    <th>Ações</th>
+                </tr>
+            </thead>
+            <tbody>
+                {% for user in users %}
+                <tr>
+                    <td>{{ user.name }}</td>
+                    <td>{{ user.email }}</td>
+                    <td>
+                        <span class="badge {% if user.is_active %}bg-success{% else %}bg-danger{% endif %}">
+                            {{ "Ativo" if user.is_active else "Inativo" }}
+                        </span>
+                    </td>
+                    <td>{{ user.last_login.strftime('%d/%m/%Y %H:%M') if user.last_login else 'Nunca' }}</td>
+                    <td>
+                        <div class="btn-group">
+                            <form action="{{ url_for('admin.reset_user_otp', user_id=user.id) }}" method="post" class="d-inline">
+                                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+                                <button type="submit" class="btn btn-warning btn-sm" title="Reset OTP" onclick="return confirm('Confirma o reset do OTP deste usuário?')">
+                                    <i class="fas fa-key"></i>
+                                </button>
+                            </form>
+                            <form action="{{ url_for('admin.reset_user_password', user_id=user.id) }}" method="post" class="d-inline">
+                                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+                                <button type="submit" class="btn btn-info btn-sm" title="Reset Senha" onclick="return confirm('Confirma o reset da senha deste usuário?')">
+                                    <i class="fas fa-lock"></i>
+                                </button>
+                            </form>
+                            <form action="{{ url_for('admin.toggle_user_status', user_id=user.id) }}" method="post" class="d-inline">
+                                <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+                                <button type="submit" class="btn btn-{{ 'danger' if user.is_active else 'success' }} btn-sm" title="{{ 'Desativar' if user.is_active else 'Ativar' }} Usuário">
+                                    <i class="fas fa-{{ 'user-times' if user.is_active else 'user-check' }}"></i>
+                                </button>
+                            </form>
+                        </div>
+                    </td>
+                </tr>
+                {% endfor %}
+            </tbody>
+        </table>
+    </div>
+</div>
+{% endblock %}
+
+{% block extra_js %}
+<script>
+$(document).ready(function() {
+    $('#users-table').DataTable({
+        language: {
+            url: '//cdn.datatables.net/plug-ins/1.13.7/i18n/pt-BR.json'
+        },
+        order: [[0, 'asc']],
+        pageLength: 25
+    });
+});
+</script>
+{% endblock %} 

templates/base.html

@@ -10,9 +10,9 @@
     <!-- Bootstrap 5 CSS -->
     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css?v=1" rel="stylesheet">
     <!-- Font Awesome 6 -->
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css?v=1">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css" integrity="sha512-DTOQO9RWCH3ppGqcWaEA1BIZOC6xxalwEsw9c2QQeAIftl+Vegovlnee1c9QX4TctnWMn13TZye+giMm8e2LwA==" crossorigin="anonymous" referrerpolicy="no-referrer" />
     <!-- Componentes CSS -->
-    <link rel="stylesheet" href="{{ url_for('static', filename='css/components.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/components.css') }}?v={{ range(1, 10000) | random }}">
     
     <style>
         :root {
@@ -599,6 +599,11 @@
                                     <i class="fas fa-user-plus"></i>Novo Usuário
                                 </a>
                             </li>
+                            <li>
+                                <a class="dropdown-item" href="{{ url_for('admin.dashboard') }}">
+                                    <i class="fas fa-cog fa fa-cog fa-solid fa-cog" style="display: inline-block !important; visibility: visible !important;"></i>Administração
+                                </a>
+                            </li>
                             <li><hr class="dropdown-divider"></li>
                             {% endif %}
                             <li>

templates/dashboard_admin.html

@@ -1,63 +1,69 @@
-{% extends 'base.html' %}
+{% extends "base.html" %}
 
 {% block title %}Dashboard Administrativo{% endblock %}
 
 {% block content %}
-<div class="container">
-    <h1 class="mb-4">Dashboard Administrativo</h1>
-    
-    {% with messages = get_flashed_messages(with_categories=true) %}
-        {% if messages %}
-            {% for category, message in messages %}
-                <div class="alert alert-{{ category }}">{{ message }}</div>
-            {% endfor %}
-        {% endif %}
-    {% endwith %}
-    
-    <div class="card mb-4">
-        <div class="card-header">
-            <h5 class="card-title mb-0">Gerenciamento de Usuários</h5>
-        </div>
+<div class="container mt-4">
+    <h2 class="mb-4"><i class="fas fa-users-cog"></i> Administração de Usuários</h2>
+    <div class="card">
         <div class="card-body">
             <div class="table-responsive">
-                <table class="table table-striped">
-                    <thead>
+                <table class="table table-hover">
+                    <thead class="thead-light">
                         <tr>
-                            <th>ID</th>
                             <th>Usuário</th>
                             <th>Email</th>
-                            <th>Admin</th>
-                            <th>OTP Configurado</th>
+                            <th>Nome</th>
+                            <th>Último Acesso</th>
+                            <th>Status</th>
+                            <th>Nível</th>
                             <th>Ações</th>
                         </tr>
                     </thead>
                     <tbody>
                         {% for usuario in usuarios %}
                         <tr>
-                            <td>{{ usuario.id }}</td>
                             <td>{{ usuario.username }}</td>
                             <td>{{ usuario.email }}</td>
+                            <td>{{ usuario.nome }}</td>
+                            <td>{{ usuario.last_login }}</td>
+                            <td>
+                                <span class="badge {% if usuario.ativo %}bg-success{% else %}bg-danger{% endif %}">
+                                    {{ "Ativo" if usuario.ativo else "Inativo" }}
+                                </span>
+                            </td>
                             <td>
                                 {% if usuario.is_admin %}
-                                    <span class="badge bg-success">Sim</span>
+                                    Administrador
                                 {% else %}
-                                    <span class="badge bg-secondary">Não</span>
+                                    {{ usuario.nivel }}
                                 {% endif %}
                             </td>
                             <td>
-                                {% if usuario.otp_secret %}
-                                    <span class="badge bg-success">Sim</span>
-                                {% else %}
-                                    <span class="badge bg-danger">Não</span>
-                                {% endif %}
-                            </td>
-                            <td>
-                                <form action="{{ url_for('reset_otp', user_id=usuario.id) }}" method="POST" class="d-inline">
-                                    <button type="submit" class="btn btn-warning btn-sm" 
-                                            onclick="return confirm('Tem certeza que deseja resetar o OTP deste usuário?')">
-                                        Resetar OTP
+                                <div class="btn-group" role="group">
+                                    <button class="btn btn-sm btn-outline-primary" 
+                                            onclick="toggleStatus('{{ usuario.id }}')"
+                                            data-toggle="tooltip"
+                                            title="{{ 'Desativar' if usuario.ativo else 'Ativar' }} usuário">
+                                        <i class="fas {% if usuario.ativo %}fa-user-times{% else %}fa-user-check{% endif %}"></i>
                                     </button>
-                                </form>
+                                    
+                                    <button class="btn btn-sm btn-outline-warning"
+                                            onclick="resetarSenha('{{ usuario.id }}')"
+                                            data-toggle="tooltip"
+                                            title="Resetar senha">
+                                        <i class="fas fa-key"></i>
+                                    </button>
+                                    
+                                    {% if not usuario.is_admin %}
+                                    <button class="btn btn-sm btn-outline-info"
+                                            onclick="alterarNivel('{{ usuario.id }}')"
+                                            data-toggle="tooltip"
+                                            title="Alterar nível">
+                                        <i class="fas fa-level-up-alt"></i>
+                                    </button>
+                                    {% endif %}
+                                </div>
                             </td>
                         </tr>
                         {% endfor %}
@@ -66,18 +72,127 @@
             </div>
         </div>
     </div>
+</div>
 
-    <div class="card">
-        <div class="card-header">
-            <h5 class="card-title mb-0">Ações Rápidas</h5>
-        </div>
-        <div class="card-body">
-            <div class="d-grid gap-2">
-                <a href="{{ url_for('novo_usuario') }}" class="btn btn-primary">
-                    Criar Novo Usuário
-                </a>
+<!-- Modal de Feedback -->
+<div class="modal fade" id="feedbackModal" tabindex="-1" role="dialog">
+    <div class="modal-dialog" role="document">
+        <div class="modal-content">
+            <div class="modal-header">
+                <h5 class="modal-title">Aviso</h5>
+                <button type="button" class="close" data-dismiss="modal">
+                    <span>&times;</span>
+                </button>
+            </div>
+            <div class="modal-body">
+                <p id="feedbackMessage"></p>
+            </div>
+            <div class="modal-footer">
+                <button type="button" class="btn btn-secondary" data-dismiss="modal">Fechar</button>
             </div>
         </div>
     </div>
 </div>
+
+{% endblock %}
+
+{% block scripts %}
+<script>
+function showFeedback(message, type = 'info') {
+    const modal = document.getElementById('feedbackModal');
+    const messageElement = document.getElementById('feedbackMessage');
+    messageElement.textContent = message;
+    messageElement.className = `alert alert-${type}`;
+    $(modal).modal('show');
+}
+
+function handleResponse(response) {
+    if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+    }
+    return response.json();
+}
+
+function toggleStatus(userId) {
+    if (!confirm('Tem certeza que deseja alterar o status deste usuário?')) {
+        return;
+    }
+
+    fetch(`/usuarios/${userId}/toggle_status`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').content
+        }
+    })
+    .then(handleResponse)
+    .then(data => {
+        showFeedback(data.message || 'Status alterado com sucesso!', data.success ? 'success' : 'danger');
+        if (data.success) {
+            setTimeout(() => location.reload(), 1500);
+        }
+    })
+    .catch(error => {
+        console.error('Error:', error);
+        showFeedback('Erro ao alterar status do usuário. Por favor, tente novamente.', 'danger');
+    });
+}
+
+function resetarSenha(userId) {
+    if (!confirm('Tem certeza que deseja resetar a senha deste usuário?')) {
+        return;
+    }
+
+    fetch(`/reset_password/${userId}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').content
+        }
+    })
+    .then(handleResponse)
+    .then(data => {
+        showFeedback(data.message || 'Senha resetada com sucesso!', data.success ? 'success' : 'danger');
+    })
+    .catch(error => {
+        console.error('Error:', error);
+        showFeedback('Erro ao resetar senha. Por favor, tente novamente.', 'danger');
+    });
+}
+
+function alterarNivel(userId) {
+    const novoNivel = prompt('Digite o novo nível do usuário (1-5):');
+    if (!novoNivel) return;
+
+    if (!/^[1-5]$/.test(novoNivel)) {
+        showFeedback('Por favor, insira um nível válido entre 1 e 5.', 'warning');
+        return;
+    }
+
+    fetch(`/usuarios/${userId}/alterar_nivel`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-CSRFToken': document.querySelector('meta[name="csrf-token"]').content
+        },
+        body: JSON.stringify({ nivel: parseInt(novoNivel) })
+    })
+    .then(handleResponse)
+    .then(data => {
+        showFeedback(data.message || 'Nível alterado com sucesso!', data.success ? 'success' : 'danger');
+        if (data.success) {
+            setTimeout(() => location.reload(), 1500);
+        }
+    })
+    .catch(error => {
+        console.error('Error:', error);
+        showFeedback('Erro ao alterar nível. Por favor, tente novamente.', 'danger');
+    });
+}
+
+// Inicializa os tooltips do Bootstrap
+$(function () {
+    $('[data-toggle="tooltip"]').tooltip();
+});
+</script>
 {% endblock %} 

tests/conftest.py

@@ -0,0 +1,33 @@
+import pytest
+from app import create_app
+from functions.database import init_database, get_db_connection
+
+@pytest.fixture
+def app():
+    """Cria uma instância do app para testes"""
+    app = create_app()
+    app.config['TESTING'] = True
+    app.config['WTF_CSRF_ENABLED'] = False
+    
+    # Inicializar banco de dados de teste
+    init_database()
+    
+    yield app
+    
+    # Limpar banco após os testes
+    db = get_db_connection()
+    try:
+        db.execute('DROP TABLE IF EXISTS usuarios CASCADE')
+        db.commit()
+    finally:
+        db.close()
+
+@pytest.fixture
+def client(app):
+    """Cria um cliente de teste"""
+    return app.test_client()
+
+@pytest.fixture
+def runner(app):
+    """Cria um runner de CLI para testes"""
+    return app.test_cli_runner() 

tests/requirements-test.txt

@@ -0,0 +1,4 @@
+pytest==7.4.3
+pytest-cov==4.1.0
+pytest-flask==1.3.0
+coverage==7.3.2 

tests/test_admin_routes.py

@@ -0,0 +1,100 @@
+import pytest
+from flask import url_for
+from functions.database import Usuario, get_db_connection
+from werkzeug.security import generate_password_hash
+import json
+
+@pytest.fixture
+def admin_user(client):
+    """Fixture que cria um usuário admin para testes"""
+    db = get_db_connection()
+    try:
+        admin = Usuario(
+            username='admin_test',
+            email='admin@test.com',
+            password_hash=generate_password_hash('admin123'),
+            is_admin=True,
+            is_active=True
+        )
+        db.add(admin)
+        db.commit()
+        return admin
+    finally:
+        db.close()
+
+@pytest.fixture
+def auth_admin_client(client, admin_user):
+    """Fixture que retorna um cliente autenticado como admin"""
+    client.post('/login', data={
+        'email': 'admin@test.com',
+        'password': 'admin123'
+    })
+    return client
+
+def test_dashboard_access_sem_login(client):
+    """Testa acesso ao dashboard sem login"""
+    response = client.get('/admin/')
+    assert response.status_code == 302
+    assert '/login' in response.headers['Location']
+
+def test_dashboard_access_com_login(auth_admin_client):
+    """Testa acesso ao dashboard com login de admin"""
+    response = auth_admin_client.get('/admin/')
+    assert response.status_code == 200
+    assert b'Dashboard Administrativo' in response.data
+
+def test_lista_usuarios(auth_admin_client):
+    """Testa listagem de usuários"""
+    response = auth_admin_client.get('/admin/users')
+    assert response.status_code == 200
+    assert b'Lista de' in response.data
+    assert b'admin_test' in response.data
+
+def test_reset_otp(auth_admin_client, admin_user):
+    """Testa reset de OTP"""
+    response = auth_admin_client.post(f'/admin/users/{admin_user.id}/reset-otp')
+    assert response.status_code == 302
+    assert 'success' in response.headers['Location']
+
+def test_reset_password(auth_admin_client, admin_user):
+    """Testa reset de senha"""
+    response = auth_admin_client.post(f'/admin/users/{admin_user.id}/reset-password')
+    assert response.status_code == 302
+    assert 'success' in response.headers['Location']
+
+def test_toggle_status(auth_admin_client, admin_user):
+    """Testa alteração de status do usuário"""
+    response = auth_admin_client.post(
+        f'/admin/users/{admin_user.id}/toggle-status',
+        headers={'Content-Type': 'application/json'}
+    )
+    data = json.loads(response.data)
+    assert response.status_code == 200
+    assert data['success'] is True
+
+def test_acesso_nao_admin(client):
+    """Testa acesso de usuário não admin"""
+    db = get_db_connection()
+    try:
+        # Criar usuário normal
+        user = Usuario(
+            username='normal_user',
+            email='user@test.com',
+            password_hash=generate_password_hash('user123'),
+            is_admin=False,
+            is_active=True
+        )
+        db.add(user)
+        db.commit()
+
+        # Login
+        client.post('/login', data={
+            'email': 'user@test.com',
+            'password': 'user123'
+        })
+
+        # Tentar acessar área admin
+        response = client.get('/admin/')
+        assert response.status_code == 403
+    finally:
+        db.close()