https://github.com/marviniciuz/flask-restaurant

Mini api de restaurante em flask
https://github.com/marviniciuz/flask-restaurant

api flask flask-api flask-application htmx materializecss python python3 sqlalchemy sqlite

Last synced: 3 months ago
JSON representation

Mini api de restaurante em flask

• Host: GitHub
• URL: https://github.com/marviniciuz/flask-restaurant
• Owner: marviniciuz
• Created: 2025-11-25T00:37:09.000Z (7 months ago)
• Default Branch: master
• Last Pushed: 2025-11-30T05:08:09.000Z (7 months ago)
• Last Synced: 2025-12-02T09:11:19.737Z (7 months ago)
• Topics: api, flask, flask-api, flask-application, htmx, materializecss, python, python3, sqlalchemy, sqlite
• Language: HTML
• Homepage:
• Size: 6.84 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

          
# 🍽️ Flask Restaurant control

Um sistema de gestão de restaurantes leve e simples, desenvolvido com **Flask** e **HTMX**.

O objetivo deste projeto é demonstrar como criar aplicações web interativas e responsivas utilizando **Server-Side Rendering (SSR)**, eliminando a complexidade de frameworks JavaScript pesados (como React/Vue) para operações CRUD simples.

![Badge Concluído](http://img.shields.io/static/v1?label=STATUS&message=CONCLUIDO&color=GREEN&style=for-the-badge)

![Badge Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=for-the-badge&logo=python)

![Badge Flask](https://img.shields.io/badge/Flask-2.0%2B-lightgrey?style=for-the-badge&logo=flask)

![Badge HTMX](https://img.shields.io/badge/HTMX-1.9-orange?style=for-the-badge)

## 🛠️ Tecnologias Utilizadas no projeto

* **Back-end:** Python, Flask, SQLAlchemy (SQLite).

* **Front-end:** HTML5, Materialize CSS (Design Responsivo).

* **Interatividade:** HTMX (Requisições AJAX declarativas direto no HTML).

* **Testes:** Pytest, Pytest-HTML.

## ✨ Funcionalidades

* ✅ **Cadastro de Restaurantes:** Adição sem recarregar a página.

* ✅ **Busca em Tempo Real:** Filtragem dinâmica (`debounce`) enquanto digita.

* ✅ **Exclusão:** Remoção de itens da lista via requisição DELETE.

* ✅ **Banco de Dados:** Persistência automática em SQLite.

## 🚀 Como Rodar o Projeto

### Pré-requisitos

* Python 3.x instalado.

### Passo a Passo

1.  **Clone o repositório**

    ```bash

    git clone [https://github.com/SEU-USUARIO/NOME-DO-REPO.git](https://github.com/SEU-USUARIO/NOME-DO-REPO.git)

    cd NOME-DO-REPO

    ```

2.  **Crie o ambiente virtual**

    ```bash

    # Linux/Mac

    python3 -m venv venv

    source venv/bin/activate

    # Windows (PowerShell)

    python -m venv venv

    .\venv\Scripts\Activate

    ```

3.  **Instale as dependências**

    ```bash

    pip install -r requirements.txt

    ```

4.  **Execute:**

    ```bash

    python app.py

    ```

    O servidor iniciará em `http://127.0.0.1:5000`.

## Testes 

O projeto conta com testes de integração utilizando **Pytest**.

Para rodar os testes simples:

```bash

pytest

```