81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
## Sistema de Cadastro de Rostos com Flask
|
|
|
|
Este projeto é um sistema simples desenvolvido em Flask para cadastrar e listar rostos. Ele permite que imagens de rostos sejam carregadas, exibidas em uma interface web e enviadas para uma API de cadastro. A aplicação também oferece uma navegação paginada para visualizar as imagens de rostos cadastradas.
|
|
|
|
## Funcionalidades
|
|
|
|
- [ ] Página inicial: Redireciona automaticamente para a lista de rostos cadastrados.
|
|
- [ ] Listagem de rostos: Exibe as imagens dos rostos cadastrados com suporte à paginação.
|
|
- [ ] Cadastro de rostos: Permite que o usuário selecione um ou mais rostos e associe-os a um nome. As imagens selecionadas são enviadas para uma API externa para o cadastro.
|
|
- [ ] Exibição de imagens: Permite a exibição das imagens cadastradas diretamente na aplicação.
|
|
|
|
## Requisitos
|
|
Python 3.6 ou superior
|
|
Flask
|
|
Requests
|
|
|
|
Instalando dependências
|
|
|
|
Clone o repositório:
|
|
|
|
``
|
|
git clone <url_do_repositorio>
|
|
cd <diretorio_do_repositorio>
|
|
``
|
|
|
|
## Crie um ambiente virtual:
|
|
|
|
``
|
|
python3 -m venv venv
|
|
source venv/bin/activate # No Windows use: venv\Scripts\activate
|
|
``
|
|
|
|
Instale as dependências:
|
|
|
|
``
|
|
pip install -r requirements.txt
|
|
``
|
|
|
|
## Estrutura do projeto
|
|
|
|
- [ ] app.py: Arquivo principal que contém a aplicação Flask e suas rotas.
|
|
- [ ] folder/faces/: Diretório que contém as imagens dos rostos.
|
|
- [ ] templates/: Diretório contendo os arquivos HTML para as páginas da aplicação.
|
|
- [ ] static/: Diretório para arquivos estáticos (caso necessários).
|
|
|
|
## Rotas
|
|
|
|
/
|
|
- [ ] Redireciona para a rota /listar_rostos.
|
|
/listar_rostos
|
|
- [ ] Exibe uma lista paginada das imagens de rostos cadastradas.
|
|
/listar_rostos/page/<int:page>
|
|
- [ ] Exibe a página solicitada da lista de rostos cadastrados.
|
|
/cadastrar_pessoas
|
|
- [ ] Exibe um formulário para cadastrar rostos.
|
|
Requer que o usuário selecione ao menos uma imagem e forneça um nome.
|
|
- [ ] As imagens selecionadas são enviadas para a API de cadastro.
|
|
/faces/<filename>
|
|
Exibe a imagem de rosto solicitada.
|
|
|
|
## Como rodar a aplicação
|
|
Certifique-se de que todas as dependências estão instaladas.
|
|
|
|
Execute o servidor Flask:
|
|
|
|
``
|
|
python app.py
|
|
``
|
|
Acesse a aplicação em http://localhost:5001 no seu navegador.
|
|
|
|
## Configuração
|
|
- [ ] FOLDER_PATH: Caminho para o diretório onde as imagens de rostos estão armazenadas.
|
|
- [ ] API_URL: URL da API de cadastro de rostos. Certifique-se de que a API esteja rodando na URL fornecida.
|
|
- [ ] FILES_PER_PAGE: Define o número de arquivos exibidos por página na listagem.
|
|
|
|
## Contribuição
|
|
- [ ] Faça um fork deste repositório.
|
|
- [ ] Crie uma branch para sua alteração (git checkout -b feature/novo-recurso).
|
|
- [ ] Faça suas modificações e commit (git commit -am 'Adicionando novo recurso').
|
|
- [ ] Envie para o repositório remoto (git push origin feature/novo-recurso).
|
|
- [ ] Abra um Pull Request. |