Sistema Culinário: Integração Total entre Backend e Aplicativos Móveis

O Sistema Culinário é um projeto completo de gestão de receitas desenvolvido por Rafael Marques Lins na Ad Rock Digital Mkt, com foco em experiência do usuário, API REST e integração entre backend e apps nativos iOS/Android.

Com avanço constante desde julho de 2025, o sistema já conta com funcionalidades completas de CRUD, upload inteligente de imagens, filtros avançados, API responsiva e aplicativos desenvolvidos com SwiftUI (iOS) e Kotlin + Jetpack Compose (Android).

Funcionalidades Implementadas

• Upload automático de imagens com exclusão da anterior

• Fallback de imagem padrão (default.jpg)

• Filtros por nome, tempo de preparo e dificuldade

• Paginação no frontend e admin

• API REST documentada e responsiva

• Autenticação de usuários e aprovação de receitas

• Validação de campos obrigatórios

Integração com Aplicativos

App iOS (SwiftUI)

• Navegação por home, detalhes e favoritos

• Consumo direto da API Flask

• Placeholder animado e fade-in em imagens

• Rodapé com contato e WhatsApp

• Otimizado para modo claro e escuro

App Android (Kotlin + Jetpack Compose)

• Cards responsivos com ícones dinâmicos

• Integração via Retrofit com a mesma API

• Estrutura visual semelhante ao iOS

• Rodapé dinâmico com dados da marca

Ambos os apps seguem padrões modernos de UI/UX, com foco em fluidez, consistência visual e performance.

Backend Flask + SQLite/MySQL

• Estrutura RESTful com Python 3.10+

• Banco de dados SQLite (dev) e MySQL (produção)

• Jinja2 + Bootstrap minimalista no frontend

• Migrations com Flask-Migrate e SQLAlchemy

• Estrutura modular e limpa

API REST:

• GET /api/receitas com filtros, paginação e busca

• GET /api/receitas/<id> com dados completos da receita

A documentação da API está disponível no repositório oficial.

Destaques Técnicos

• Estrutura 100% responsiva com filtros combinados

• Cards dinâmicos e uso de ícones (tempo, dificuldade, favoritos)

• Automação de exclusão de imagens antigas

• Layout padronizado e leve para web e apps

• Placeholder visual para receitas sem imagem

Instalação Local

# Clone o repositório
https://github.com/adrockmkt/sistema_culinario.git

# Ambiente virtual
python -m venv venv && source venv/bin/activate

# Instale dependências
pip install -r requirements.txt

# Migre banco e rode
flask db upgrade
flask run --port=5001

Acesse via navegador: http://localhost:5001

Apenas receitas com is_published = True aparecem no frontend.

Próximos Passos

• Melhorias de animação e navegação no app Android

• Splash screen e suporte a tema automático no iOS

• Ajustes de layout CSS nos componentes de paginação

• Integração futura com notificadores via e-mail ou push