PopinaFlow — Stack Tecnológico & Referências de Documentação

Documento-índice com links para a documentação oficial de todas as tecnologias, bibliotecas e integrações usadas no PopinaFlow. Versões refletem os package.json de backend/, frontend-react/ e electron/ em 2026-06-29. Mantenha sincronizado ao adicionar/remover dependências.

---

1. Plataforma & Runtime

Tecnologia	Versão	Documentação
Node.js	22 (alpine)	https://nodejs.org/docs/latest-v22.x/api/
TypeScript	^5.7.3	https://www.typescriptlang.org/docs/
MongoDB	7.0.x	https://www.mongodb.com/docs/manual/
Redis	— (ioredis)	https://redis.io/docs/latest/
Docker / Compose	—	https://docs.docker.com/ · https://docs.docker.com/compose/
Nginx (host TLS)	—	https://nginx.org/en/docs/

---

2. Backend — NestJS (backend/)

Framework core

Pacote	Versão	Documentação
@nestjs/core · @nestjs/common	^11.0.1	https://docs.nestjs.com/
@nestjs/platform-express	^11.0.1	https://docs.nestjs.com/techniques/performance
@nestjs/config	^4.0.3	https://docs.nestjs.com/techniques/configuration
@nestjs/schedule	^6.1.1	https://docs.nestjs.com/techniques/task-scheduling
@nestjs/swagger	^11.3.0	https://docs.nestjs.com/openapi/introduction
@nestjs/throttler	^6.5.0	https://docs.nestjs.com/security/rate-limiting
@nestjs/axios	^4.0.1	https://docs.nestjs.com/techniques/http-module
reflect-metadata	^0.2.2	https://github.com/rbuckton/reflect-metadata
rxjs	^7.8.1	https://rxjs.dev/guide/overview

Banco de dados & cache

Pacote	Versão	Documentação
mongoose	^9.2.1	https://mongoosejs.com/docs/
@nestjs/mongoose	^11.0.4	https://docs.nestjs.com/techniques/mongodb
ioredis	^5.10.1	https://github.com/redis/ioredis
mongodb-memory-server	^11.0.1	https://github.com/typegoose/mongodb-memory-server

Auth & segurança

Pacote	Versão	Documentação
@nestjs/jwt	^11.0.2	https://docs.nestjs.com/security/authentication
@nestjs/passport · passport	^11.0.5 / ^0.7.0	https://docs.nestjs.com/recipes/passport · https://www.passportjs.org/docs/
passport-jwt	^4.0.1	https://github.com/mikenicholson/passport-jwt
jwks-rsa	^4.0.1	https://github.com/auth0/node-jwks-rsa
google-auth-library	^10.6.1	https://github.com/googleapis/google-auth-library-nodejs
bcrypt / bcryptjs	^6.0.0 / ^3.0.3	https://github.com/kelektiv/node.bcrypt.js
otplib	^13.4.0	https://github.com/yeojz/otplib
helmet	^8.1.0	https://helmetjs.github.io/
cookie-parser	^1.4.7	https://github.com/expressjs/cookie-parser
class-validator	^0.14.3	https://github.com/typestack/class-validator
class-transformer	^0.5.1	https://github.com/typestack/class-transformer

Filas, WebSocket & realtime

Pacote	Versão	Documentação
bullmq	^5.71.0	https://docs.bullmq.io/
@nestjs/bullmq	^11.0.4	https://docs.nestjs.com/techniques/queues
socket.io	^4.8.3	https://socket.io/docs/v4/
@nestjs/platform-socket.io · @nestjs/websockets	^11.1.x	https://docs.nestjs.com/websockets/gateways
@socket.io/redis-adapter	^8.3.0	https://socket.io/docs/v4/redis-adapter/

Fiscal (NF-e/NFC-e/NFS-e — SEFAZ direto)

Pacote / Recurso	Versão	Documentação
xml-crypto	^6.1.2	https://github.com/node-saml/xml-crypto
node-forge (cert A1)	^1.3.3	https://github.com/digitalbazaar/forge
xml2js	^0.6.2	https://github.com/Leonidas-from-XIV/node-xml2js
nfewizard-io	1.0.2	https://github.com/Maemusk/NFeWizard-io
Portal Nacional NF-e	—	https://www.nfe.fazenda.gov.br/portal/principal.aspx
NFS-e Nacional (ADN gov.br)	—	https://www.gov.br/nfse/pt-br
Reforma Tributária (IBS/CBS — LC 214)	—	https://www.gov.br/receitafederal/pt-br

