Files
eden/packages/ui/src/components/AppShell.tsx
Matheus (Handix) eff515b70d feat(api,ui): MFA/TOTP, Inventory, Support, HR-Timeclock, Fiscal, Billing e Design System
Leva grande, pedida como "pelo menos mais 20 etapas, use subagentes":
fecha a pendência de MFA/TOTP da Fase 1 (feito diretamente, autenticação é
sensível demais para delegar) e lança 5 subagentes em paralelo em 2 ondas
(eden-inventory, eden-support, eden-hr-timeclock; depois eden-finance,
eden-fiscal, eden-frontend), cada um em worktree isolado, com integração
seletiva manual (barrel, app.module.ts, migrations renomeadas/aplicadas,
build/typecheck/teste ao vivo antes de cada merge).

## Backend

- MFA/TOTP (`apps/api/src/auth/mfa.service.ts`, `crypto/field-encryption.service.ts`):
  login em duas etapas quando `mfa_enabled=true`, `FieldEncryptionService`
  genérico (AES-256-GCM versionado, ADR-0005) reaproveitado por outros
  segredos reversíveis (ex. credencial de equipamento Control iD).
- Inventory: warehouses, stock_movements (ledger append-only), serialized_assets,
  asset_assignments, stock_reservations — invariante "serial/patrimônio/MAC
  nunca duplicado entre ativos ativos" reforçada por índices únicos parciais
  no banco (Master Prompt §15.3).
- Support/Service Desk: tickets com máquina de estados, SLA com pausa/retomada
  em `waiting_customer`/`waiting_third_party` (funções puras testáveis).
- HR-Timeclock (fundação): dispositivos Control iD (senha cifrada), import de
  AFD com parser + CRC-16/KERMIT, `afd_records` imutável sem exceção nem
  para super_admin (sem válvula de escape, diferente de audit_log).
- Fiscal: NCM/CFOP/municípios/naturezas de operação (eden.md módulo 5, MVP de
  5 das ~19 tabelas), product_fiscal_profiles com invariante de único
  profile ativo por billing_component.
- Billing: subscription→billing_run→invoice idempotente (regenerar em draft
  substitui, nunca duplica) e imutável após consolidar (ADR-0008: nunca
  confunde faturamento/documento fiscal/recebimento).
- FKs cruzadas fechadas: quotes/client_registrations/contracts.

## Frontend — primeira leva

- `packages/ui`: Design System real extraído do tema DreamsERP comprado —
  achado que mudou o escopo: o tema já vem em React+Tailwind (não só
  Angular), tokens visuais reais portados (cores, Geist como fonte real,
  divergindo da doc antiga que citava Nunito/Poppins).
- `apps/core-web`: login real (com suporte a MFA), sessão, shell autenticado
  via `AppShell` — substitui a tela estática "Bootstrap da Fase 1".

## Bugs reais encontrados e corrigidos (todos via teste ao vivo, não leitura)

1. **Segurança**: o token de desafio MFA era aceito como access token normal
   pelo `JwtAuthGuard` (mesma assinatura, nenhuma checagem da claim
   `purpose`) — bypass total do segundo fator. Explorado e fechado ao vivo
   contra o container real; teste de regressão em `test/mfa.spec.ts`.
2. Crase solta dentro de comentário SQL na migration de hr-timeclock quebrava
   o template literal JS (`SyntaxError` ao rodar a migration).
3. CORS ausente por completo na API.
4. `turbo.json` não declarava `VITE_API_BASE_URL` como input de build — o
   Turborepo cacheava o bundle do frontend ignorando mudança na env var.
5. `compose.yaml` usava `${VITE_API_BASE_URL:-/api/v1}`, que colidia com a
   variável de mesmo nome do `.env` local — o default nunca era aplicado.
6. Não existia `.dockerignore` — todo build copiava node_modules/.git/
   worktrees de subagentes (665MB) para dentro do contexto Docker.

Decisão do operador incorporada: a API nunca tem domínio público próprio
(só IP interno) — os 3 frontends chamam por caminho relativo `/api/v1`,
proxy externo roteia same-origin; CORS só é relevante para dev local.

