Bem-vindo ao PC-Laboratory, um laboratório interativo de Provas de Conceito (PoCs) para você explorar, investigar e compartilhar inovações tecnológicas.
O PC-Laboratory é um espaço onde você pode:
- Investigar tecnologias novas e desafiadoras
- Desenvolver provas de conceito criativas
- Aprender através da prática orientada
- Compartilhar conhecimento com a comunidade
Cada PoC que você desenvolve aqui é uma investigação estruturada sobre uma tecnologia, padrão ou solução específica. O objetivo é que você aprenda na prática, teste ideias e documente tudo isso de forma clara e rigorosa.
O fluxo do PC-Laboratory acontece em três etapas principais, e é bem simples:
Primeiro, você precisa se preparar para receber os desafios investigativos:
- Faça um fork deste repositório para sua conta pessoal
- No seu fork, ative as Discussions em Settings → Features → Discussions
- Pronto! Seu fork está pronto para receber os desafios
Como ativar Discussions no seu fork:
- Vá para Settings (a engrenagem no canto)
- Clique em Features
- Marque a opção Discussions
- Salve
Agora vem a parte prática. Aqui está como funciona:
- Eu (ou outro professor) abro 2 Discussions no seu fork, cada uma propondo um desafio investigativo específico
- Você investe tempo investigando, experimentando e documentando suas descobertas
- Você responde à Discussion com sua solução, seus resultados e suas conclusões
- O professor marca a Discussion como aceita (Answered)
- Você ganha progresso em uma badge especial no seu GitHub: a badge Galaxy Brain
A badge Galaxy Brain é um reconhecimento do GitHub para quem demonstra pensamento crítico, criatividade, aprendizado contínuo e contribuição para a comunidade. Quanto mais Discussions-PoC você responde com qualidade, mais próximo fica de desbloquear essa badge.
Se sua PoC for particularmente boa e bem documentada, você tem a opção de contribuir para o acervo permanente do laboratório:
- Crie uma pasta seguindo a nomenclatura oficial em
pocs/ - Adicione seu PoC completo com toda a documentação
- Abra um Pull Request para o repositório original
- Se aprovado, seu PoC entra no acervo permanente e serve como referência para futuros alunos
pc-laboratory/
├── README.md (este arquivo)
├── pocs/ (acervo de PoCs aceitas)
│ └── README.md (índice e instruções)
│
└── .github/
└── PULL_REQUEST_TEMPLATE/
└── poc-submission.md (template para submissão)
Todas as PoCs no acervo seguem um padrão de nomenclatura bem definido. Isso ajuda a manter tudo organizado e fácil de encontrar.
AAAA-NN-CATEGORIA-titulo-kebab-case
| Componente | O que é | Exemplo |
|---|---|---|
| AAAA | Ano em que a PoC foi criada (4 dígitos) | 2026 |
| NN | Número do mês (01 a 12) | 01, 05, 12 |
| CATEGORIA | A área tecnológica da PoC | web, ia, devops |
| titulo-kebab-case | Nome descritivo em letras minúsculas com hífens | autenticacao-jwt-prisma |
2026-01-web-autenticacao-jwt-prisma— PoC sobre autenticação JWT em uma API2026-03-ia-chatbot-langchain-groq— PoC sobre um chatbot com IA2026-05-devops-ci-cd-github-actions— PoC sobre automação de deploy2026-07-security-criptografia-bcrypt-nodejs— PoC sobre criptografia segura2026-02-data-pipeline-etl-dbt-snowflake— PoC sobre processamento de dados
Escolha uma das dez categorias abaixo para sua PoC:
| Categoria | O que entra aqui | Exemplos |
|---|---|---|
| web | Desenvolvimento web, APIs, frontend | REST APIs, frameworks, autenticação |
| mobile | Apps mobile e multiplataforma | React Native, Flutter, iOS/Android |
| data | Engenharia de dados, pipelines, BI | ETL, data warehousing, análise |
| ia | Inteligência artificial, machine learning | LLMs, redes neurais, NLP, ML |
| devops | DevOps, infraestrutura, deployment | CI/CD, Docker, Kubernetes, IaC |
| security | Segurança, criptografia, proteção | OAuth, JWT, encriptação, testes de segurança |
| iot | Internet das Coisas, sistemas embarcados | Sensores, Arduino, protocolos |
| games | Desenvolvimento de jogos | Game engines, física, networking |
| tools | Ferramentas, CLIs, utilitários | Automação, scripts, bibliotecas |
| misc | Projetos que não encaixam em outras categorias | Projetos híbridos, casos especiais |
Toda PoC que entra no acervo precisa seguir este template. Isso garante consistência e qualidade:
# [Título da PoC]
## Informações Básicas
- **Autor(a):** Seu Nome
- **Data:** AAAA-MM-DD
- **Categoria:** [categoria aqui]
- **Tecnologias:** [Liste aqui]
## Hipótese
Descreva brevemente qual era a questão investigada ou qual era seu objetivo.
Exemplo: "Investigar se é possível implementar autenticação segura com JWT em uma aplicação Node.js + Prisma"
## Tecnologias Utilizadas
- Node.js 18+
- Express.js
- Prisma ORM
- JWT (jsonwebtoken)
- bcryptjs
## Como Executar
Passo a passo claro e direto:
1. Clone este repositório
2. Instale as dependências: `npm install`
3. Configure o arquivo `.env` com as variáveis necessárias
4. Execute o servidor: `npm start`
5. Teste os endpoints...
## Resultados
Descreva o que você descobriu. Quais foram os resultados? Que comportamentos você observou? Que dados coletou?
## Conclusão
Resuma os aprendizados principais. Sua hipótese inicial foi confirmada? O que você aprendeu que não esperava?
## Referências
- [Documentação oficial](https://...)
- [Artigo que consultei](https://...)
- [Tutorial que segui](https://...)Quando uma Discussion-PoC é marcada como aceita pelo professor, você recebe progresso na badge Galaxy Brain do GitHub.
Essa badge é um reconhecimento automático do GitHub para quem demonstra:
- Pensamento crítico e investigação genuína
- Criatividade ao abordar problemas
- Aprendizado contínuo de novas tecnologias
- Contribuição para a comunidade académica
Quanto mais Discussions-PoC você responde com qualidade e o professor aceita, mais próximo você fica de desbloquear essa badge. É uma forma legal de reconhecer seu trabalho.
Use este checklist para acompanhar seu progresso:
- Fiz fork do repositório pc-laboratory
- Ativei Discussions no meu fork
- Li este README completamente
- Entendi o fluxo de 3 etapas
- Recebi as Discussions-PoC no meu fork
- Li completamente os desafios propostos
- Investigueie e experimentei as tecnologias
- Documentei meus resultados e conclusões
- Respondi à Discussion com qualidade
- Aguardo feedback do professor
- Minha PoC foi validada e aceita
- Meu README segue o template obrigatório
- Meu diretório segue a nomenclatura correta
- Criei um Pull Request com a submissão
- Aguardo review e merge
Se tiver dúvidas:
- Sobre nomenclatura: Veja a seção Convenção de Nomenclatura acima
- Sobre template de PoC: Veja a seção Template Obrigatório
- Sobre como submeter: Leia o arquivo poc-submission.md
- Sobre qualquer coisa: Converse com seu professor
Bem-vindo ao PC-Laboratory! Este é um espaço para você investigar, aprender e inovar.