Commerce Platform

Production-oriented commerce application demonstrating server-side rendering, progressive enhancement, authentication, authorization, automated testing, and cloud deployment.

Built with TypeScript, Express, PostgreSQL, Prisma, React Islands, Docker, Nginx, and GitHub Actions.

Resources

Architecture Overview

The application uses server-side rendering as the primary delivery model. React is introduced only where interactivity is required, allowing pages to remain fast, SEO-friendly, and progressively enhanced.

Browser
   │
Nginx Reverse Proxy
   │
Express Application
   │
   ├── SSR Pages (Nunjucks)
   ├── API Routes
   ├── React Islands
   │
Middleware Pipeline
   │
   ├── Request Logging
   ├── Session Authentication
   ├── Role-Based Access Control
   ├── Error Handling
   │
Router
   │
   ├── Route Definitions
   ├── Controller Dispatch
   │
Controller
   │
   ├── Request / Response Handling
   ├── Input Processing
   ├── Service Coordination
   │
Service Layer
   │
   ├── Business Logic
   │
Prisma ORM
   │
   ├── Data Access & Database Mapping
   ├── Query Construction
   │
PostgreSQL

Production Infrastructure

Oracle Cloud VPS deployment
Nginx reverse proxy
HTTPS with Let's Encrypt
Dockerized application services
GitHub Actions CI/CD workflows
Structured request logging
Environment-based configuration management

Core Capabilities

Authentication & Authorization

Session-based authentication with role-based access control supporting both user and administrative workflows.

Data Layer

PostgreSQL with Prisma ORM, schema migrations, validation using Zod, and centralized error handling.

Testing

Automated integration testing with Jest and Supertest covering application behavior and API endpoints, running in an isolated containerized enviornment.

Progressive Enhancement

Pages are rendered on the server and selectively enhanced with React islands where richer interactivity is beneficial.

Project Goals

This project serves as a portfolio and learning exercise focused on building production-oriented web applications.

The present emphasis is on architecture, maintainability, deployment, testing, and long-term scalability.

Current Status

Active development.

The core architecture, authentication system, authorization model, database layer, deployment pipeline, and testing infrastructure are complete.

Current work focuses on expanding commerce-specific functionality including storefront experiences, shopping carts, order workflows, and additional administrative tooling.