Pular para o conteúdo
Ramos
01Aberto a oportunidades e freelas

João Victor Santos Ramos — construo produtos digitais do conceito ao deploy.

João Victor Santos Ramos — desenvolvedor e product builder. Escrevo a aplicação inteira: a interface que o usuário toca, a regra que roda no servidor, o banco que guarda e o deploy que coloca no ar.

Formação
ADS · Fatec Rubens Lara
Estágio
Reta final da graduação
No ar
rotation.com.br
Base
Guarujá, São Paulo — Brasil
02

Trabalho selecionado

Cada um com o estado real declarado — o que está no ar, o que é protótipo e o que ainda é conceito. Nenhuma métrica de uso aparece aqui porque nenhuma existe ainda.
01Produto digital · Comunidade esportiva

Rotation

O site do movimento de corrida, música e rua do Guarujá — no ar, em domínio próprio.

Página inicial do site Rotation em tela de computador: fotografias em preto e branco de corredores divididas em quatro colunas, com o título “Movimento que gera movimento” sobreposto e um seletor circular no canto direito.
Desktop1440 × 900
A mesma página no celular: as fotografias se reorganizam em uma grade de dois por dois, o menu vira botão e o título ocupa a largura inteira.
Celular390 × 844

Problema

Um movimento que acontece na rua vive no Instagram, e story vence em vinte e quatro horas. Quem já está no grupo se vira; quem ouviu falar e quer correr não descobre onde é, que horas sai o pelotão nem como entrar. E não existe lugar nenhum que mostre que aquilo acontece há meses, não uma vez.

Solução

Uma página que responde em dez segundos “onde é o próximo corre e como eu entro”. As três frentes do movimento — Running, Full Rotation e Sessions — têm cada uma seu bloco; o próximo encontro aparece em destaque com horário, endereço e o caminho para confirmar presença; e o histórico de edições passadas fica visível porque repetição é a única prova de continuidade. Os canais que já existiam viraram destino: WhatsApp, Strava, Instagram, Spotify e a bilheteria.

Estado

No ar

Publicado em rotation.com.br, com a autoria creditada no rodapé do próprio site. Segue fora dos buscadores por decisão enquanto o beta roda — o robots bloqueia e o sitemap já está pronto para o dia em que abrir.

Evento é conteúdo que vence

A data do próximo corre muda toda semana, então página estática pura envelheceria e renderização por requisição pagaria latência à toa. O site é pré-renderizado e revalida a cada cinco minutos: carrega como estático e nunca mostra um corre que já passou. O mesmo evento sai em JSON-LD (SportsEvent) com data, hora e local, e o bloco de números da comunidade carrega a data da última atualização na própria tela — número sem data envelhece escondido.

Tecnologias usadas em Rotation

  • Next.js App Router
  • React 19
  • Tailwind CSS
  • Design tokens
  • next/image
  • next/font
  • ISR
  • JSON-LD
  • Vercel
  • Domínio próprio
02SaaS · Visão computacional · Mobile

AlphaDog

Adestramento de cães com um treinador que enxerga a execução do exercício pela câmera.

SENTADOQUADRIL NO CHÃOCOLUNA ERETAPATAS ALINHADASDiagrama do conceito

Problema

Adestrar um cão exige alguém olhando e corrigindo. Quem treina sozinho em casa repete o exercício errado por semanas sem saber — e vídeo-aula não responde “ele sentou como deveria?”.

Solução

Duas metades no mesmo monorepo: um funil de aquisição com quiz de 43 passos e paywall personalizado, que existe e funciona; e o produto — o tutor fotografa a repetição, um modelo com visão avalia critério por critério e devolve o que faltou, em português.

Trocar pose por visão de linguagem

