Back to projects
E-commerce Private repositoryIn development
E-commerce with Clean Architecture
E-commerce platform built with Clean Architecture: catalog, cart, orders and Yape payments.
- Type
- E-commerce
- Database
- PostgreSQL
- Data models
- 23 models in PostgreSQL
- Status
- In development
What it solves
An online store needs a catalog, reliable stock, orders that don't get stuck and a payment method its audience actually uses. The system covers the full flow, including Yape payments with manual review.
Key features
- Catalog with categories, products and images; inventory with stock movements.
- Cart and orders with status history and automatic expiration.
- Yape payments with manual review.
- Customer profiles, addresses and newsletter subscription.
- Password recovery with a single-use token.
- Admin panel and public storefront.
Architecture and technical decisions
- Modular monolith with Clean Architecture per module: domain, application, infrastructure and presentation.
- Authentication with Argon2, access and refresh tokens with rotation; refresh tokens are stored hashed and reuse is blocked.
- Roles and permissions with guards, plus Helmet, CORS and rate limiting.
- NestJS with Prisma on PostgreSQL 16; images on Cloudinary; Swagger.
- CI on GitHub Actions with lint, build, unit and e2e tests; multi-stage Docker image.
- Storefront in Next.js 16 with React 19 and admin panel in Angular 22.