Skip to content

phunga003/MyFirstSlopware

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NexusCloud

Revolutionizing B2B Commerce with AI-Powered, Cloud-Native Infrastructure

Built with Love Kubernetes License YC


The Vision

At NexusCloud, we're not just building software - we're reimagining the future of enterprise commerce. Our platform leverages cutting-edge microservices architecture, real-time event-driven systems, and next-gen observability to deliver an unparalleled B2B experience.

"We're like Shopify meets Stripe meets Datadog, but for the enterprise." - Founder, probably


Why NexusCloud?

  • Cloud-Native First - Built from the ground up on Kubernetes. Not retrofitted. Not "containerized legacy." Pure cloud-native DNA.
  • Event-Driven Architecture - Async message queuing with RabbitMQ for infinite scalability
  • Zero-Trust Security - JWT-based authentication, service mesh ready, network policies baked in
  • Developer Experience - One command deployment with Tilt. tilt up and you're live.
  • AI-Ready - Architecture designed for ML model integration (coming in Q3)

Architecture Overview

                                    ┌─────────────────┐
                                    │    Frontend     │
                                    │   (React/Vite)  │
                                    └────────┬────────┘
                                             │
                                    ┌────────▼────────┐
                                    │   API Gateway   │
                                    │   (Express.js)  │
                                    └────────┬────────┘
                                             │
              ┌──────────────────────────────┼──────────────────────────────┐
              │                              │                              │
     ┌────────▼────────┐          ┌─────────▼─────────┐         ┌─────────▼─────────┐
     │  Auth Service   │          │  Product Service  │         │ Notification Svc  │
     │    (Node.js)    │          │     (Node.js)     │         │    (Node.js)      │
     └────────┬────────┘          └─────────┬─────────┘         └─────────┬─────────┘
              │                              │                              │
              │                    ┌─────────▼─────────┐                    │
              │                    │   User Service    │                    │
              │                    │     (Node.js)     │                    │
              │                    └─────────┬─────────┘                    │
              │                              │                              │
     ┌────────▼────────────────────┬────────▼────────────────────┬────────▼────────┐
     │                             │                              │                 │
┌────▼─────┐                 ┌─────▼─────┐                 ┌──────▼──────┐         │
│ PostgreSQL│                 │   Redis   │                 │  RabbitMQ   │◄────────┘
│  (Data)   │                 │  (Cache)  │                 │  (Events)   │
└───────────┘                 └───────────┘                 └─────────────┘

Tech Stack

Layer Technology Why
Frontend React 18 + Vite + TailwindCSS Blazing fast, modern DX
API Gateway Express.js + http-proxy-middleware Flexible, extensible
Services Node.js 20 + Express Unified stack, easy hiring
Database PostgreSQL 15 Battle-tested, ACID compliant
Cache Redis 7 Sub-millisecond latency
Message Queue RabbitMQ 3.12 Enterprise-grade messaging
Container Runtime Docker + containerd Industry standard
Orchestration Kubernetes 1.28+ The only choice for serious companies
Local Dev Tilt Hot reload for K8s

Quick Start

Prerequisites

  • Docker Desktop with Kubernetes enabled
  • Tilt installed
  • kubectl configured
  • 8GB+ RAM recommended

One-Command Deploy

# Clone the repo
git clone https://github.com/nexuscloud/nexuscloud-platform.git
cd nexuscloud-platform

# Launch everything
./scripts/setup.sh

# Or if you're a power user
tilt up

That's it. Open http://localhost:3000 and experience the future.


Service Endpoints

Service Internal Port External Port Description
Frontend 3000 3000 React Dashboard
API Gateway 8080 8080 Unified API Entry
Auth Service 3001 - Authentication & JWT
User Service 3002 - User Management
Product Service 3003 - Product Catalog
Notification Service 3004 - Email & Messaging

Project Structure

nexuscloud/
├── services/
│   ├── api-gateway/          # API routing & rate limiting
│   ├── auth-service/         # JWT auth, login, registration
│   ├── user-service/         # User profiles & management
│   ├── product-service/      # Product catalog & inventory
│   ├── notification-service/ # Emails, webhooks, alerts
│   └── frontend/             # React SPA
├── test-machines/
│   ├── internal-user/        # Employee simulation & tests
│   └── public-user/          # Customer & security tests
├── k8s/
│   ├── base/                 # Base Kubernetes manifests
│   ├── overlays/             # Kustomize overlays (dev/prod)
│   └── test-jobs/            # Test runner Kubernetes Jobs
├── infrastructure/
│   ├── postgres/             # Database configs
│   ├── redis/                # Cache configs
│   └── rabbitmq/             # Message queue configs
├── scripts/                  # Setup & utility scripts
├── Tiltfile                  # Tilt configuration
└── skaffold.yaml            # Alternative: Skaffold config

Testing

NexusCloud includes comprehensive test machines that simulate real users:

Test Machines

Machine Description Tests
Internal User Simulates employee behavior Auth, profiles, teams, messaging, products
Public User Simulates customer + security probing Registration, browsing, boundary testing, security

Running Tests

# Run all tests (single command!)
./scripts/run-tests.sh

# Run specific test suite
./scripts/run-tests.sh internal    # Internal user tests only
./scripts/run-tests.sh public      # Public user tests only

# Run on Kubernetes as Jobs
kubectl apply -f k8s/test-jobs/all-tests-job.yaml

# Watch test progress
kubectl logs -n nexuscloud -l app=test-runner -f

# Using Tilt (click 'run-tests' in UI or):
tilt trigger run-tests

What the Tests Cover

Internal User Tests:

  • Service health checks
  • User registration and authentication
  • Profile management
  • Team creation and membership
  • Product catalog browsing and reviews
  • Internal messaging and notifications
  • WebSocket connectivity
  • Debug endpoint exposure

Public User Tests:

  • Public catalog access (no auth)
  • Customer registration flow
  • Multi-user messaging
  • Boundary conditions (invalid inputs, edge cases)
  • Security probing:
    • SQL injection attempts
    • XSS payload handling
    • Unauthorized access attempts
    • JWT manipulation
    • Rate limiting verification
    • CORS configuration checks

Security

NexusCloud implements industry-standard security practices:

  • JWT-based stateless authentication
  • Password hashing with bcrypt
  • Kubernetes Network Policies
  • Non-root container execution
  • Secrets management via K8s Secrets
  • CORS configuration
  • Rate limiting on API Gateway

Note: This is a development/demo environment. Additional hardening recommended for production.


Roadmap

  • Core microservices architecture
  • Kubernetes deployment
  • Local development with Tilt
  • GraphQL Federation
  • OpenTelemetry integration
  • AI-powered product recommendations
  • Multi-tenant support
  • SOC2 compliance

Contributing

We're building in public. PRs welcome.

# Run all tests
./scripts/run-tests.sh

# Deploy platform
./scripts/setup.sh

# Tear down
./scripts/teardown.sh

The Team

Built by a passionate team of engineers who believe enterprise software doesn't have to suck.

Backed by Y Combinator, a]16z Scout, and angels who believe in the vision.


License

MIT License - Build something amazing.


NexusCloud - Enterprise Commerce, Reimagined
WebsiteDocsTwitter

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •