PAV-93: Criar documento de guia do usuário sobre Linear e integração automática com GitHub#194
Merged
hltav merged 13 commits intoJul 24, 2026
Conversation
…unity#176) Criptografa dados sensíveis de usuários e adiciona hashes pesquisáveis para email e CPF. Automatiza migrations/backfill via Docker Compose, ajusta cadastro do frontend. Exibe avatars no painel admin e atualiza testes relacionados.
Melhorias frontend
…salvas (Cla-Code-Community#185) - Substitui a ação Aplicar por Salvar na listagem de vagas. - Move vagas salvas para o status saved e ajusta textos do dashboard. - Adiciona ordenação por match na tela de vagas. - Implementa ordenação global por match no backend antes da paginação. - Torna funcional a limpeza de notificações.
…la-Code-Community#187) - Substitui o checkbox de vagas remotas por um select de modalidade inicial no perfil. - Persiste combinações de modalidade em jobTypes. - Aplica a preferência automaticamente como filtro inicial na tela de vagas. - Mantém compatibilidade com remoteOnly para dados antigos.
…munity#189) - Ajusta a mensagem de filtro ativo acima da tabela de vagas. - Faz a mensagem refletir os filtros selecionados na busca. - Remove a indicação fixa de vagas remotas quando o usuário altera os filtros. - Mantém o texto consistente com os resultados exibidos na tabela.
…Community#191) - Centraliza helper de ownership para filtros por usuário. - Refatora saved jobs, notifications, preferences e keywords para usar a policy. - Adiciona testes unitários cobrindo ownership e casos cross-user.
Cla-Code-Community#193) - Ajusta `npm run dev` para subir apenas frontend e backend. - Adiciona `npm run dev:admin` para incluir o painel administrativo. - Atualiza README raiz e docs de backend, scraper, frontend e front_admin. - Documenta `new_dashboard` como a nova estrutura de painel do frontend. - Troca onboarding local para `npm install`, mantendo `npm ci` como recomendação para CI/CD e instalações limpas.
- Cria GUIA-LINEAR-GITHUB.md com conceitos do Linear, passo a passo do fluxo de tasks, vínculo de card com branch/PR/commit e mapa das automações de estado (branch → In Progress, PR → In Review, merge → Done) - Adiciona link do guia no README (Links oficiais) - Reforça no skill abrir-pr-jobs-scraper que o identificador PAV-XX no título e o link do Linear no corpo são obrigatórios para a automação mover o card - Adiciona skill tlc-spec-driven e arquivos de suporte (.agents, lockfile) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ity/candidate - Substitui referências ao repositório antigo (Benevanio/Jobs_Scraper_Global) pelo upstream atual Cla-Code-Community/candidate - Corrige a detecção do owner do fork: passa a derivar do remote origin em vez de gh repo view (que resolvia o repo default e retornava o owner do upstream, gerando --head incorreto) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
O lockfile havia entrado no PR com drift acidental (nós top-level de @emnapi/core e @emnapi/runtime removidos e aninhados sob @rolldown/binding-wasm32-wasi), quebrando o npm ci no CI. Como o package.json é idêntico ao de develop, restaura o lock exatamente como está em develop, deixando o PR restrito a documentação e skills. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Documenta que, quando o gh pr create falha em fork com nome diferente do upstream (erros "No commits between...", "Head sha can't be blank"), o --head pode ter sido corrompido pelo gh. Inclui validação da branch via gh api compare e criação do PR direto pela API REST (gh api .../pulls), que respeita o head sem truncar. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
hltav
approved these changes
Jul 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Descricao
Adiciona um guia do usuário (GUIA-LINEAR-GITHUB.md) explicando, do ponto de vista de quem usa no dia a dia, como o time trabalha com o Linear e como aproveitar a integração automática com o GitHub. O documento cobre os conceitos do Linear (times, cards, estados, prioridades, ciclos), o passo a passo do fluxo de tasks, como vincular um card a branch/PR/commit via identificador PAV-XX, e o mapa das automações de estado (branch criado → In Progress, PR aberto → In Review, merge → Done), com um exemplo de ponta a ponta. Também linka o guia no README e reforça na skill abrir-pr-jobs-scraper que o identificador e o link do Linear são obrigatórios para a automação mover o card. Inclui ainda a skill tlc-spec-driven e arquivos de suporte, e atualiza a skill de abrir PR para o upstream atual (Cla-Code-Community/candidate).
Linear link
https://linear.app/tatame/issue/PAV-93/criar-documento-de-guia-do-usuario-sobre-linear-e-integracao
Como foi testado