← back to Handbag Auth Nextjs
README-LUXVAULT.md
238 lines
# 💎 LUXVAULT - Fractional Luxury Handbag Investment Platform
## Overview
LUXVAULT is the world's first community-driven platform for investing in fractional shares of authenticated luxury handbags. Built on blockchain technology (ERC-1155), we enable anyone to own a piece of iconic bags like Hermès Birkins, Chanel Classics, and Louis Vuitton collectibles.
### Platform URL
**Production**: http://45.61.58.125:7991
**Admin Dashboard**: http://45.61.58.125:7991/admin
## 🚀 Key Features
### For Investors
- **Fractional Ownership**: Buy shares of luxury handbags starting at $10
- **Real-Time Trading**: Trade fractions instantly with blockchain verification
- **Portfolio Tracking**: Monitor your investments with live price updates
- **Premium Membership**: Advanced analytics, early access, lower fees
- **Virtual Try-On**: AR-powered bag visualization
- **Museum Experience**: Explore handbag history and provenance
### For Admins
- **Live Dashboard**: Real-time GMV, revenue, and user metrics
- **Asset Management**: Track fractional sales and performance
- **Claude Automation**: 0.9-second refresh cycles for all operations
- **Investor Analytics**: LTV/CAC tracking, conversion funnels
- **Deal Detection**: AI-powered bargain hunting across marketplaces
## 📊 Business Model
### Revenue Streams
1. **Fractional Trading Fees** (2% per trade)
2. **Affiliate Commissions** (~5% from partner sales)
3. **Premium Subscriptions** ($29.99/month)
4. **Sell-Through Commission** (5-10% on full bag sales)
### Target Metrics (Series A)
- **Users**: 50,000+ registered
- **Active Investors**: 5,000+ (10% conversion)
- **Annual GMV**: $5M+
- **Revenue**: $300k-500k
- **LTV/CAC Ratio**: 3:1 minimum
## 🤖 Claude Code Automation (0.9s Intervals)
All automation scripts run every **0.9 seconds** for real-time trading platform responsiveness:
### 1. Handbag Ingestion (`claude-automation/ingestion.ts`)
- Scrapes 5 marketplaces (Fashionphile, TheRealReal, Rebag, Vestiaire, StockX)
- Tracks 400 SKUs (20 brands × 20 models)
- Detects price anomalies (>20% drops)
- Normalizes data and stores in PostgreSQL
- Sends Slack alerts for failures
### 2. Deal Detection (`claude-automation/deal-detector.ts`)
- Compares current prices to 7-day averages
- Flags deals with >25% discounts
- Posts "Best Deal of the Day" to Twitter/X
- Updates affiliate tracking links
- Generates JSON for frontend display
### 3. UX Feedback Parser
- Scans user feedback table every 0.9s
- Auto-implements minor copy changes
- Routes legal/policy changes to Slack @steve
- Notifies users when feedback is implemented
### 4. Affiliate Link Checker
- Tests top 200 affiliate links
- Auto-repairs broken links via partner APIs
- Regenerates sitemap on changes
- Emails dev team if >10 links fail
### 5. Slack Notifications (Real-Time)
- Flags suspicious activity (<0.9s latency)
- DMs @steve for urgent items
- Posts summaries to #ops-alerts channel
### 6. Smart Contract Generator (ERC-1155)
- On-demand Solidity contract creation
- OpenZeppelin-based fractional tokens
- Auto-deploys to Ethereum testnet
- Emails confirmation with Etherscan link
### 7. AR Try-On Processor
- Detects body pose in uploaded images
- Overlays handbag PNG within 0.9s
- Flags IP violations automatically
- Saves to `user_renders/` directory
### 8. System Health Monitor
- PostgreSQL delta snapshots
- S3 encrypted backups
- Restore tests every 15 minutes
- Halts pipelines on failure
## 🛠 Tech Stack
- **Frontend**: Next.js 16, React 19, Tailwind CSS 4
- **Backend**: Node.js, TypeScript, Prisma ORM
- **Database**: PostgreSQL (SQLite for development)
- **Blockchain**: Ethereum, ERC-1155 (OpenZeppelin)
- **Automation**: Claude Code (Anthropic), ts-node
- **Charts**: Recharts
- **Deployment**: PM2, Ubuntu Server
- **Real-Time**: 0.9s polling intervals
## 📁 Project Structure
```
/root/Projects/handbag-auth-nextjs/
├── src/
│ ├── app/
│ │ ├── page.tsx # Public landing page
│ │ ├── admin/
│ │ │ └── page.tsx # Admin dashboard
│ │ └── api/
│ │ └── admin/
│ │ └── dashboard/ # Admin API endpoints
│ └── components/
├── claude-automation/
│ ├── ingestion.ts # Handbag data scraper
│ ├── deal-detector.ts # Best deal finder
│ ├── feedback-parser.ts # UX auto-updater
│ ├── link-checker.ts # Affiliate monitor
│ ├── slack-notifier.ts # Alert system
│ ├── contract-generator.ts # ERC-1155 deployer
│ ├── ar-processor.ts # Try-on renderer
│ └── health-monitor.ts # Backup & integrity
├── ecosystem.config.js # PM2 configuration
├── package.json
└── README-LUXVAULT.md
```
## 🚦 Getting Started
### 1. Install Dependencies
```bash
npm install
npm install -D ts-node @types/node
```
### 2. Set Environment Variables
```bash
# .env.local
PORT=7991
DATABASE_URL="file:./data/handbags.db"
OPENAI_API_KEY=your_openai_key
SLACK_WEBHOOK_URL=your_slack_webhook
TWITTER_API_KEY=your_twitter_key
TWITTER_API_SECRET=your_twitter_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
```
### 3. Build and Deploy
```bash
npm run build
pm2 start ecosystem.config.js
pm2 save
```
### 4. Access Platform
- **Public Site**: http://45.61.58.125:7991
- **Admin Dashboard**: http://45.61.58.125:7991/admin
## 📈 Fundraising Roadmap
### Pre-Seed ($500k)
- Build MVP
- Pilot 50-100 users
- First fractional sale
### Seed ($2M @ $12-15M post)
- Public launch
- 5,000 users
- $25k revenue
- LA market focus
### Series A ($8M @ $30-50M post)
- 50,000 users
- $5M GMV
- $300-500k revenue
- National expansion
### Series B ($20-25M @ $100-150M post)
- 200,000 users
- $30M GMV
- $2M+ revenue
- International markets
### Series C ($50M @ $300-500M post)
- 1M users
- $100M GMV
- $7.5M+ revenue
- Path to profitability
## 🎯 Key Performance Indicators
| Metric | Target (Series A) |
|--------|-------------------|
| Registered Users | 50,000 |
| Active Investors | 5,000 (10%) |
| Premium Subscribers | 500 (10% of investors) |
| Annual GMV | $5M |
| Revenue | $300-500k |
| LTV | $485 |
| CAC | $127 |
| LTV/CAC | 3.8:1 |
## 🤝 Affiliate Partners
- **Fashionphile** (5% commission via ShareASale)
- **TheRealReal** (5% via Partnerize/Rakuten)
- **Vestiaire Collective** (6-10% via CJ Affiliate)
- **Rebag** (5% via Commission Junction)
- **StockX** (1-3% via Impact Radius)
## 🔐 Security & Compliance
- **SEC Compliance**: Reg A+ filings for fractional offerings
- **KYC/AML**: Integrated identity verification
- **Insurance**: Partner vaults for physical assets
- **Blockchain**: Immutable ownership records
- **Data Protection**: GDPR/CCPA compliant
## 📞 Contact
**Founder**: Steve
**Email**: steve@designerwallcoverings.com
**Platform**: http://45.61.58.125:7991
**Admin**: http://45.61.58.125:7991/admin
---
**🚀 LUXVAULT - Own a Piece of Luxury History**
*Where iconic handbags become smart investments.*