Sign inSign up
polpa-gestao-api logo

rmcampos/polpa-gestao-api

By rmcampos

•Updated 4 months ago

Fastify + PostgreSQL API for Polpa Go — customers, POS, products, sales, routes

Image
Buildkit cache
0

1.9K

rmcampos/polpa-gestao-api repository overview

⁠Polpa Go — Backend API

The API service for Polpa Go, a full-stack business management application for handling customers, points-of-sale (POS), products, sales, and delivery routes.

This image contains the Node.js 22 + Fastify 5 + TypeScript backend, using PostgreSQL 15 with Prisma ORM. It powers the Polpa Go frontend⁠ and exposes a JWT-authenticated REST API.

⁠Features

  • Customer and POS management, including multiple POS locations per customer
  • Product catalog with pricing, cost, and stock, automatically kept in sync with sales
  • Sales transactions with delivery status, payment methods, due dates, and comments
  • Delivery route planning by day of week, linked to customer POS locations
  • Dashboard analytics endpoints
  • User management with role-based access control secured by JWT

⁠Tech Stack

LayerTechnology
BackendNode.js 22, Fastify 5, TypeScript
DatabasePostgreSQL 15 with Prisma ORM

⁠Quick Start

This image expects a PostgreSQL 15 database and runs Prisma migrations automatically on startup. It's designed to run as part of the full Polpa Go stack via Docker Compose:

docker compose up

By default the API listens on port 3000.

⁠Tags

  • latest — most recent build from the main branch
  • Full setup instructions (Taskfile, Doppler secrets, Docker Compose, Terraform deployment): see the project source repository
  • Frontend image⁠

Tag summary

Content type

Image

Digest

sha256:abc6b2d84…

Size

180.4 MB

Last updated

4 months ago

docker pull rmcampos/polpa-gestao-api