How andresdelossantos99/tagpets works
PetTag is a planned mobile-first storefront for personalized pet tags, with a NestJS API and PostgreSQL. The documented customer journey is browse categories, personalize a tag, keep the cart in the frontend, then checkout; checkout revalidates products, stock, personalization and totals, obtains shipping, creates an order and payment preference, and payment is confirmed by webhook. Admins manage categories and orders. The tree contains only a small NestJS categories implementation; frontend, checkout, orders, payments and shipping are documented capabilities, not sampled code. Their wiring below reflects README documentation, not inspected implementation.
Main entry points: categories.controller.ts Category endpoints · categories.service.ts Category operations · app.module.ts API composition · prisma.service.ts Prisma service
Components 17
Storefront
- Storefront and cart
Commerce workflow
- Checkout validation
- Product and stock
- Shipping quote
- Order creation
- Payment preference
- Payment webhook
NestJS API
- Category endpoints
backend/src/categories/categories.controller.ts - Category operations
backend/src/categories/categories.service.ts - API composition
backend/src/app.module.ts - API bootstrap
backend/src/main.ts
Persistence
- Prisma service
backend/src/prisma/prisma.service.ts - PostgreSQL
backend/prisma/schema.prisma
Other components
- Customer
- Administrator
- Mercado Pago
- Shipping provider
Connections 17
- Customer → Storefront and cart: browses and configures
- Storefront and cart → Category endpoints: requests categories
- Storefront and cart → Checkout validation: submits cart
- Administrator → Category endpoints: manages categories
- API bootstrap → API composition: starts
- API composition → Category endpoints: registers
- Category endpoints → Category operations: calls
- Category operations → Prisma service: queries categories
- Prisma service → PostgreSQL: reads and writes
- Checkout validation → Product and stock: validates items and stock
- Checkout validation → Shipping quote: requests quote
- Checkout validation → Order creation: creates order
- Checkout validation → Payment preference: creates preference
- Shipping quote → Shipping provider: requests quote
- Payment preference → Mercado Pago: creates preference
- Mercado Pago → Payment webhook: sends payment event
- Payment webhook → Order creation: confirms payment state