Cookest

Cookest is a full-stack meal planning and kitchen management platform built as a school project (PAP). A Rust REST API handles everything on the backend, a Flutter app runs on iOS and Android, and a Python pipeline seeds the recipe and ingredient database.

What's in these docs

Backend API

Rust · Actix-Web 4 · SeaORM — auth, endpoints, database schema, PDF pipeline

Mobile App

Flutter · Riverpod · GoRouter — screens, state management, design system

ETL Pipeline

Python — recipe and nutrition data ingestion from USDA and TheMealDB

Architecture

How the three components fit and communicate

User Guide

Using Cookest as an end user

Project layout

PAP/
  api/      — Rust backend (Actix-Web 4, SeaORM, PostgreSQL)
  UI/       — Flutter mobile app (Riverpod, GoRouter)
  etl/      — Python data pipeline
  dataset/  — Raw CSV dataset (MM-Food-100K)
  docs/     — This site

Tech at a glance

Layer	Stack
API	Rust · Actix-Web 4 · SeaORM · PostgreSQL 15
Auth	Argon2id · JWT access + refresh · HttpOnly cookies
AI	Ollama (llava for PDF vision, llama3.2 for chat)
Payments	Stripe — webhooks + Free / Pro / Family tiers
Mobile	Flutter 3 · Dart 3 · Riverpod · GoRouter
Data	Python · psycopg2 · USDA FoodData Central · TheMealDB

Available in English and Português.

Introduction