Phase 1: Application Startup

Goal: Verify the application starts correctly and serves the homepage.

1.1 Check Application Logs

In your Ring Platform directory

npm run dev

Expected output:

▲ Next.js 15.x.x
- Local:        http://localhost:3000
- Environments: .env.local
- Ready - started server on 0.0.0.0:3000

❌ Common Issues:

• "Port 3000 already in use" → Kill other processes: lsof -ti:3000 | xargs kill
• "Module not found" → Run npm install to install dependencies
• "Database connection failed" → Check database credentials in .env.local

1.2 Test Homepage Access

Test HTTP response

curl -I http://localhost:3000

Expected: HTTP/1.1 200 OK

Test page content

curl -s http://localhost:3000 | head -20

Expected: HTML content with Ring Platform branding

1.3 Browser Validation

1. Open http://localhost:3000 in your browser
2. Verify the page loads without JavaScript errors
3. Check browser console (F12) for any error messages
4. Confirm the Ring Platform logo and hero section appear

Phase 2: Authentication System

Goal: Verify Auth.js v5 setup and OAuth providers work correctly.

2.1 Test Authentication Page

Visit http://localhost:3000/login

Expected:

• Clean login page with provider buttons
• No JavaScript errors in console
• Responsive design on mobile/desktop

2.2 Google OAuth Flow

1. Click "Sign in with Google"
2. Complete Google OAuth flow
3. Verify redirect to dashboard/profile page
4. Check session persistence (refresh page)

Validation Commands: Test OAuth callback endpoint Expected: HTTP/1.1 302 Found (redirect)

curl -I "http://localhost:3000/api/auth/callback/google"

2.3 Session Validation

API Test: Test session endpoint

curl -X GET "http://localhost:3000/api/auth/session" -H "Cookie: $(curl -c cookies.txt -b cookies.txt http://localhost:3000/api/auth/session | grep -o 'next-auth.session-token=[^;]*')"

Expected Response:

"user": {
  "id": "user-id",
  "name": "User Name",
  "email": "user@example.com",
  "image": "https://...",
  "role": "MEMBER"
},
"expires": "2025-..."
}

2.4 Profile Access

1. Visit /profile or /[locale]/profile
2. Verify user information displays correctly
3. Check profile picture loads from Google
4. Confirm logout functionality works

Phase 3: Database Connectivity

Goal: Verify database operations work correctly.

3.1 API Health Check

Test health endpoint

curl http://localhost:3000/api/health

Expected Response:

"status": "ok",
"timestamp": "2025-10-16T...",
"database": "connected",
"version": "0.9.18"
}

3.2 Entities System

Create Test Entity:

1. Visit http://localhost:3000/entities
2. Click "Create Entity" or "Add Entity"
3. Fill form: Name, Type, Description
4. Submit and verify entity appears in list

API Validation: List entities Expected: Array of entities or empty array

curl "http://localhost:3000/api/entities"

3.3 Database Connection Test

PostgreSQL Test: Direct database test (if using local PostgreSQL) Expected: Count >= 1 (your user account)

psql -h localhost -U ring_user -d ring_platform -c "SELECT COUNT(*) FROM users;"

Firebase Test (if using Firebase): Test Firestore connection Expected: Success message

curl "http://localhost:3000/api/test-db"

Phase 4: Core Features

Goal: Validate opportunities, messaging, and real-time features.

4.1 Opportunities System

1. Visit http://localhost:3000/opportunities
2. Verify opportunities list loads
3. Create a test opportunity
4. Test search and filtering

API Test: Test opportunities endpoint

curl "http://localhost:3000/api/opportunities?limit=5"

Expected: Array of opportunities or empty array

4.2 Real-time Features

WebSocket Test: Test tunnel transport endpoint

curl -X POST "http://localhost:3000/api/tunnel/test" -H "Content-Type: application/json" -d '{"test": "connection"}'

Notification Test:

1. Create an opportunity (triggers notification)
2. Verify notification appears in real-time
3. Check notification count in UI

4.3 Messaging System (Optional)

1. Visit messaging interface
2. Start a conversation
3. Send test messages
4. Verify real-time delivery

Phase 5: Web3 & Wallet Features

Goal: Validate blockchain integration and wallet functionality.

5.1 Wallet Creation

1. Visit /profile or /wallet
2. Check if wallet is auto-created
3. Verify wallet address display

API Test: Test wallet endpoint Expected: Wallet balance information

curl "http://localhost:3000/api/wallet/balance"

5.2 MetaMask Integration (Optional)

1. Install MetaMask extension
2. Connect wallet to Ring Platform
3. Test wallet operations
4. Verify transaction signing

5.3 RING Token Features (Optional)

1. Check token balance display
2. Test token transfer functionality
3. Verify transaction history