Pagamentos

Pacote / Gateway	Versão	Documentação
stripe	^22.1.0	https://docs.stripe.com/api?lang=node
Stone	—	https://docs.stone.com.br/
Rede (e.Rede)	—	https://developer.userede.com.br/e-rede
Mercado Pago	—	https://www.mercadopago.com.br/developers/pt/docs

Observabilidade & logging

Pacote	Versão	Documentação
@sentry/node · @sentry/profiling-node	^10.53.1	https://docs.sentry.io/platforms/javascript/guides/node/
@opentelemetry/sdk-node (+ auto-instr.)	^0.219.0	https://opentelemetry.io/docs/languages/js/
nestjs-pino · pino-http · pino-pretty	^4.6.1	https://github.com/iamolegga/nestjs-pino · https://getpino.io/
prom-client	^15.1.3	https://github.com/siimon/prom-client

Arquivos, mídia & documentos

Pacote	Versão	Documentação
@aws-sdk/client-s3 · s3-request-presigner	^3.996.0	https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3/
sharp	^0.34.5	https://sharp.pixelplumbing.com/
multer	^2.1.0	https://github.com/expressjs/multer
pdfmake	^0.3.7	https://pdfmake.github.io/docs/
pdf-to-png-converter	^4.1.0	https://github.com/dichovsky/pdf-to-png-converter
puppeteer	^24.41.0	https://pptr.dev/
exceljs	^4.4.0	https://github.com/exceljs/exceljs
papaparse	^5.4.1	https://www.papaparse.com/docs
qrcode	^1.5.4	https://github.com/soldair/node-qrcode
archiver	^7.0.1	https://www.archiverjs.com/
ofx-js	^0.2.0	https://github.com/euforic/ofx-js

Notificações & comunicação

Pacote / Serviço	Versão	Documentação
web-push	^3.6.7	https://github.com/web-push-libs/web-push
nodemailer	^8.0.2	https://nodemailer.com/about/
Evolution API (WhatsApp)	—	https://doc.evolution-api.com/
iFood (delivery webhooks)	—	https://developer.ifood.com.br/pt-BR/docs/guides

IA

Pacote / Serviço	Versão	Documentação
@anthropic-ai/sdk	^0.95.2	https://docs.claude.com/en/api/ · https://docs.claude.com/en/docs/build-with-claude/tool-use

Utilitários

Pacote	Versão	Documentação
compression	^1.8.1	https://github.com/expressjs/compression
ua-parser-js	^1.0.41	https://github.com/faisalman/ua-parser-js

Ferramentas de teste & build (backend)

Pacote	Versão	Documentação
jest · ts-jest	^30.0.0	https://jestjs.io/docs/getting-started
supertest	^7.0.0	https://github.com/ladjs/supertest
autocannon	^8.0.0	https://github.com/mcollina/autocannon
@nestjs/cli	^11.0.0	https://docs.nestjs.com/cli/overview
eslint · typescript-eslint	^9.18.0	https://eslint.org/docs/latest/ · https://typescript-eslint.io/
prettier	^3.8.3	https://prettier.io/docs/

---

3. Frontend — React + Vite (frontend-react/)

Core

Pacote	Versão	Documentação
react · react-dom	^18.3.1	https://react.dev/
vite	^7.3.1	https://vite.dev/guide/
@vitejs/plugin-react	^4.7.0	https://github.com/vitejs/vite-plugin-react
typescript	^5.7.3	https://www.typescriptlang.org/docs/
react-router-dom	^6.26.0	https://reactrouter.com/en/main

Estado & dados

Pacote	Versão	Documentação
zustand	^4.5.4	https://zustand.docs.pmnd.rs/
@tanstack/react-query	^5.99.0	https://tanstack.com/query/latest/docs/framework/react/overview
axios	^1.8.2	https://axios-http.com/docs/intro
idb	^8.0.3	https://github.com/jakearchibald/idb
fuse.js	^7.1.0	https://www.fusejs.io/

Estilo & UI

