+
+
Factory Id
+
+ Geradores e validadores de dados portugueses para testes de software.
+
- {/* Separador */}
-
-
- {/* Copyright */}
-
- © {year} FactoryiD. Todos os direitos reservados.
+
+
+
+
Aviso
+
+ Todos os dados são fictÃcios e gerados aleatoriamente. Destinam-se exclusivamente a testes;
+ qualquer coincidência com dados reais é acidental.
+
+
+
+
+ © {year} Factory Id
);
diff --git a/geradoresfe/src/layout/Header.tsx b/geradoresfe/src/layout/Header.tsx
index 2aeb0d9..df03c4b 100644
--- a/geradoresfe/src/layout/Header.tsx
+++ b/geradoresfe/src/layout/Header.tsx
@@ -1,172 +1,105 @@
import { useEffect, useState } from "react";
-import { Link, NavLink, useLocation } from "react-router";
-import { Disclosure, Menu, Transition } from "@headlessui/react";
-import { Bars3Icon, XMarkIcon, ChevronDownIcon } from "@heroicons/react/24/outline";
+import { Link, NavLink } from "react-router";
+import {
+ Disclosure, DisclosureButton, DisclosurePanel, Menu, MenuButton, MenuItem, MenuItems,
+} from "@headlessui/react";
+import { ChevronDownIcon, MenuIcon, XIcon } from "lucide-react";
import Logo from "../assets/logotipo32x32.png";
import { DarkModeToggle } from "../components/ui/DarkModeToggle";
+import { useGenerators } from "../lib/useGenerators";
+import { docsUrl } from "../lib/api";
-const navItems = [
- { name: "InÃcio", path: "/" },
- {
- name: "Geradores",
- subItems: [
- { name: "Gerador de NIFs", path: "/NIF", },
- { name: "Gerador de NISS", path: "/NISS" },
- { name: "Gerador de CC", path: "/CC" },
- ],
- },
- { name: "Contacto", path: "/contacto" },
-];
+const linkClass = ({ isActive }: { isActive: boolean }) =>
+ `rounded-md px-3 py-2 text-sm font-medium transition-colors ${isActive
+ ? "text-blue-600 dark:text-blue-400"
+ : "text-gray-700 hover:text-blue-600 dark:text-gray-300 dark:hover:text-blue-400"}`;
-function Header() {
- const location = useLocation();
- const [isScrolled, setIsScrolled] = useState(false);
+export default function Header() {
+ const { byCategory } = useGenerators();
+ const [isScrolled, setIsScrolled] = useState(false);
- useEffect(() => {
- const onScroll = () => setIsScrolled(window.scrollY > 10);
- window.addEventListener("scroll", onScroll);
- return () => window.removeEventListener("scroll", onScroll);
- }, []);
+ useEffect(() => {
+ const onScroll = () => setIsScrolled(window.scrollY > 10);
+ window.addEventListener("scroll", onScroll, { passive: true });
+ return () => window.removeEventListener("scroll", onScroll);
+ }, []);
- const navLinkClass = (isActive: boolean) =>
- `px-3 py-2 rounded-md text-sm font-medium transition ${isActive
- ? "text-blue-600 font-semibold"
- : "text-gray-700 hover:text-blue-500 dark:text-gray-300 dark:hover:text-blue-400"
- }`;
-
- return (
-
- {({ open }) => (
-
+ );
+}
diff --git a/geradoresfe/src/layout/Layout.tsx b/geradoresfe/src/layout/Layout.tsx
index b6c8eae..394f8c3 100644
--- a/geradoresfe/src/layout/Layout.tsx
+++ b/geradoresfe/src/layout/Layout.tsx
@@ -1,16 +1,13 @@
-// components/layout/Layout.tsx
-import Footer from './Footer';
-import Header from './Header';
-
-export const Layout = ({ children }: { children: React.ReactNode }) => {
+import type { ReactNode } from "react";
+import Footer from "./Footer";
+import Header from "./Header";
+export function Layout({ children }: { children: ReactNode }) {
return (
-
-
-
- {children}
-
+
+
+ {children}
);
-};
+}
diff --git a/geradoresfe/src/lib/api.ts b/geradoresfe/src/lib/api.ts
new file mode 100644
index 0000000..5a2e784
--- /dev/null
+++ b/geradoresfe/src/lib/api.ts
@@ -0,0 +1,84 @@
+// Cliente da API. Por omissão usa caminhos relativos (/api/v1): em dev o Vite faz proxy,
+// em produção o nginx encaminha /api para o backend. VITE_API_URL permite apontar para outro host.
+const BASE = `${(import.meta.env.VITE_API_URL ?? "").replace(/\/$/, "")}/api/v1`;
+
+export type OptionChoice = { value: string; label: string };
+
+export type GeneratorOption = {
+ key: string;
+ label: string;
+ choices: OptionChoice[];
+ defaultValue: string;
+};
+
+export type Generator = {
+ id: string;
+ name: string;
+ category: string;
+ description: string;
+ hasChecksum: boolean;
+ canValidate: boolean;
+ options: GeneratorOption[];
+};
+
+export type GeneratedItem = {
+ value: string;
+ fields?: Record
| null;
+};
+
+export type ValidationResult = {
+ isValid: boolean;
+ formatMatch: boolean;
+ message: string;
+ normalized?: string | null;
+ details?: string[] | null;
+};
+
+export type DetectMatch = {
+ generatorId: string;
+ generatorName: string;
+ result: ValidationResult;
+};
+
+export class ApiError extends Error {}
+
+async function get(path: string, params?: Record): Promise {
+ const query = new URLSearchParams();
+ for (const [k, v] of Object.entries(params ?? {}))
+ if (v !== undefined && v !== "") query.set(k, String(v));
+ const qs = query.toString();
+
+ let response: Response;
+ try {
+ response = await fetch(`${BASE}${path}${qs ? `?${qs}` : ""}`);
+ } catch {
+ throw new ApiError("Não foi possÃvel contactar o servidor.");
+ }
+
+ if (!response.ok) {
+ const problem = await response.json().catch(() => null);
+ const firstError = problem?.errors ? Object.values(problem.errors).flat()[0] : null;
+ throw new ApiError(String(firstError ?? problem?.title ?? `Erro ${response.status}`));
+ }
+ return response.json() as Promise;
+}
+
+export const api = {
+ listGenerators: () => get("/generators"),
+
+ generate: (id: string, options: Record, count = 1) =>
+ get<{ generator: string; items: GeneratedItem[] }>(`/generators/${encodeURIComponent(id)}/generate`, { ...options, count })
+ .then((r) => r.items),
+
+ validate: (id: string, value: string) =>
+ get(`/generators/${encodeURIComponent(id)}/validate`, { value }),
+
+ detect: (value: string) =>
+ get<{ value: string; matches: DetectMatch[] }>("/validate", { value }).then((r) => r.matches),
+};
+
+export function defaultOptions(generator: Generator): Record {
+ return Object.fromEntries(generator.options.map((o) => [o.key, o.defaultValue]));
+}
+
+export const docsUrl =`${(import.meta.env.VITE_API_URL ?? "").replace(/\/$/, "")}/docs`;
diff --git a/geradoresfe/src/lib/clipboard.ts b/geradoresfe/src/lib/clipboard.ts
new file mode 100644
index 0000000..bbef268
--- /dev/null
+++ b/geradoresfe/src/lib/clipboard.ts
@@ -0,0 +1,10 @@
+import { toast } from "react-hot-toast";
+
+export async function copyToClipboard(text: string, label = "Valor") {
+ try {
+ await navigator.clipboard.writeText(text);
+ toast.success(`${label} copiado!`, { duration: 1500 });
+ } catch {
+ toast.error("Não foi possÃvel copiar para a área de transferência.");
+ }
+}
diff --git a/geradoresfe/src/lib/export.test.ts b/geradoresfe/src/lib/export.test.ts
new file mode 100644
index 0000000..ede882c
--- /dev/null
+++ b/geradoresfe/src/lib/export.test.ts
@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { columnsOf, toCsv, toJson, toText } from "./export";
+
+const simple = [{ value: "123456789" }, { value: "500000000" }];
+const composite = [
+ { value: "Ana Silva", fields: { Nome: "Ana Silva", Morada: 'Rua "A"; 1' } },
+ { value: "Rui Costa", fields: { Nome: "Rui Costa", Morada: "Rua B" } },
+];
+
+describe("export", () => {
+ it("usa a coluna Valor para geradores simples", () => {
+ expect(columnsOf(simple)).toEqual(["Valor"]);
+ });
+
+ it("usa os campos como colunas para geradores compostos", () => {
+ expect(columnsOf(composite)).toEqual(["Nome", "Morada"]);
+ });
+
+ it("gera CSV com BOM, ';' e aspas escapadas", () => {
+ const csv = toCsv(composite);
+ expect(csv.startsWith("")).toBe(true);
+ expect(csv).toBe('Nome;Morada\r\nAna Silva;"Rua ""A""; 1"\r\nRui Costa;Rua B');
+ });
+
+ it("gera JSON com valores ou objectos", () => {
+ expect(JSON.parse(toJson(simple))).toEqual(["123456789", "500000000"]);
+ expect(JSON.parse(toJson(composite))[1]).toEqual({ Nome: "Rui Costa", Morada: "Rua B" });
+ });
+
+ it("gera texto com um valor por linha", () => {
+ expect(toText(simple)).toBe("123456789\n500000000");
+ });
+});
diff --git a/geradoresfe/src/lib/export.ts b/geradoresfe/src/lib/export.ts
new file mode 100644
index 0000000..0a98239
--- /dev/null
+++ b/geradoresfe/src/lib/export.ts
@@ -0,0 +1,40 @@
+import type { GeneratedItem } from "./api";
+
+/** Colunas da tabela/exportação: "Valor" para geradores simples, ou os campos dos compostos. */
+export function columnsOf(items: GeneratedItem[]): string[] {
+ const first = items.find((i) => i.fields);
+ return first?.fields ? Object.keys(first.fields) : ["Valor"];
+}
+
+export function rowOf(item: GeneratedItem, columns: string[]): string[] {
+ return item.fields ? columns.map((c) => item.fields?.[c] ?? "") : [item.value];
+}
+
+function csvCell(value: string): string {
+ return /[";\n\r]/.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
+}
+
+/** CSV com separador ";" (o Excel em PT usa ";") e BOM para os acentos abrirem bem. */
+export function toCsv(items: GeneratedItem[]): string {
+ const columns = columnsOf(items);
+ const lines = [columns, ...items.map((i) => rowOf(i, columns))].map((row) => row.map(csvCell).join(";"));
+ return "" + lines.join("\r\n");
+}
+
+export function toJson(items: GeneratedItem[]): string {
+ const data = items.map((i) => i.fields ?? i.value);
+ return JSON.stringify(data, null, 2);
+}
+
+export function toText(items: GeneratedItem[]): string {
+ return items.map((i) => i.value).join("\n");
+}
+
+export function download(content: string, filename: string, mime: string) {
+ const url = URL.createObjectURL(new Blob([content], { type: mime }));
+ const a = document.createElement("a");
+ a.href = url;
+ a.download = filename;
+ a.click();
+ URL.revokeObjectURL(url);
+}
diff --git a/geradoresfe/src/lib/slug.ts b/geradoresfe/src/lib/slug.ts
new file mode 100644
index 0000000..5329df9
--- /dev/null
+++ b/geradoresfe/src/lib/slug.ts
@@ -0,0 +1,8 @@
+export function slugify(text: string) {
+ return text
+ .normalize("NFD")
+ .replace(/[̀-ͯ]/g, "")
+ .toLowerCase()
+ .replace(/[^a-z0-9]+/g, "-")
+ .replace(/^-|-$/g, "");
+}
diff --git a/geradoresfe/src/lib/useGenerators.tsx b/geradoresfe/src/lib/useGenerators.tsx
new file mode 100644
index 0000000..0828ad2
--- /dev/null
+++ b/geradoresfe/src/lib/useGenerators.tsx
@@ -0,0 +1,47 @@
+import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from "react";
+import { api, type Generator } from "./api";
+
+type GeneratorsState = {
+ generators: Generator[];
+ loading: boolean;
+ error: string | null;
+ byCategory: [string, Generator[]][];
+ find: (id: string) => Generator | undefined;
+};
+
+const GeneratorsContext = createContext(undefined);
+
+/** Carrega a lista de geradores uma vez; toda a UI é construÃda a partir destes metadados. */
+export function GeneratorsProvider({ children }: { children: ReactNode }) {
+ const [generators, setGenerators] = useState([]);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ useEffect(() => {
+ api.listGenerators()
+ .then(setGenerators)
+ .catch((e: Error) => setError(e.message))
+ .finally(() => setLoading(false));
+ }, []);
+
+ const value = useMemo(() => {
+ const groups = new Map();
+ for (const g of generators) groups.set(g.category, [...(groups.get(g.category) ?? []), g]);
+ return {
+ generators,
+ loading,
+ error,
+ byCategory: [...groups.entries()],
+ find: (id) => generators.find((g) => g.id.toLowerCase() === id.toLowerCase()),
+ };
+ }, [generators, loading, error]);
+
+ return {children};
+}
+
+// eslint-disable-next-line react-refresh/only-export-components
+export function useGenerators() {
+ const ctx = useContext(GeneratorsContext);
+ if (!ctx) throw new Error("useGenerators tem de estar dentro de GeneratorsProvider");
+ return ctx;
+}
diff --git a/geradoresfe/src/lib/useTitle.ts b/geradoresfe/src/lib/useTitle.ts
new file mode 100644
index 0000000..a13ad4b
--- /dev/null
+++ b/geradoresfe/src/lib/useTitle.ts
@@ -0,0 +1,7 @@
+import { useEffect } from "react";
+
+export function useTitle(title?: string) {
+ useEffect(() => {
+ document.title = title ? `${title} · Factory Id` : "Factory Id — Geradores e validadores";
+ }, [title]);
+}
diff --git a/geradoresfe/src/library/utils.tsx b/geradoresfe/src/library/utils.tsx
deleted file mode 100644
index b3a9a43..0000000
--- a/geradoresfe/src/library/utils.tsx
+++ /dev/null
@@ -1,25 +0,0 @@
-
-const Utils = {
- EnumToOptions,
- // Outras fun��es podem ser adicionadas aqui
-};
-
-export function EnumToOptions>(enumObj: T): any[] {
- return Object.entries(enumObj)
- .filter(([key]) => isNaN(Number(key))) // Ignora entradas num�ricas, caso existam
- .map(([key, value]) => ({
- value: key, // A chave do enum como `value`
- label: value, // O valor do enum como `label`
- }));
-}
-
-export function getEnumKeyByValue>(
- enumObj: T,
- value: string
-): string | undefined {
- return Object.keys(enumObj).find((key) => enumObj[key as keyof T] === value);
-}
-
-
-
-export default Utils;
\ No newline at end of file
diff --git a/geradoresfe/src/main.tsx b/geradoresfe/src/main.tsx
index 468d7d3..07ff6bd 100644
--- a/geradoresfe/src/main.tsx
+++ b/geradoresfe/src/main.tsx
@@ -1,13 +1,13 @@
-import { StrictMode } from 'react'
-import { createRoot } from 'react-dom/client'
-import './index.css'
-import App from './App.tsx'
-import { ThemeProvider } from './context/ThemeContext.tsx'
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import "./index.css";
+import App from "./App.tsx";
+import { ThemeProvider } from "./context/ThemeContext.tsx";
-createRoot(document.getElementById('root')!).render(
+createRoot(document.getElementById("root")!).render(
,
-)
+);
diff --git a/geradoresfe/src/pages/Blank.tsx b/geradoresfe/src/pages/Blank.tsx
deleted file mode 100644
index f084490..0000000
--- a/geradoresfe/src/pages/Blank.tsx
+++ /dev/null
@@ -1,20 +0,0 @@
-export default function Blank() {
- console.log("inicalizar componente");
- return (
-
-
-
-
-
- Card Title Here
-
-
-
- Start putting content on grids or panels, you can also use different
- combinations of grids.Please check out the dashboard and other pages
-
-
-
-
-
- {/* Seção de Funcionalidades */}
-
-
-
+
+
Todos os geradores
+
+
{generator && }
+
+
+
+
+ {items.length === 0 ? (
+
+
+
Escolha as opções e carregue em Gerar.
+
+
+
+
+ {items.length} {items.length === 1 ? "valor gerado" : "valores gerados"}
+
+
+
}>CSV
+
}>JSON
+
}>TXT
+
} aria-label="Limpar" title="Limpar" />
+
+
+
+
+
+
+ | # |
+ {columns.map((c) => (
+ {c} |
+ ))}
+ Copiar |
+
+
+
+ {items.map((item, i) => (
+
+ | {i + 1} |
+ {rowOf(item, columns).map((cell, j) => (
+ {cell} |
+ ))}
+
+
+ |
+
+ ))}
+
+
+
+
-
- {/* Seção de Funcionalidades */}
-
-
-
+
+
+ Dados portugueses válidos para testes
+
+
+ Gere e valide NIF, NISS, Cartão de Cidadão, IBAN, cartões, matrÃculas e muito mais — um a um ou aos milhares.
+
+
+
+
+
+
+
+ {byCategory.map(([category, generators]) => (
+
+ {category}
+
+ {generators.map((g) => (
+
+ ))}
+
+
+ ))}
+
+
-
- {/* Seção de Funcionalidades */}
-
-
-
-
- {/* Seção de Funcionalidades */}
-
-
-
+
404
+
Página não encontrada
+
O endereço que procura não existe.
+
+ Voltar ao inÃcio
+
+
+
Validador
+
+ Cole qualquer valor: identificamos o tipo automaticamente e explicamos se é válido — e, se não for, porquê.
+
+
+
+
+ {supported.length > 0 && (
+
Tipos suportados: {supported.join(", ")}.
+ )}
+