📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Matriz de 20 Capítulos de Aplicações Full Stack. Recomendado revisar antes de iniciar a execução.

🔐 PI 02 — SafePass Corporate: Gestão Segura de Credenciais

v1.0 — Projeto Integrador Full Stack para cofre corporativo de senhas, auditoria de acessos em conformidade com a LGPD e gerador criptográfico de alta entropia.

Trilha de Especialização Pedagógica — Série Projetos Integradores (PI 2 de 6)

• PI 01: ParkManager (Gestão de Vagas, Tarifação e Caixa)
• PI 02 (este): SafePass Corporate (Cofre de Senhas, Criptografia e LGPD)
• PI 03: ChefPoint (Comanda Digital e KDS Restaurante)
• PI 04: TechBorrow (Empréstimo de Dispositivos de TI)
• PI 05: StockFlow (Almoxarifado e Ponto de Pedido)
• PI 06: QuickDrop (Roteamento Expresso de Delivery)

🎓 Nível Profissional Simulado: Engenheiro de Segurança de Software / Arquiteto Full Stack. A gestão centralizada de segredos e senhas em ambientes corporativos exige aderência estrita a padrões de criptografia simétrica (AES-128 / Fernet), hashing com sal (BCrypt), segregação de privilégios (RBAC) e trilhas de auditoria para atendimento da LGPD e ISO 27001.

🏛️ Galeria Arquitetural & Diagramas de Engenharia

Arquitetura de Controle de Acesso e Camadas de Identidade

Diagrama de Casos de Uso Formal (UML)

📁 Estrutura Canônica de Pastas Anti-Colisão

O projeto adota a convenção padronizada de subpastas por camada e tecnologia <camada>-<tecnologia>:

catalogo_projetos/fullstack_pi_02_safepass/
├── web-react/                  # Aplicação SPA moderna em React 18, Vite e TailwindCSS
│   ├── src/
│   │   ├── components/         # VaultGrid, PasswordGenerator, AuditLogViewer
│   │   ├── types/              # Definições TypeScript de Credencial, Usuário e Log
│   │   ├── utils/              # Criptografia local, medidor de entropia e validações
│   │   ├── App.tsx             # Gerenciamento de cofre e autenticação mestre
│   │   └── main.tsx            # Ponto de entrada da aplicação
│   ├── package.json            # Scripts de build, Lucide Icons e Tailwind
│   └── vite.config.ts          # Configurações do bundler
├── assets/                     # Galeria de diagramas vetoriais SVG autorais
├── README.md                   # Resumo executivo do projeto
└── SafePass_Corporate_Documentacao_Final.md # Especificação acadêmica e DDL de banco

🧑‍💼 Especificação Formal de Engenharia de Software

1. Histórias de Usuário (User Stories)

• US-SP01: Como administrador de segurança, quero definir políticas globais de complexidade de senhas para todos os colaboradores da empresa.
• US-SP02: Como analista de suporte, quero gerar senhas seguras de alta entropia com caracteres alfanuméricos e símbolos em um único clique.
• US-SP03: Como colaborador corporativo, quero armazenar credenciais de sistemas internos em um cofre encriptado protegido por chave mestra.
• US-SP04: Como encarregado de dados (DPO), quero auditar todos os eventos de visualização e cópia de credenciais com timestamp e IP.
• US-SP05: Como auditor de conformidade, quero identificar senhas expiradas ou fracas para forçar a rotação de credenciais corporativas.

2. Requisitos Funcionais (RF)

• RF-SP01: O sistema deve implementar gerador de senhas com parametrização de comprimento (8 a 64 caracteres), dígitos, maiúsculas, minúsculas e símbolos.
• RF-SP02: O armazenamento de segredos deve ser cifrado com algoritmo simétrico AES antes de qualquer gravação em persistência.
• RF-SP03: O cofre deve disponibilizar função de cópia segura para a área de transferência com limpeza automática após 30 segundos.
• RF-SP04: A aplicação deve registrar trilha de auditoria contendo data, hora, usuário e identificador do segredo acessado.
• RF-SP05: O painel deve calcular visualmente o nível de entropia da senha (em bits) classificando-a como Fraca, Média, Forte ou Muito Forte.

3. Requisitos Não-Funcionais (RNF)

• RNF-SP01 (Criptografia Forte): A derivação de chave mestre deve utilizar algoritmo de estiramento de chave PBKDF2 ou Argon2id com no mínimo 100.000 iterações.
• RNF-SP02 (Privacy by Design): Nenhuma credencial em texto claro deve trafegar em logs ou ser persistida no banco sem cifragem.
• RNF-SP03 (Tempo de Execução): A geração e aferição de entropia de senhas deve ocorrer no navegador em menos de 10 milissegundos.
• RNF-SP04 (Conformidade LGPD): O sistema deve fornecer opção de esquecimento/anonimização de dados de usuários desligados da empresa.
• RNF-SP05 (Zero Dependências Externas Sensíveis): Os cálculos criptográficos devem basear-se na Web Crypto API nativa do navegador.

📐 Diagrama de Casos de Uso (Mermaid)

flowchart LR
    subgraph Atores
        Usuario["👤 Colaborador"]
        DPO["🛡️ Auditor / DPO"]
    end

    subgraph "Sistema SafePass Corporate"
        UC01["UC01: Autenticar no Cofre de Senhas"]
        UC02["UC02: Gerar Senha de Alta Entropia"]
        UC03["UC03: Armazenar Credencial Encriptada"]
        UC04["UC04: Copiar Credencial com Limpeza"]
        UC05["UC05: Auditar Trilha de Acessos (LGPD)"]
    end

    Usuario --> UC01
    Usuario --> UC02
    Usuario --> UC03
    Usuario --> UC04

    DPO --> UC01
    DPO --> UC05

📊 Matriz de Rastreabilidade de Requisitos (RTM)

🚀 Roteiro de Execução & Homologação no Laboratório

1. Inicialização do Frontend SafePass (web-react)

cd catalogo_projetos/fullstack_pi_02_safepass/web-react

# Instalação das dependências
npm install

# Inicialização do servidor de desenvolvimento
npm run dev

• A interface estará disponível em: http://localhost:5173.

2. Leitura da Documentação Técnica

• Consulte o documento completo em: SafePass_Corporate_Documentacao_Final.html para scripts DDL de banco de dados e detalhes de conformidade com a LGPD.

🧪 Matriz de Checkpoints de Homologação (CP-01 a CP-05)