A primeira arquitetura estimava 24 articulações do cão por frame: modelo on-device, 30 fps, mais 3,5 MB de APK e bateria drenando. O produto não precisa das coordenadas — precisa do veredito e da explicação. Migrei para análise por foto com modelo de visão, e exercício novo virou arquivo de conteúdo em vez de retreino do modelo.

Estado

Em desenvolvimento

Funil e área do cliente no ar. Camada de IA em spike de viabilidade: a lógica de decisão e o pipeline de dados estão escritos e testados; o modelo ainda não foi treinado.

Tecnologias usadas em AlphaDog

  • TypeScript
  • Next.js
  • Python
  • pnpm workspaces
  • PostgreSQL
  • PL/pgSQL
  • Supabase
  • Computer vision
  • Gateway de pagamento
03Produto · Gamificação · IA

Rise

Não é um organizador de tarefas. É progresso real com regras de videogame.

Problema

Aplicativo de hábito marca caixinha e some. O esforço de terça não conversa com o de sábado, e no mês seguinte não sobrou nenhuma evidência de que a pessoa evoluiu.

Solução

Um motor de XP, níveis e streaks escrito como domínio puro — sem framework, testado contra uma especificação canônica antes de qualquer tela existir. Em cima dele, um dashboard que responde à ação com feedback otimista e um coach de IA em camadas, ancorado nos fatos do usuário para não alucinar progresso.

Em desenvolvimento

Sprint 0 fechada: monorepo, motor de XP testado, schema com 18 tabelas migrado no Supabase real, auth por e-mail e dashboard consumindo dados de verdade. Streaks, missões e o app mobile são as próximas etapas.

14NÍVELCORPOMENTEOFÍCIORELAÇÕESSTREAKDiagrama do conceito

Domínio antes de interface

O pacote core não importa React, banco nem HTTP: é a regra de XP em TypeScript puro, coberta por testes. O dashboard consome o mesmo motor no cliente para animar o nível na hora e reconciliar depois. A regra tem um lugar só — a web e o app Expo da fase 2 não vão reimplementá-la.

Tecnologias usadas em Rise

  • TypeScript
  • Next.js
  • Turborepo
  • tRPC
  • Drizzle ORM
  • Supabase
  • PostgreSQL
  • Expo
  • Claude API
04Rede social · Geolocalização

Sessions

Diário de surf com mapa dos picos, feed da comunidade e evolução por badges.

Protótipo navegável
SESSION 0411h 40minPICOMARÉSWELLDiagrama do conceito

Problema

Surfista registra sessão no bloco de notas e esquece. Não existe histórico do que funcionou, em que pico, com que condição — nem um lugar para combinar a próxima queda com quem surfa perto.

Solução

Uma aplicação Next.js com feed, perfil, registro de sessão com foto, badges de evolução, Crew para combinar sessões e mapa Mapbox dos picos surfados. O runtime usa Postgres quando há banco configurado e cai para um arquivo local em desenvolvimento, para o produto continuar navegável sem infraestrutura.

Estado

Protótipo navegável

Produto navegável com banco, upload e mapa ligados. Sem deploy público no momento — roda local com a variável de banco configurada.

Migração gradual de runtime

Um backend FastAPI separado foi iniciado no repositório, mas o frontend continua nas API Routes do Next. A migração acontece rota a rota — trocar tudo de uma vez deixaria o produto sem tela funcionando durante a troca.

Tecnologias usadas em Sessions

  • TypeScript
  • Next.js App Router
  • Tailwind CSS
  • PostgreSQL
  • Mapbox GL JS
  • Cloudinary
  • FastAPI
05Site comercial · Conversão

Kombi Surf School

Site de escola de surf construído para responder “quero aprender — como faço?” em dez segundos.

Problema

Escola de surf vende confiança. Um preço errado, um professor que não existe ou um depoimento fabricado destroem exatamente aquilo que o site deveria construir — e é o erro padrão de site de escola pequena.

A regra virou tipo

“Não inventar” costuma ser uma promessa de README. Aqui é o sistema de tipos: exibir um dado pendente como confirmado não compila. O site também fica fora dos buscadores enquanto a flag de conceito estiver ligada.

PRAIACONFIRMADOAULACONFIRMADOPREÇOA COMBINARDiagrama do conceito

Solução

Pesquisa antes do código, e o que a pesquisa não confirmou não virou texto. Todo dado sensível — preço, duração, praia, professor, contato — é tipado com status de confirmação e fonte. Os componentes não leem o valor direto: passam por um resolvedor que devolve “a combinar” quando o dado está pendente. Não existe caminho no código em que um dado não verificado apareça como certeza.

Projeto conceito

Demonstração comercial. Ainda não tem autorização formal da escola, não se apresenta como site oficial e permanece fora dos buscadores enquanto for conceito.

Tecnologias usadas em Kombi Surf School

  • TypeScript
  • Next.js
  • Tailwind CSS
  • SEO técnico
  • JSON-LD
  • Vercel
06Plataforma web · Backend

EntreLinhas

Desabafo anônimo em público, com identidade real por trás da conta.

Problema

Anonimato sem conta vira terra de ninguém e a moderação não tem a quem responder. Conta sem anonimato mata o desabafo. Os dois precisam existir ao mesmo tempo.

Solução

Aplicação Flask completa: cadastro com verificação por e-mail e senha em hash, recuperação por token de expiração curta, publicação anônima no feed, tags emocionais, ECHO, apoio, notificações, reports e painel de moderação. O anonimato é público — o vínculo com a conta existe no banco para a moderação ter a quem responder.

Infra pensada para produção, não para demo

PostgreSQL obrigatório em produção com SQLite só como fallback local; migrations versionadas em Alembic; storage plugável entre local, Cloudinary e S3; SMTP real por variável de ambiente; Gunicorn no Render. O guia de migração é parte do repositório.

ANÔNIMOANÔNIMOANÔNIMOMODERAÇÃODiagrama do conceito
Aplicação completa

Fluxos de autenticação, moderação e publicação implementados, com migration de produção escrita. Sem instância pública no ar no momento.

Tecnologias usadas em EntreLinhas

  • Python
  • Flask
  • SQLAlchemy
  • Alembic
  • PostgreSQL
  • SQLite
  • Supabase
  • Gunicorn
  • Tailwind CSS
  • Render
07Rede profissional · Matching

Hustle

Onde quem está construindo algo encontra quem falta no time.

CTOCEODiagrama do conceito

Problema

Achar cofundador, primeiro dev ou alguém com a habilidade que falta acontece hoje por sorte de rede pessoal. LinkedIn otimiza para currículo e vaga, não para complementaridade entre quem está construindo.

Solução

Perfis orientados a papel — CEO, CTO, design, produto — e descoberta por matching em vez de busca por cargo. A construção do produto acontece em público, com roadmap aberto, e a monetização prevista é um plano Pro.

Conceito de produto

Conceito documentado, sem código público e sem base de usuários. Está aqui porque é o próximo produto da fila, não porque já existe.

Sem repositório público — conceito em documentação.

03

Trajetória

