📚 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 04 — TechBorrow (DeviceFlow): Gestão de Ativos de TI

v1.0 — Projeto Integrador Full Stack para controle de custódia, empréstimo de dispositivos eletrônicos, termos de responsabilidade digital e prevenção de perdas de patrimônio corporativo.

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

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

🎓 Nível Profissional Simulado: Administrador de Infraestrutura / Engenheiro Full Stack. O extravio e a falta de controle sobre notebooks, smartphones e adaptadores de TI causam prejuízos severos às empresas. Dominar o ciclo de vida de ativos de tecnologia (tombamento, custódia, termo assinado e devolução com vistoria) prepara para governança de TI em nível de excelência.

🏛️ Galeria Arquitetural & Diagramas de Engenharia

Arquitetura de Custódia e Gestão de Dispositivos

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_04_techborrow/
├── web-react/                  # Aplicação SPA moderna em React 18, Vite e TailwindCSS
│   ├── src/
│   │   ├── components/         # AssetCatalog, LoanModal, ReturnInspector, AuditPanel
│   │   ├── types/              # Definições TypeScript de Dispositivo, Empréstimo, Usuário
│   │   ├── utils/              # Validação de patrimônio, cálculo de atraso e termos
│   │   ├── App.tsx             # Orquestração do inventário de dispositivos e empréstimos
│   │   └── main.tsx            # Inicialização da SPA
│   ├── package.json            # Scripts de build, ícones Lucide e Tailwind
│   └── vite.config.ts          # Configuração do bundler Vite
├── assets/                     # Galeria de diagramas vetoriais SVG autorais
├── README.md                   # Resumo executivo do projeto
└── Controle_Dispositivos_Documentacao_Final.md # Especificação acadêmica de engenharia

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

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

• US-TB01: Como analista de Help Desk, quero cadastrar novos dispositivos no inventário informando patrimônio, categoria, modelo e número de série.
• US-TB02: Como técnico de TI, quero registrar o empréstimo de um equipamento para um colaborador vinculando data prevista de devolução.
• US-TB03: Como gestor de patrimônio, quero consultar dispositivos com prazo de entrega vencido para enviar cobrança automática.
• US-TB04: Como técnico no momento da devolução, quero registrar um checklist de inspeção física assinalando o estado do ativo (Perfeito, Avariado, Sem Acessórios).
• US-TB05: Como auditor de TI, quero exportar o histórico de movimentações de um equipamento específico para comprovação de custódia.

2. Requisitos Funcionais (RF)

• RF-TB01: O sistema deve registrar ativos com número de patrimônio único e status (Disponível, Emprestado, Manutenção, Baixado).
• RF-TB02: O formulário de empréstimo deve validar se o colaborador possui pendências anteriores de devolução antes de autorizar nova saída.
• RF-TB03: A interface deve destacar visualmente ativos em atraso com badge em vermelho e contagem de dias expirados.
• RF-TB04: O processo de devolução deve exigir preenchimento de checklist de conservação e confirmação de retorno dos periféricos (fonte, cabo, mouse).
• RF-TB05: O painel deve disponibilizar busca rápida filtrando por número de patrimônio, nome do colaborador ou categoria do ativo.

3. Requisitos Não-Funcionais (RNF)

• RNF-TB01 (Integridade de Dados): Nenhum dispositivo pode ser associado a dois empréstimos simultâneos ativos.
• RNF-TB02 (Performance): A filtragem do catálogo de equipamentos deve operar em tempo real com resposta inferior a 50 milissegundos.
• RNF-TB03 (Persistência Resiliente): O estado de custódia e histórico de vistorias deve ser gravado localmente garantindo operação mesmo offline.
• RNF-TB04 (Acessibilidade Visual): As sinalizações de status devem utilizar simultaneamente cores e ícones para acessibilidade de usuários daltônicos.
• RNF-TB05 (Tipagem TypeScript): A aplicação deve assegurar 100% de cobertura de tipos estritos prevenindo erros de execução em runtime.

📐 Diagrama de Casos de Uso (Mermaid)

flowchart LR
    subgraph Atores
        Tecnico["🔧 Técnico de TI"]
        Gestor["💼 Gestor de Patrimônio"]
    end

    subgraph "Sistema TechBorrow (DeviceFlow)"
        UC01["UC01: Cadastrar Ativo de TI"]
        UC02["UC02: Registrar Empréstimo com SLA"]
        UC03["UC03: Monitorar Dispositivos em Atraso"]
        UC04["UC04: Realizar Devolução com Vistoria"]
        UC05["UC05: Auditar Histórico de Custódia"]
    end

    Tecnico --> UC01
    Tecnico --> UC02
    Tecnico --> UC04
    Gestor --> UC03
    Gestor --> UC05

📊 Matriz de Rastreabilidade de Requisitos (RTM)

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

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

cd catalogo_projetos/fullstack_pi_04_techborrow/web-react

# Instalação das dependências
npm install

# Execução em modo desenvolvimento
npm run dev

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

2. Leitura da Documentação Técnica

• Consulte o documento completo em: Controle_Dispositivos_Documentacao_Final.html para diagramas conceituais e fundamentação técnica.

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