Plataforma Unificada de Trabalho Digital

Conjunto de scripts e aplicações para automação de tarefas de gestão de identidades (AD/Exchange) para o projeto Plataforma Unificada de Trabalho Digital.

📜 Sumário

Visão Geral do Projeto
🚀 Módulos e Funcionalidades Principais
🛠️ Tecnologias Utilizadas
🏁 Começando (Getting Started)
- Pré-requisitos
- Instalação
📖 Como Usar
🗺️ Fases do Projeto (Roadmap)
🤝 Como Contribuir

🌟 Visão Geral do Projeto

Este projeto detalha a criação de uma Plataforma Unificada de Trabalho Digital, um portal de autoatendimento (self-service) e automação projetado para modernizar e otimizar a gestão de identidades e acessos. A plataforma visa reduzir a carga de trabalho do time de TI, empoderar os usuários, aumentar a segurança e garantir a conformidade com a LGPD através de processos automatizados e auditáveis.

🚀 Módulos e Funcionalidades Principais

Portal de Autoatendimento do Usuário:
- Login seguro (integração com AD).
- Atualização de dados cadastrais (telefone, endereço, etc.).
- Reset de senha de forma autônoma e segura.
- Visualização de organograma.
Portal de Gestão (RH e Gestores):
- Formulário inteligente para requisição de novos colaboradores.
- Fluxo de aprovação para criação de contas.
- Processo automatizado de desligamento (offboarding).
- Gestão de grupos de acesso e distribuição.
Automação e Orquestração (Backend):
- Scripts PowerShell robustos para provisionamento em Active Directory e Exchange.
- Higienização automática de dados do AD (contas inativas, dados incompletos).
- Módulo de auditoria e geração de relatórios de conformidade.
Integrações e Segurança:
- Integração Multi-AD (múltiplas florestas/domínios).
- Conexão com sistemas de SIEM para monitoramento de eventos.
- Painel de gestão para administradores de TI.

🛠️ Tecnologias Utilizadas

Backend/Automação: PowerShell 5.1+
Framework de Testes: Pester
Controle de Versão: Git / Gitea
Frontend (Portal): HTML5, CSS3, JavaScript (Vue.js ou React a ser definido)
Backend (Portal): Node.js ou .NET Core (a ser definido)
Banco de Dados: PostgreSQL ou MariaDB (a ser definido)

🏁 Começando (Getting Started)

Esta seção descreve como configurar o ambiente para executar os scripts de automação.

Pré-requisitos

Para executar os scripts de automação e os testes contidos neste repositório, o ambiente precisa atender aos seguintes requisitos:

PowerShell 5.1 ou superior.
Módulo ActiveDirectory para PowerShell:
- Pode ser instalado via "Recursos Opcionais" do Windows ou com o comando:
```
Install-WindowsFeature RSAT-AD-PowerShell
```
Módulo Pester para execução dos testes:
- Normalmente já vem instalado nas versões mais recentes do Windows. Para instalar ou atualizar, use:
```
Install-Module -Name Pester -Force -SkipPublisherCheck
```

Instalação

Clone o repositório do Gitea para sua máquina local:

git clone [http://10.10.253.128/seu-usuario/plataforma-unificada-ad.git](http://10.10.253.128/seu-usuario/plataforma-unificada-ad.git)

Navegue até o diretório do projeto:
```
cd plataforma-unificada-ad
```
Execute os testes para garantir que tudo está funcionando como esperado:
```
Invoke-Pester -Path .\tests\
```

📖 Como Usar

Exemplo de Execução do Script

O script cria-usuario-unico.ps1 é o coração do provisionamento individual. Ele deve ser executado a partir de um terminal PowerShell com os parâmetros necessários.

Exemplo de uso:

# 1. Primeiro, armazene as credenciais de forma segura em variáveis
$clientCred = Get-Credential
$exchangeCred = Get-Credential

# 2. Execute o script localizado na pasta 'src' com os parâmetros do usuário
.\src\cria-usuario-unico.ps1 `
    -ClientADServer "dc01.cliente.local" `
    -ClientADCredential $clientCred `
    -ExchangeADServer "dc01.exchange.local" `
    -ExchangeADCredential $exchangeCred `
    -SamAccountName "joao.novo" `
    -UserPrincipalName "joao.novo@cliente.com.br" `
    -GivenName "Joao" `
    -Surname "Novo" `
    -Name "Joao Novo" `
    -Path "OU=Usuarios,DC=cliente,DC=local"
🧪 Executando os Testes
Os testes automatizados garantem a qualidade e a estabilidade do código. Eles foram criados com o framework Pester. Para executá-los, navegue até a pasta raiz do projeto e use o seguinte comando:

PowerShell

Invoke-Pester -Path .\tests\
🗺️ Fases do Projeto (Roadmap)
Fase	Entrega Principal	Estimativa	Entregáveis e Valor Agregado
1	Discovery e Arquitetura	3-4 Semanas	Blueprint técnico, DPIA/LGPD, planejamento de extensão AD
2	Prova de Conceito (PoC) de Riscos	2 Semanas	Validação de integrações complexas (Multi-AD, SIEM)
3	MVP - Autoatendimento Essencial	6-8 Semanas	Portal com login, troca de senha e atualização de perfil
4	Módulo de Gestão (Gestores e RH)	5-6 Semanas	Criação de usuários, grupos, e módulo de desligamento
5	Módulos de Automação e Auditoria	5-7 Semanas	Scripts de higienização, organograma e painel de auditoria
6	Integração com Sistemas Externos	4-6 Semanas	Conectores (Exchange, Nextcloud, Zammad), dashboard unificado
7	Painel de Gestão e Configurações	3-4 Semanas	Painel de admin para gerenciar variáveis e integrações
8	Lançamento e Melhoria Contínua	Contínuo	Plataforma em produção, monitoramento de KPIs e treinamento

Exportar para as Planilhas
🤝 Como Contribuir
Contribuições são o que tornam a comunidade um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.

Faça um Fork do Projeto

Crie sua Feature Branch (git checkout -b feature/AmazingFeature)

Faça o Commit de suas alterações (git commit -m 'Add some AmazingFeature')

Faça o Push para a Branch (git push origin feature/AmazingFeature)

Abra um Pull Request

6.5 KiB Raw Blame History Unescape Escape