Pacote	Versão	Documentação
tailwindcss · @tailwindcss/vite	^4.2.x	https://tailwindcss.com/docs
framer-motion	^12.38.0	https://motion.dev/docs/react
lucide-react	^0.577.0	https://lucide.dev/guide/packages/lucide-react
recharts	^3.8.1	https://recharts.org/en-US/
konva · react-konva	^10 / ^18	https://konvajs.org/docs/react/
react-day-picker	^9.14.0	https://daypicker.dev/
react-joyride (tours)	^2.9.3	https://docs.react-joyride.com/
react-swipeable	^7.0.2	https://github.com/FormidableLabs/react-swipeable
react-markdown	^10.1.0	https://github.com/remarkjs/react-markdown
react-qr-code	^2.0.18	https://github.com/rosskhanas/react-qr-code

i18n, SEO & realtime

Pacote	Versão	Documentação
i18next · react-i18next	^23 / ^14	https://www.i18next.com/ · https://react.i18next.com/
react-helmet-async	^3.0.0	https://github.com/staylor/react-helmet-async
date-fns	^4.1.0	https://date-fns.org/docs/Getting-Started
socket.io-client	^4.8.3	https://socket.io/docs/v4/client-api/

Mapas, pagamentos & auth (frontend)

Pacote / Serviço	Versão	Documentação
mapbox-gl	^3.21.0	https://docs.mapbox.com/mapbox-gl-js/guides/
@mercadopago/sdk-react	^1.0.7	https://www.mercadopago.com.br/developers/pt/docs/sdks-library/client-side/sdk-js-react
@react-oauth/google	^0.13.4	https://github.com/MomenSherif/react-oauth

PWA & observabilidade (frontend)

Pacote	Versão	Documentação
vite-plugin-pwa · workbox-window	^1.2.0 / ^7.4.0	https://vite-pwa-org.netlify.app/ · https://developer.chrome.com/docs/workbox
@sentry/react · @sentry/vite-plugin	^10.53.1	https://docs.sentry.io/platforms/javascript/guides/react/

Mobile (Capacitor)

Pacote	Versão	Documentação
@capacitor/core · cli · android · ios	^6 / ^8	https://capacitorjs.com/docs

Teste & build (frontend)

Pacote	Versão	Documentação
vitest · @vitest/ui	^4.1.4	https://vitest.dev/guide/
@testing-library/react · jest-dom · user-event	^16 / ^6 / ^14	https://testing-library.com/docs/react-testing-library/intro/
@playwright/test	^1.60.0	https://playwright.dev/docs/intro
msw	^2.13.4	https://mswjs.io/docs/
happy-dom	^20.8.9	https://github.com/capricorn86/happy-dom
esbuild	0.25.12	https://esbuild.github.io/

---

4. Desktop — Electron (electron/)

Pacote	Versão	Documentação
electron	^41.6.0	https://www.electronjs.org/docs/latest/
electron-builder	^26.0.0	https://www.electron.build/
@electron/rebuild	^4.0.4	https://github.com/electron/rebuild
electron-updater	^6.8.3	https://www.electron.build/auto-update
electron-log	^5.4.4	https://github.com/megahertz/electron-log
electron-serve	^1.3.0	https://github.com/sindresorhus/electron-serve
electron-window-state	^5.0.3	https://github.com/mawie81/electron-window-state
serialport (impressão ESC/POS)	^12.0.0	https://serialport.io/docs/
http-proxy	^1.18.1	https://github.com/http-party/node-http-proxy

---

5. Integrações externas (resumo)

Domínio	Serviço	Documentação
Fiscal	SEFAZ (NF-e/NFC-e)	https://www.nfe.fazenda.gov.br/portal/principal.aspx
Fiscal	NFS-e Nacional (gov.br)	https://www.gov.br/nfse/pt-br
Pagamento	Stone	https://docs.stone.com.br/
Pagamento	Rede	https://developer.userede.com.br/e-rede
Pagamento	Mercado Pago	https://www.mercadopago.com.br/developers/pt/docs
Pagamento	Stripe	https://docs.stripe.com/
Delivery	iFood	https://developer.ifood.com.br/pt-BR/docs/guides
Mensageria	Evolution API (WhatsApp)	https://doc.evolution-api.com/
Mapas	Mapbox	https://docs.mapbox.com/
Auth	Google OAuth	https://developers.google.com/identity/protocols/oauth2
IA	Anthropic Claude	https://docs.claude.com/
Armazenamento	AWS S3	https://docs.aws.amazon.com/s3/

---

Como manter: ao rodar npm install <pkg> em qualquer workspace, adicione a linha correspondente na seção certa com o link da doc oficial. Versões aqui são as faixas declaradas no package.json — para a versão exata instalada, consulte o package-lock.json.