How henriquebragamoreira/gesture-pro works
Project type and purpose
• This is a full-stack web application named “Gesture Pro,” composed of:
• A backend API written in Python using FastAPI
• A frontend web client written in TypeScript using Next.js
• Purpose: CRUD operations and dashboard for managing categories, products and sales data.
File structure
• Top-level folders:
• api/ – FastAPI backend, with routers, models, schemas, database setup, Docker Compose
• web/ – Next.js frontend, with components, pages (app directory), services, hooks, styles
• Backend patterns:
• api/routers → endpoint grouping (categories, products, sales, dashboard)
• api/models & schemas → data models and validation
• api/database.py + database_setup.sql → PostgreSQL setup
• api/docker-compose.yaml → container orchestration
• Frontend patterns:
• app/(app) → Next.js 13 App Router, feature folders (categories, products, dashboard)
• components/ui → shared UI primitives
• services/* → API client wrappers (ky + TanStack Query)
• hooks & utils → cross-cutting concerns (pagination, debounce)
README for additional insights
• Tech stack: Python 3.8+, FastAPI, PostgreSQL, Docker Compose; Next.js 13+, pnpm
• Workflow:
• Start PostgreSQL via Docker Compose
• Seed DB with SQL & Python script
• Run backend (Uvicorn) on port 8000
• Run frontend (pnpm dev) on port 3000
• Interactive Swagger UI for API testing and standard lint/type checks for frontend