Comandos úteis¶

Ambiente¶

Criar ambiente:

python -m venv .venv

Ativar no Windows PowerShell:

.venv\Scripts\activate

Ativar no Git Bash:

source .venv/Scripts/activate

Ativar no Linux/macOS:

source .venv/bin/activate

Instalar:

pip install -r docs/requirements/requirements.txt

Atualizar pip:

python -m pip install --upgrade pip

Fluxo local principal:

.\start-sotuhire.ps1

Sem abrir navegador:

.\start-sotuhire.ps1 -NoBrowser

Rodar Streamlit legado/dev:

streamlit run app.py

Rodar FastAPI local:

python scripts/run_api.py

Rodar frontend moderno manualmente:

cd apps/web
npm install
npm run dev

OpenAPI:

http://127.0.0.1:8787/openapi.json
http://127.0.0.1:8787/docs

Rodar todos:

pytest

Com detalhes:

pytest -v

Com coverage, se instalado:

pytest --cov=modules --cov-report=term-missing

Lint:

ruff check .

Corrigir automaticamente o que for seguro:

ruff check . --fix

Formatar:

ruff format .

Checar formatação sem alterar:

ruff format . --check

Fluxo recomendado antes de commit:

ruff check .
ruff format . --check
pytest

Rodar docs localmente:

mkdocs serve

Build:

mkdocs build

Deploy no GitHub Pages, quando fizer sentido:

mkdocs gh-deploy

Instalar plugin:

pip install pytest-playwright
playwright install

Usar apenas quando houver testes E2E ou páginas públicas dinâmicas.

Ver status:

git status

Adicionar arquivos:

git add .

Commit para docs:

git commit -m "docs: expand scraping and quality documentation"

Commit para MVP:

git commit -m "feat: add initial resume job match MVP"

Enviar:

git push

git apply SotuHire-scraping-ruff-update.patch

Depois:

git add .
git commit -m "docs: expand scraping strategy and Ruff setup"
git push