Verificado: `pnpm turbo run typecheck build` (28/28), `pnpm --filter
@eden/api test` (30/30, cresceu de 15), todo o lote testado ao vivo via
curl contra os containers reais reconstruídos, incluindo os 6 bugs acima
já fechados e confirmados, e a trilha de auditoria conferida no Postgres.

Claude-Session: https://claude.ai/code/session_01BcWWuKfykGtUweXmHD6cKx

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-03 17:25:31 -03:00

121 lines
4.2 KiB
TypeScript

import type { ComponentType, ReactNode } from "react";
import { cn } from "../utils/cn.js";
export interface AppShellNavItem {
key: string;
label: string;
href: string;
icon?: ReactNode;
active?: boolean;
}
interface NavLinkRenderProps {
href: string;
className?: string;
children: ReactNode;
}
export interface AppShellProps {
/** e.g. "EDEN Core" — shown next to the logo and used as the img alt text. */
appName: string;
logoSrc?: string;
navItems: AppShellNavItem[];
userName?: string;
userRole?: string;
onLogout?: () => void;
children: ReactNode;
/**
* Router-agnostic navigation: packages/ui doesn't depend on react-router.
* Defaults to a plain `<a>` (full page reload); pass e.g.
* `({ href, className, children }) => <Link to={href} className={className}>{children}</Link>`
* from the consuming app to get client-side routing.
*/
LinkComponent?: ComponentType<NavLinkRenderProps>;
}
function DefaultLink({ href, className, children }: NavLinkRenderProps) {
return (
<a href={href} className={className}>
{children}
</a>
);
}
/**
* Visually inspired by the DreamsERP theme's sidebar/topbar
* (react/src/components/common-sidebar, common-header) — sidebar with
* logo + dark active nav item, white topbar with a bordered bottom edge —
* without importing any of the theme's Redux/routing code.
*/
export function AppShell({
appName,
logoSrc,
navItems,
userName,
userRole,
onLogout,
children,
LinkComponent = DefaultLink,
}: AppShellProps) {
return (
<div className="flex min-h-screen bg-light">
<aside className="hidden w-sidebar shrink-0 flex-col border-r border-border-color bg-white lg:flex">
<div className="flex h-topbar items-center gap-2 border-b border-border-color px-4">
{logoSrc ? <img src={logoSrc} alt={appName} className="h-7 w-auto" /> : null}
<span className="text-sm font-bold text-title">{appName}</span>
</div>
<nav className="flex flex-1 flex-col gap-1 overflow-y-auto p-3" aria-label="Navegação principal">
{navItems.map((item) => (
<LinkComponent
key={item.key}
href={item.href}
className={cn(
"flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium transition-colors duration-150",
item.active
? "bg-dark text-white"
: "text-gray-900 hover:bg-light-700 hover:text-primary",
)}
>
{item.icon}
<span>{item.label}</span>
</LinkComponent>
))}
</nav>
</aside>
<div className="flex min-w-0 flex-1 flex-col">
<header className="flex h-topbar items-center justify-between gap-3 border-b border-border-color bg-white px-4">
<div className="flex items-center gap-2 lg:hidden">
{logoSrc ? <img src={logoSrc} alt={appName} className="h-6 w-auto" /> : null}
<span className="text-sm font-bold text-title">{appName}</span>
</div>
<div className="ms-auto flex items-center gap-3">
{userName ? (
<div className="flex items-center gap-2 rounded-md border border-border-color px-2 py-1">
<span className="flex size-7 items-center justify-center rounded-full bg-dark text-xs font-semibold text-white">
{userName.charAt(0).toUpperCase()}
</span>
<div className="hidden text-left leading-tight sm:block">
<p className="text-xs font-semibold text-title">{userName}</p>
{userRole ? <p className="text-[11px] text-default">{userRole}</p> : null}
</div>
</div>
) : null}
{onLogout ? (
<button
type="button"
onClick={onLogout}
className="rounded-md border border-border-color px-3 py-1.5 text-xs font-semibold text-default hover:bg-light hover:text-danger"
>
Sair
</button>
) : null}
</div>
</header>
<main className="flex-1 p-6">{children}</main>
</div>
</div>
);
}