A linha do tempo acompanha o que está versionado: da conta criada em 2024 aos monorepos de agora. Inclusive a parte em que o repositório era um script de trinta linhas.
  1. 2024

    Fatec Rubens Lara, Análise e Desenvolvimento de Sistemas

    Entrei pela porta acadêmica: lógica, estrutura de dados, banco relacional e as linguagens que o curso pede — incluindo COBOL, que ensina mais sobre sistema legado e disciplina de tipo do que parece.

  2. 2025Studies · todolist · Gerador-De-CPF

    Exercício vira repositório

    Os primeiros commits públicos são pequenos e não escondo isso: scripts em Python, um todolist em CSS puro, um repositório de estudos. Serviram para uma coisa — parar de programar em pasta solta e começar a versionar.

  3. Início de 2026EntreLinhas — Flask, SQLAlchemy, PostgreSQL

    A primeira aplicação inteira

    EntreLinhas foi onde deixei de escrever exercício. Autenticação de verdade com verificação por e-mail, moderação, migrations versionadas, storage plugável, Postgres em produção e SQLite só como fallback. Foi o projeto que me obrigou a pensar em quem opera o sistema depois que ele sobe.

  4. Meio de 2026Sessions — Next.js, Mapbox · PlantDiary — Haskell

    Produto e desconforto

    Sessions me colocou em mapa, upload e feed — decisões de UX, não só de código. PlantDiary foi de propósito o oposto do confortável: Haskell, tipagem forte e Docker, para descobrir o que a linguagem me obriga a resolver antes de rodar.

  5. AgoraRotation · Rise · AlphaDog

    Produto no ar, com o nome no rodapé

    A Rotation fechou o ciclo que os outros projetos tinham deixado pela metade: não parou no deploy de portfólio. Está em domínio próprio, serve um movimento que existe na rua toda semana e me credita no rodapé. Rise e AlphaDog seguem como os monorepos onde eu trabalho arquitetura — domínio testado, banco migrado, IA integrada, funil de aquisição. É esse o ciclo que me interessa agora: entender o problema, decidir a arquitetura, escrever, subir e continuar mantendo com gente usando.

Estou na reta final de Análise e Desenvolvimento de Sistemas — Fatec Rubens Lara. O que me interessa agora não é aprender mais uma ferramenta — é fechar o ciclo inteiro: entender o problema, decidir a arquitetura, escrever, subir e corrigir com o produto no ar.

04

Ferramentas

Organizado por função, não por logo. Cada item mostra em qual projeto ele aparece de fato no código público — e o que ainda é estudo está marcado como estudo.
01

Linguagens

O que escrevo quando o problema define a ferramenta.

  • TypeScript — usado em AlphaDog, Rise, Sessions, Kombi
  • Python — usado em EntreLinhas, AlphaDog
  • JavaScript — usado em AlphaDog, Sessions, EntreLinhas
  • SQL — usado em Rise, AlphaDog, EntreLinhas
  • Haskell — usado em PlantDiary
  • Java — ainda em estudo, sem projeto públicoestudo
  • Go — ainda em estudo, sem projeto públicoestudo
  • C — ainda em estudo, sem projeto públicoestudo
  • COBOL — ainda em estudo, sem projeto públicoestudo
02

Interface e produto

Onde o usuário toca. É aqui que a decisão de produto vira tela.

  • Next.js — usado em Rotation, AlphaDog, Rise, Sessions, Kombi
  • React — usado em Rotation, AlphaDog, Rise, Sessions, Kombi
  • Tailwind CSS — usado em Rotation, Rise, Sessions, Kombi, EntreLinhas
  • HTML · CSS — usado em Rotation, EntreLinhas, Kombi
  • Expo · React Native — usado em Rise
03

Backend e dados

A regra do produto, o contrato da API e o que persiste.

  • PostgreSQL — usado em Rise, Sessions, EntreLinhas, AlphaDog
  • Supabase — usado em Rise, AlphaDog, EntreLinhas
  • Flask — usado em EntreLinhas
  • SQLAlchemy · Alembic — usado em EntreLinhas
  • tRPC — usado em Rise
  • Drizzle ORM — usado em Rise
  • FastAPI — usado em Sessions
  • SQLite — usado em EntreLinhas, Sessions
  • Django — ainda em estudo, sem projeto públicoestudo
04

Infra e entrega

Software que não está no ar não existe.

  • Vercel — usado em Rotation, AlphaDog, Rise, Kombi
  • Render — usado em EntreLinhas, PlantDiary
  • Git · GitHub — usado em todos
  • GitHub Actions — usado em Rise
  • Turborepo · pnpm — usado em Rise, AlphaDog
  • Docker — usado em PlantDiary
  • Gunicorn — usado em EntreLinhas
  • Linux — ainda em estudo, sem projeto públicoestudo
