feat: login individual por funcionario (cadastro, senha com hash, ativar/desativar)

- Tabela FUNCIONARIO_PAINEL (nova, ja criada no banco de dev) +
  app/db/funcionarios.py: nome/login/senha (hash scrypt, stdlib, sem
  dependencia nova) por funcionario, nunca excluido de verdade (so
  ativo/inativo).
- app/senha.py: gerar_hash/verificar_senha com hashlib.scrypt + salt
  aleatorio por senha.
- app/auth.py: login passa a checar duas fontes, nessa ordem -
  ADMIN_USER/ADMIN_PASSWORD (bootstrap, continua exigindo as duas
  preenchidas) e depois FUNCIONARIO_PAINEL (so contas ATIVO=1). O
  nome retornado (usado no log) passa a ser o nome de verdade do
  funcionario, nao mais sempre 'admin'.
- Tela /funcionarios: listar, criar (com confirmacao de senha e
  checagem de login duplicado), editar nome/login, redefinir senha
  (form separado) e ativar/desativar. Tudo logado em LOG_PAINEL.
- Testado ponta a ponta contra o app real: funcionario criado via
  tela consegue logar de verdade, e a acao aparece no /log com o
  nome de quem fez.

93/93 testes passando (23 novos).
This commit is contained in:
Gustavo
2026-08-13 14:19:58 -03:00
parent dad1abf30b
commit 8d83122e98
13 changed files with 697 additions and 20 deletions
+29 -19
View File
@@ -1,6 +1,15 @@
"""
Login simples via HTTP Basic Auth, usuário/senha vindos de variável de
ambiente. Sem cadastro de usuários, sem perfis, sem sessão/cookie.
Login HTTP Basic. Duas fontes de credencial, checadas nessa ordem:
1. ADMIN_USER/ADMIN_PASSWORD (variáveis de ambiente) — conta única de
bootstrap, útil para o primeiro acesso (cadastrar o primeiro
funcionário em /funcionarios) e como plano B se a tabela de
funcionários ficar vazia/inacessível. Continua exigindo as duas
variáveis preenchidas (nunca autentica credencial vazia).
2. FUNCIONARIO_PAINEL (app/db/funcionarios.py) — conta individual por
funcionário, com senha em hash (app/senha.py). Só autentica se ATIVO=1.
Sem sessão/cookie — o próprio navegador guarda a credencial Basic.
"""
import os
import secrets
@@ -8,27 +17,28 @@ import secrets
from fastapi import Depends, HTTPException, status
from fastapi.security import HTTPBasic, HTTPBasicCredentials
from .db import funcionarios as db_funcionarios
from .senha import verificar_senha
_security = HTTPBasic()
def exigir_login(credenciais: HTTPBasicCredentials = Depends(_security)) -> str:
usuario_esperado = os.environ.get("ADMIN_USER", "")
senha_esperada = os.environ.get("ADMIN_PASSWORD", "")
usuario_admin = os.environ.get("ADMIN_USER", "")
senha_admin = os.environ.get("ADMIN_PASSWORD", "")
if not usuario_esperado or not senha_esperada:
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="Usuário ou senha inválidos.",
headers={"WWW-Authenticate": "Basic"},
)
if usuario_admin and senha_admin:
usuario_ok = secrets.compare_digest(credenciais.username, usuario_admin)
senha_ok = secrets.compare_digest(credenciais.password, senha_admin)
if usuario_ok and senha_ok:
return credenciais.username
usuario_ok = secrets.compare_digest(credenciais.username, usuario_esperado)
senha_ok = secrets.compare_digest(credenciais.password, senha_esperada)
funcionario = db_funcionarios.obter_por_login(credenciais.username)
if funcionario and funcionario["ATIVO"] and verificar_senha(credenciais.password, funcionario["SENHA_HASH"]):
return funcionario["NOME"]
if not (usuario_ok and senha_ok):
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="Usuário ou senha inválidos.",
headers={"WWW-Authenticate": "Basic"},
)
return credenciais.username
raise HTTPException(
status_code=status.HTTP_401_UNAUTHORIZED,
detail="Usuário ou senha inválidos.",
headers={"WWW-Authenticate": "Basic"},
)
+119
View File
@@ -0,0 +1,119 @@
"""
CRUD de FUNCIONARIO_PAINEL — contas individuais de funcionário para login
no painel (substitui/complementa o ADMIN_USER/ADMIN_PASSWORD único).
A tabela já existe no banco de dev. Em qualquer outro ambiente, crie-a
primeiro com:
CREATE TABLE FUNCIONARIO_PAINEL (
ID INT UNSIGNED NOT NULL AUTO_INCREMENT,
NOME VARCHAR(80) NOT NULL,
LOGIN VARCHAR(40) NOT NULL,
SENHA_HASH VARCHAR(255) NOT NULL,
ATIVO TINYINT(1) NOT NULL DEFAULT 1,
CRIADO_EM DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (ID),
UNIQUE KEY UQ_FUNCIONARIO_PAINEL_LOGIN (LOGIN)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
Nunca excluído de verdade — "excluir" aqui é alternar ATIVO para 0
(mesma lógica de nunca apagar histórico usada no resto do projeto).
"""
from .connection import get_connection
from ..senha import gerar_hash
def listar_funcionarios() -> list[dict]:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute("SELECT ID, NOME, LOGIN, ATIVO, CRIADO_EM FROM FUNCIONARIO_PAINEL ORDER BY NOME")
return cur.fetchall()
finally:
conn.close()
def obter_funcionario(funcionario_id: int) -> dict | None:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute(
"SELECT ID, NOME, LOGIN, ATIVO, CRIADO_EM FROM FUNCIONARIO_PAINEL WHERE ID = %s", (funcionario_id,)
)
return cur.fetchone()
finally:
conn.close()
def obter_por_login(login: str) -> dict | None:
"""Usado pelo login (app/auth.py) — inclui SENHA_HASH, ao contrário das outras consultas."""
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute(
"SELECT ID, NOME, LOGIN, SENHA_HASH, ATIVO FROM FUNCIONARIO_PAINEL WHERE LOGIN = %s", (login,)
)
return cur.fetchone()
finally:
conn.close()
def login_em_uso(login: str, ignorar_id: int | None = None) -> bool:
conn = get_connection()
try:
with conn.cursor() as cur:
sql = "SELECT ID FROM FUNCIONARIO_PAINEL WHERE LOGIN = %s"
params = [login]
if ignorar_id is not None:
sql += " AND ID != %s"
params.append(ignorar_id)
cur.execute(sql, params)
return cur.fetchone() is not None
finally:
conn.close()
def criar_funcionario(nome: str, login: str, senha: str) -> int:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute(
"INSERT INTO FUNCIONARIO_PAINEL (NOME, LOGIN, SENHA_HASH, ATIVO) VALUES (%s, %s, %s, 1)",
(nome, login, gerar_hash(senha)),
)
return cur.lastrowid
finally:
conn.close()
def atualizar_funcionario(funcionario_id: int, nome: str, login: str) -> None:
"""Só nome/login — troca de senha é redefinir_senha()."""
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute(
"UPDATE FUNCIONARIO_PAINEL SET NOME = %s, LOGIN = %s WHERE ID = %s", (nome, login, funcionario_id)
)
finally:
conn.close()
def redefinir_senha(funcionario_id: int, nova_senha: str) -> None:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute(
"UPDATE FUNCIONARIO_PAINEL SET SENHA_HASH = %s WHERE ID = %s",
(gerar_hash(nova_senha), funcionario_id),
)
finally:
conn.close()
def alternar_ativo(funcionario_id: int) -> None:
conn = get_connection()
try:
with conn.cursor() as cur:
cur.execute("UPDATE FUNCIONARIO_PAINEL SET ATIVO = 1 - ATIVO WHERE ID = %s", (funcionario_id,))
finally:
conn.close()
+2 -1
View File
@@ -8,13 +8,14 @@ from fastapi.staticfiles import StaticFiles
from .auth import exigir_login
from .csrf import CSRF_COOKIE_NAME, gerar_token
from .routers import chave_manual, clientes, contatos, log
from .routers import chave_manual, clientes, contatos, funcionarios, log
app = FastAPI(title="Painel de Clientes", docs_url=None, redoc_url=None, openapi_url=None)
app.mount("/static", StaticFiles(directory="app/static"), name="static")
app.include_router(clientes.router)
app.include_router(contatos.router)
app.include_router(chave_manual.router)
app.include_router(funcionarios.router)
app.include_router(log.router)
+148
View File
@@ -0,0 +1,148 @@
"""
Rotas de gestão de FUNCIONARIO_PAINEL: listar, criar (com senha), editar
nome/login, redefinir senha, ativar/desativar (nunca exclui de verdade).
"""
from typing import Optional
from fastapi import APIRouter, Depends, Form, Request
from fastapi.responses import HTMLResponse, RedirectResponse
from fastapi.templating import Jinja2Templates
from ..auth import exigir_login
from ..csrf import exigir_csrf, token_do_contexto
from ..db import funcionarios as db_funcionarios
from ..db import log as db_log
router = APIRouter(prefix="/funcionarios")
templates = Jinja2Templates(directory="app/templates")
def _redirect_com_mensagem(mensagem: str, tipo: str = "success") -> RedirectResponse:
from urllib.parse import urlencode
return RedirectResponse(f"/funcionarios?{urlencode({'mensagem': mensagem, 'mensagem_tipo': tipo})}", status_code=303)
@router.get("", response_class=HTMLResponse)
def listar(
request: Request,
mensagem: Optional[str] = None,
mensagem_tipo: Optional[str] = None,
usuario: str = Depends(exigir_login),
):
funcionarios = db_funcionarios.listar_funcionarios()
return templates.TemplateResponse(
request,
"funcionarios_lista.html",
{
"funcionarios": funcionarios, "csrf_token": token_do_contexto(request),
"mensagem": mensagem, "mensagem_tipo": mensagem_tipo,
},
)
@router.get("/novo", response_class=HTMLResponse)
def form_novo(request: Request, usuario: str = Depends(exigir_login)):
return templates.TemplateResponse(
request, "funcionario_form.html", {"funcionario": None, "csrf_token": token_do_contexto(request)}
)
@router.post("/novo", dependencies=[Depends(exigir_csrf)])
def criar(
request: Request,
nome: str = Form(...),
login: str = Form(...),
senha: str = Form(...),
confirmar_senha: str = Form(...),
usuario: str = Depends(exigir_login),
):
nome = nome.strip()
login = login.strip()
erro = None
if not nome or not login or not senha:
erro = "Preencha nome, login e senha."
elif senha != confirmar_senha:
erro = "As senhas digitadas não coincidem."
elif db_funcionarios.login_em_uso(login):
erro = f"O login \"{login}\" já está em uso."
if erro:
return templates.TemplateResponse(
request,
"funcionario_form.html",
{
"funcionario": None, "erro": erro, "dados": {"NOME": nome, "LOGIN": login},
"csrf_token": token_do_contexto(request),
},
)
novo_id = db_funcionarios.criar_funcionario(nome, login, senha)
db_log.registrar(usuario, "criar", "funcionario", str(novo_id), True)
return _redirect_com_mensagem("Funcionário cadastrado.")
@router.get("/{funcionario_id}/editar", response_class=HTMLResponse)
def form_editar(request: Request, funcionario_id: int, usuario: str = Depends(exigir_login)):
funcionario = db_funcionarios.obter_funcionario(funcionario_id)
if funcionario is None:
return _redirect_com_mensagem("Funcionário não encontrado.", "danger")
return templates.TemplateResponse(
request, "funcionario_form.html", {"funcionario": funcionario, "csrf_token": token_do_contexto(request)}
)
@router.post("/{funcionario_id}/editar", dependencies=[Depends(exigir_csrf)])
def editar(
request: Request,
funcionario_id: int,
nome: str = Form(...),
login: str = Form(...),
usuario: str = Depends(exigir_login),
):
nome = nome.strip()
login = login.strip()
erro = None
if not nome or not login:
erro = "Preencha nome e login."
elif db_funcionarios.login_em_uso(login, ignorar_id=funcionario_id):
erro = f"O login \"{login}\" já está em uso."
if erro:
return templates.TemplateResponse(
request,
"funcionario_form.html",
{
"funcionario": {"ID": funcionario_id}, "erro": erro, "dados": {"NOME": nome, "LOGIN": login},
"csrf_token": token_do_contexto(request),
},
)
db_funcionarios.atualizar_funcionario(funcionario_id, nome, login)
db_log.registrar(usuario, "editar", "funcionario", str(funcionario_id), True)
return _redirect_com_mensagem("Funcionário atualizado.")
@router.post("/{funcionario_id}/redefinir-senha", dependencies=[Depends(exigir_csrf)])
def redefinir_senha(
funcionario_id: int,
nova_senha: str = Form(...),
confirmar_nova_senha: str = Form(...),
usuario: str = Depends(exigir_login),
):
if not nova_senha or nova_senha != confirmar_nova_senha:
db_log.registrar(usuario, "redefinir_senha", "funcionario", str(funcionario_id), False, "senhas não coincidem")
return _redirect_com_mensagem("As senhas digitadas não coincidem.", "danger")
db_funcionarios.redefinir_senha(funcionario_id, nova_senha)
db_log.registrar(usuario, "redefinir_senha", "funcionario", str(funcionario_id), True)
return _redirect_com_mensagem("Senha redefinida.")
@router.post("/{funcionario_id}/alternar-ativo", dependencies=[Depends(exigir_csrf)])
def alternar_ativo(funcionario_id: int, usuario: str = Depends(exigir_login)):
db_funcionarios.alternar_ativo(funcionario_id)
db_log.registrar(usuario, "alternar_ativo", "funcionario", str(funcionario_id), True)
return _redirect_com_mensagem("Status do funcionário atualizado.")
+31
View File
@@ -0,0 +1,31 @@
"""
Hash de senha de funcionário com scrypt (hashlib da biblioteca padrão —
sem dependência extra tipo bcrypt/passlib). Formato armazenado:
"scrypt$<salt em hex>$<hash em hex>".
"""
import hashlib
import secrets
_N, _R, _P = 2**14, 8, 1
_TAMANHO_HASH = 32
def gerar_hash(senha: str) -> str:
salt = secrets.token_bytes(16)
resultado = hashlib.scrypt(senha.encode("utf-8"), salt=salt, n=_N, r=_R, p=_P, dklen=_TAMANHO_HASH)
return f"scrypt${salt.hex()}${resultado.hex()}"
def verificar_senha(senha: str, hash_armazenado: str) -> bool:
"""Nunca lança — hash malformado ou senha errada só retorna False."""
try:
algoritmo, salt_hex, hash_hex = hash_armazenado.split("$")
if algoritmo != "scrypt":
return False
salt = bytes.fromhex(salt_hex)
esperado = bytes.fromhex(hash_hex)
except (ValueError, AttributeError):
return False
calculado = hashlib.scrypt(senha.encode("utf-8"), salt=salt, n=_N, r=_R, p=_P, dklen=len(esperado))
return secrets.compare_digest(calculado, esperado)
+1
View File
@@ -26,6 +26,7 @@
<nav>
<a href="/clientes">Clientes</a>
<a href="/gerador-chave">Gerador de chave</a>
<a href="/funcionarios">Funcionários</a>
<a href="/log">Log</a>
</nav>
<main>
+26
View File
@@ -0,0 +1,26 @@
<!-- app/templates/funcionario_form.html -->
{% extends "base.html" %}
{% block titulo %}{{ "Editar" if funcionario else "Novo" }} funcionário{% endblock %}
{% block conteudo %}
<h1>{{ "Editar" if funcionario else "Novo" }} funcionário</h1>
{% if erro %}
<div class="mensagem danger">{{ erro }}</div>
{% endif %}
<form method="post" action="{{ '/funcionarios/' + funcionario.ID|string + '/editar' if funcionario else '/funcionarios/novo' }}">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<label for="nome">Nome</label>
<input type="text" id="nome" name="nome" value="{{ dados.NOME if dados else (funcionario.NOME if funcionario else '') }}" required>
<label for="login">Login</label>
<input type="text" id="login" name="login" value="{{ dados.LOGIN if dados else (funcionario.LOGIN if funcionario else '') }}" required>
{% if not funcionario %}
<label for="senha">Senha</label>
<input type="password" id="senha" name="senha" required>
<label for="confirmar_senha">Confirmar senha</label>
<input type="password" id="confirmar_senha" name="confirmar_senha" required>
{% endif %}
<button type="submit">Salvar</button>
</form>
{% if funcionario %}
<p><small>Para trocar a senha, use "Redefinir senha" na lista de funcionários.</small></p>
{% endif %}
{% endblock %}
+37
View File
@@ -0,0 +1,37 @@
<!-- app/templates/funcionarios_lista.html -->
{% extends "base.html" %}
{% block titulo %}Funcionários{% endblock %}
{% block conteudo %}
<h1>Funcionários</h1>
<p><a class="botao" href="/funcionarios/novo">+ Novo funcionário</a></p>
<table>
<tr><th>Nome</th><th>Login</th><th>Status</th><th></th></tr>
{% for f in funcionarios %}
<tr>
<td>{{ f.NOME }}</td>
<td>{{ f.LOGIN }}</td>
<td>{{ "Ativo" if f.ATIVO else "Inativo" }}</td>
<td>
<a class="botao" href="/funcionarios/{{ f.ID }}/editar">Editar</a>
<details style="display:inline-block">
<summary class="botao" style="display:inline-block;cursor:pointer">Redefinir senha</summary>
<form method="post" action="/funcionarios/{{ f.ID }}/redefinir-senha" style="margin-top:8px">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<label for="nova_senha-{{ f.ID }}">Nova senha</label>
<input type="password" id="nova_senha-{{ f.ID }}" name="nova_senha" required>
<label for="confirmar_nova_senha-{{ f.ID }}">Confirmar nova senha</label>
<input type="password" id="confirmar_nova_senha-{{ f.ID }}" name="confirmar_nova_senha" required>
<button type="submit">Salvar senha</button>
</form>
</details>
<form method="post" action="/funcionarios/{{ f.ID }}/alternar-ativo" style="display:inline">
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
<button type="submit" onclick="return confirm('{{ "Desativar" if f.ATIVO else "Reativar" }} este funcionário?')">
{{ "Desativar" if f.ATIVO else "Reativar" }}
</button>
</form>
</td>
</tr>
{% endfor %}
</table>
{% endblock %}