PixieLog Sync Service

Serviço de sincronização de plataformas de jogos (PSN e Nintendo Switch Online) via contas de serviço (bots).

Arquitetura

Este serviço implementa uma arquitetura de "service accounts" para integração com plataformas fechadas:

1. PSN (PlayStation Network): Usa NPSSO token para autenticação de conta bot
2. Nintendo Switch Online: Usa Friend Code + verificação via nickname

Requisitos

• Node.js >= 20.0.0
• Redis >= 7.0
• npm >= 10.0.0

Instalação

# Usar a versão correta do Node.js (via nvm)
nvm use

# Instalar dependências
npm install

# Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com suas configurações

# Executar em desenvolvimento
npm run dev

# Executar testes
npm test

# Build para produção
npm run build
npm start

Scripts Disponíveis

• npm run dev - Executar em modo desenvolvimento com hot-reload
• npm run build - Compilar TypeScript
• npm start - Iniciar em modo produção
• npm test - Executar testes
• npm run test:watch - Executar testes em watch mode
• npm run test:coverage - Executar testes com coverage
• npm run lint - Verificar linting
• npm run lint:fix - Corrigir problemas de linting
• npm run format - Formatar código
• npm run format:check - Verificar formatação
• npm run audit - Verificar vulnerabilidades
• npm run typecheck - Verificar tipos TypeScript

CI/CD (Woodpecker)

O pipeline executa automaticamente:

1. Instalação de dependências
2. Type checking
3. Linting
4. Formatação
5. Security audit
6. Testes
7. Coverage
8. Build
9. Docker build (apenas na branch main)

Variáveis de Ambiente

Variável	Descrição	Obrigatório
NODE_ENV	Ambiente (development/production)	Sim
PORT	Porta do servidor	Não (default: 3000)
LOG_LEVEL	Nível de log (debug/info/warn/error)	Não (default: info)
REDIS_URL	URL do Redis	Sim
API_BASE_URL	URL base da API PixieLog	Sim
PSN_NPSSO_TOKEN	Token NPSSO para conta PSN bot	Não (para PSN)
NINTENDO_SESSION_TOKEN	Token de sessão Nintendo	Não (para Nintendo)
IMINK_API_KEY	Chave API do serviço imink	Não (para Nintendo)
VERIFICATION_CODE_EXPIRY	Expiração do código de verificação (min)	Não (default: 30)

Licença

MIT