05

Domínios

Problemas que já enfrentei dentro de um projeto, não capítulos de curso.

  • Autenticação e sessão — usado em EntreLinhas, Rise, AlphaDog
  • Visão computacional — usado em AlphaDog
  • IA aplicada a produto — usado em AlphaDog, Rise
  • Assinatura e pagamento — usado em AlphaDog
  • Mapas e geolocalização — usado em Sessions
  • Modelagem relacional — usado em Rise, EntreLinhas
  • SEO técnico — usado em Rotation, Kombi
  • Arquitetura de monorepo — usado em Rise, AlphaDog
  • Renderização e cache (ISR) — usado em Rotation
  • Otimização de imagem — usado em Rotation
aplicado em projeto públicoestudoconheço, mas ainda não escrevi nada público com isso
05

Como eu decido

Cinco regras que aparecem no código antes de aparecerem em qualquer texto. Cada uma tem o projeto onde ela foi seguida — e onde dá para conferir.
  1. 01

    A decisão vem antes do arquivo

    Antes da primeira tela do Rise existiu uma especificação canônica do motor de XP e um conjunto de ADRs. Escrever primeiro e decidir depois é o que produz aquele código que ninguém consegue mudar seis semanas depois.

    Rise — 17 documentos de fundação e ADRs antes do Sprint 0

  2. 02

    Dado não confirmado não vira texto

    No Kombi Surf School, preço, professor e horário são valores tipados com status de confirmação. Um dado pendente não pode ser renderizado como certeza: o compilador impede. Regra que depende de disciplina humana é regra que falha na sexta-feira.

    Kombi Surf School — confirmação de dado garantida pelo tipo

  3. 03

    A regra mora no domínio, não na tela

    O motor de XP do Rise não conhece React, HTTP nem banco. É TypeScript puro, coberto por testes, consumido igual pelo servidor e pelo cliente. A web e o app mobile não vão reimplementar a mesma regra com duas interpretações diferentes.

    Rise — pacote de domínio sem dependência de framework

  4. 04

    Trocar a arquitetura quando ela cobra caro

    O AlphaDog rodava estimativa de pose on-device a 30 quadros por segundo. Funcionava e custava bateria, tamanho de APK e um retreino a cada exercício novo. Troquei por análise por foto com modelo de visão. Defender arquitetura por orgulho é como o produto morre.

    AlphaDog — migração documentada de pose para visão

  5. 05

    Terminar é estar no ar

    Localhost não é entrega. Migration de produção escrita, variáveis documentadas, storage e SMTP configuráveis, verificação de link quebrado no build. O trabalho chato do fim é o que separa protótipo de produto.

    EntreLinhas — guia de migração · AlphaDog — verificação de links no build

06

O código

Tudo o que está aqui embaixo vem direto da API pública do GitHub, no servidor. Se a API não responder, a seção fica sem números — nenhum valor é preenchido à mão.
15
Repositórios públicos
6
Seguidores
2024
No GitHub desde
nov 2026
Último push

Linguagens por volume de código nos repositórios próprios

  • TypeScript60.7%
  • Python13.5%
  • Java12.9%
  • HTML4.8%
  • CSS3%
  • JavaScript2.4%
  • Haskell1.5%

Bytes de código somados repositório por repositório, direto do endpoint de linguagens do GitHub. Mede onde o volume está — não é medida de domínio, e um arquivo grande de estilo pesa igual a um de lógica.

github.com/CodeByRamosCódigo aberto, commits reais, projetos em curso.
07

Tem alguma coisa para tirar do papel?

Vaga de desenvolvedor, freela ou um produto que ainda é ideia. Manda o contexto — respondo com o que dá para construir e por onde eu começaria.