Case study 03 / Full-stack delivery
Coordinating commerce workflows across data, services, and deployment
Michael built and deployed a full-stack commerce product, then changed its hosting architecture when self-hosting created an impractical maintenance model for the intended operating environment.
- Next.js
- PostgreSQL
- Neon
- Vercel
- Stripe
- USPS
- Resend
- Docker
Problem
The project needed to coordinate a complete small-business commerce flow: catalogue management, customer authentication, persistent carts, checkout, address validation, orders, inventory administration, content controls, and transactional email.
The first deployment design used separate application and PostgreSQL containers. The intended operating environment did not have suitable hardware or a practical maintenance model for reliable self-hosting.
Constraints
The system had to maintain state across anonymous and authenticated sessions while coordinating database writes and several external services. Its deployment also needed to avoid adding server maintenance, database administration, backups, availability, and hardware support to day-to-day storefront operations.
- Persist guest and account-associated carts across sessions.
- Keep customer and administrative workflows separated.
- Coordinate Stripe, USPS address validation, and Resend email responsibilities.
- Retain a Docker option while reducing day-to-day operational burden.
Investigation and decisions
Michael evaluated the operational cost of keeping the container-first deployment against managed hosting. He chose Vercel for the Next.js application and Neon for PostgreSQL, accepting greater platform dependency and less infrastructure control in exchange for simpler maintenance and removal of the immediate hardware requirement.
Within the application, external integrations were kept separated by responsibility: Stripe for payment processing, USPS for shipping-address validation, Resend for transactional email, and PostgreSQL for persistent commerce data.
Solution
Michael delivered a responsive storefront and administrative interface with catalogue, authentication, persistent guest and account carts, checkout, orders, inventory and product administration, customer-facing content controls, basic sales analytics, and transactional email.
The deployed architecture uses Next.js on Vercel with Neon PostgreSQL and retains Docker support for development or a future containerized deployment.
Verification and result
The application is publicly deployed as a functional demonstration. Its primary workflows have been manually exercised, including product browsing, cart persistence, authentication, USPS address validation, Stripe test-mode checkout, order creation, administrative product management, transactional email delivery, and responsive layouts.
Current limitations
The project has not moved into active store operations. Stripe remains in test mode, no real customer payments are processed, and there is no meaningful production transaction volume. Current analytics therefore do not establish commercial usage or business outcomes.
- Automated test coverage has not yet been implemented.
- The multi-business configuration is not fully generalized.
- Reporting and inventory tools can be expanded.
- The deployment depends on external managed platforms and may require migration work if hosting requirements change.