# Guia de Uso Profissional Final — Fábrica Front-End Maleta

Este guia mostra como usar a maleta como ferramenta de estudo, prática, criação de projetos e portfólio front-end.

## 1. Abrir a maleta localmente

Entre na pasta do projeto:

cd ~/projetos/fabrica-front-end-maleta

Inicie o servidor local:

python3 -m http.server 8010

Acesse no navegador:

http://localhost:8010/

## 2. Páginas principais

Home:

http://localhost:8010/index.html

Central Mestre:

http://localhost:8010/criador.html

Projetos Reais:

http://localhost:8010/projetos.html

Painel Mestre:

http://localhost:8010/painel.html

Status:

http://localhost:8010/status.html

## 3. Fluxo profissional recomendado

Use este fluxo para qualquer projeto:

1. Abrir a Central Mestre
2. Ler o Método Mestre
3. Preencher o Briefing Mestre
4. Escolher um modelo base
5. Criar o projeto real
6. Adaptar conteúdo
7. Ajustar HTML
8. Ajustar CSS
9. Testar responsividade
10. Revisar acessibilidade
11. Criar README
12. Publicar
13. Salvar prints
14. Revisar como recrutador
15. Colocar no portfólio

## 4. Criar um projeto real individual

Exemplo:

python3 scripts/criar-projeto-real.py "Minha Landing Page" landing-page-para-servico-local "Landing page"

Depois atualize o registro:

python3 scripts/atualizar-projetos.py

Audite:

python3 scripts/auditoria-projetos-reais.py

## 5. Criar projetos em massa

Criar 5 projetos:

python3 scripts/criar-projetos-em-massa.py 5

Criar todos:

python3 scripts/criar-projetos-em-massa.py --todos

Atualizar registro:

python3 scripts/atualizar-projetos.py

## 6. Auditar a maleta inteira

Use sempre antes de fechar uma versão:

python3 scripts/auditoria-mestre-total.py

Resultado esperado:

Status: APROVADO

## 7. Atualizar o Painel Mestre

Sempre que criar projetos ou mudar versões:

python3 scripts/atualizar-painel.py

## 8. Organização dos projetos reais

Cada projeto real precisa ter:

- index.html
- style.css
- README.md
- briefing.md
- checklist.md
- decisoes-tecnicas.md
- assets/
- prints/

## 9. Regra para portfólio

Não coloque todos os projetos no portfólio.

Escolha os melhores.

Critério recomendado:

- visual profissional
- mobile bem feito
- README completo
- objetivo claro
- link publicado
- prints salvos
- código organizado

## 10. Ordem ideal de evolução

1. HTML e CSS
2. Responsividade
3. Acessibilidade
4. JavaScript
5. Consumo de API
6. React
7. Portfólio final

## 11. Rotina semanal

Segunda:

Escolher projeto e preencher briefing.

Terça:

Criar estrutura e adaptar HTML.

Quarta:

Adaptar CSS e responsividade.

Quinta:

Revisar qualidade, acessibilidade e performance.

Sexta:

Criar README, commits e publicar.

Sábado:

Salvar prints e registrar aprendizados.

Domingo:

Revisar evolução e planejar o próximo projeto.

## 12. Comandos importantes

Ver status do Git:

git status --short

Salvar alterações:

git add .
git commit -m "Mensagem do commit"
git push origin main

Criar tag:

git tag -a vX.X-nome-da-versao -m "Mensagem da versão"
git push origin vX.X-nome-da-versao

Criar ZIP:

zip -r ~/Downloads/nome-do-arquivo.zip . -x ".git/*" ".venv/*" "auditorias/*" "__pycache__/*"

## 13. Objetivo final

Usar a maleta para criar projetos reais com método, documentação, auditoria, revisão e evolução contínua.

A maleta não é apenas uma coleção de modelos.

Ela é uma estrutura de criação profissional.