Documentação Técnica
Arquitetura, entidades, fluxos e guias de desenvolvimento do sistema JoiaWallet
Arquitetura do Sistema
JoiaWallet é um sistema operacional de ativos de joias que funciona como uma camada de autenticidade e proveniência para o mercado de joalharia.
Backend
Base44 Platform com autenticação, base de dados PostgreSQL e integrações
Frontend
React + Tailwind CSS com componentes Shadcn/UI e animações Framer Motion
Segurança
Hashing bcrypt, tokens únicos, RLS PostgreSQL e validação em tempo real
Stack Tecnológico
Frontend
- • React 18 com Hooks
- • React Router para navegação
- • TanStack Query para gestão de estado
- • Tailwind CSS para estilos
- • Shadcn/UI componentes
- • Framer Motion para animações
- • QR Code Scanner (Yudiel)
- • jsPDF para geração de PDFs
Backend & Integrações
- • Base44 SDK (autenticação, DB)
- • PostgreSQL com RLS
- • Resend para emails
- • Stripe para pagamentos (escrow)
- • Bcrypt para hashing
- • QR Code generation
- • Canvas Confetti para UX
Tipos de Utilizadores
Consumidores
Proprietários de joias com acesso ao cofre digital, reivindicação de certificados, transferências e seguros.
- Cofre Digital
- Reivindicação via QR/Magic Link
- Histórico de Propriedade
- Transferências
- Conquistas
Joalharias Parceiras
Emissores de certificados com portal completo para gestão de marcas, produtos, certificados e equipa.
- Emissão de Certificados
- Gestão de Marcas/Produtos
- Impressão de QR/Códigos
- Marketplace
- Gestão de Equipa
Administradores
Gestão global do sistema, aprovação de parceiros, monitorização de certificados e auditoria.
- Aprovação de Joalharias
- Gestão de Certificados
- Auditoria Completa
- Análise de Métricas
