Professional Networking Platform with Web3 Integration
Ring Platform is a comprehensive professional networking solution that connects businesses, professionals, and opportunities through a sophisticated entity-based system with confidential access tiers.
Ring Platform serves as a professional networking hub where entities (companies, organizations, startups) can showcase their profiles, post opportunities, and connect with qualified professionals. The platform features a unique confidential access system that creates exclusive networking spaces for authorized businesses and professionals.
Entities represent professional organizations within the Ring Platform ecosystem:
- 26 Industry Types: Technology, Finance, Healthcare, Manufacturing, Consulting, etc.
- Visibility Tiers: Public → Subscriber → Member → Confidential access levels
- Rich Profiles: Company information, team details, achievements, certifications
- Social Integration: News articles, updates, and professional content
- Verification System: Enhanced credibility through verification processes
Ring Platform supports a sophisticated dual-nature opportunity system:
Opportunity Types:
- Offers: Traditional job postings, service offerings, partnership proposals
- Requests: Seeking services, talent acquisition, collaboration requests
Access Tiers:
- Public: Open to all platform users
- Subscriber: Requires platform subscription
- Member: Entity membership required
- Confidential: Exclusive access for confidential members only
Key Features:
- Budget ranges and compensation details
- Location flexibility (remote, hybrid, onsite)
- Expiration management and renewal
- Application tracking and management
- Advanced filtering and search capabilities
Ring Platform implements a tiered access model for professional networking:
Access Levels:
- Visitor: Basic platform browsing
- Subscriber: Enhanced access to content and opportunities
- Member: Entity membership with posting privileges
- Confidential: Premium tier with exclusive access
- Admin: Platform administration and management
CONFIDENTIAL Account Status:
- Confidential users can create confidential entities
- Confidential entities can create confidential opportunities on behalf of their organization
- Exclusive Content: Confidential opportunities typically contain C-level positions, stealth startups, M&A activities, strategic partnerships, and investment opportunities
- Enhanced Security: Confidential entities are only visible to confidential members, and confidential opportunities are only visible to confidential members
- Business Value: Creates an exclusive area of information exchange for authorized businesses and professionals, facilitating high-level networking, executive recruitment, strategic partnerships, and investment opportunities
- Frontend: Next.js 15.3.3, React 19, TypeScript 5.8.2
- Authentication: NextAuth.js v5 with multiple providers
- Database: Firebase Firestore with real-time capabilities
- Styling: Tailwind CSS with custom design system
- File Storage: Vercel Blob for scalable file management
- Deployment: Vercel with edge functions and global CDN
- Status Pages: Unified dynamic routing with [action]/[status] pattern
- Authentication: Enhanced useAuth hook with type-safe role checking and status page integration
- Real-time: WebSocket push notifications with heartbeat and auto-reconnection
- Performance: ~90% reduction in API calls via WebSocket optimization
- Subscription Management: Centralized TunnelProvider context with deduplication
- API Client: RingApiClient with standardized timeout, retry, and error handling
- Security: Enterprise-grade security with rate limiting, CORS protection, and input validation
- Account Deletion: GDPR/CCPA compliant account deletion with 30-day grace period and audit trails
- Total Users: 15,420 (8,934 active)
- Entities: 3,456 registered organizations
- Opportunities: 8,765 active listings
- API Endpoints: 38 documented endpoints
- Routes: 58 application routes
- Build Time: 11.0 seconds
- Bundle Size: 102kB optimized
- Entity Profiles: Comprehensive company and organization profiles
- Opportunity Management: Advanced job posting and service request system
- Professional Discovery: Find companies, opportunities, and professionals
- Networking Tools: Connect with industry professionals and organizations
- Exclusive Access: Premium tier for confidential business interactions
- Executive Opportunities: C-level positions and strategic roles
- Stealth Operations: Support for stealth startups and confidential projects
- Strategic Partnerships: Facilitate high-level business collaborations
- Investment Opportunities: Connect investors with exclusive deals
- Multi-Criteria Filtering: Industry, location, budget, experience level
- Geolocation Support: Location-based opportunity discovery
- Smart Recommendations: AI-powered matching algorithms
- Real-time Updates: Live notifications for new opportunities
- WebSocket Push: Instant notification delivery (<100ms latency)
- Stable Connections: Centralized subscription management prevents loops
- Connection Reliability: Heartbeat mechanism with auto-reconnection
- Type-Safe Role Management: Hierarchical access control with UserRole enum
- Auth Status Integration: Seamless navigation to unified status pages
- KYC Workflow Management: Integrated identity verification status tracking
- Session Management: Robust session handling with refresh capabilities
- Dynamic Routing: [action]/[status] pattern for consistent workflow feedback
- Multi-Domain Support: Auth, Entities, Opportunities, Notifications, Store
- Internationalization: Comprehensive i18n support in English and Ukrainian
- SEO Optimization: Dynamic metadata with status-specific content
- Accessibility: ARIA-compliant status pages with proper navigation
- News System: Industry news, company updates, and professional insights
- News Likes: React 19 optimistic updates for instant engagement feedback
- Comments System: Nested comments with 3-level deep threading for discussions
- File Management: Document upload and sharing capabilities
- Rich Media: Support for images, videos, and presentations
- Content Categorization: Organized content discovery
- Real-time Analytics: Comprehensive user behavior and interaction tracking
- Business Intelligence: Entity interaction analytics and engagement metrics
- Error Monitoring: Intelligent JavaScript error capture and reporting
- Performance Tracking: React 19 optimization benefits and Core Web Vitals monitoring
- Navigation Analytics: User journey tracking and session management
- Theme Persistence: Advanced theme management with FOUC prevention
- List Performance: Entity list interaction and performance analytics
- Role-Based Access: Sophisticated permission system
- Data Protection: GDPR-compliant data handling
- Secure Authentication: Multi-provider authentication system
- Audit Logging: Comprehensive activity tracking
ring/
├── app/ # Next.js 15 App Router
│ ├── (main)/ # Main application routes
│ ├── api/ # API endpoints (38 total)
│ └── actions/ # Server actions
├── components/ # Reusable UI components
├── features/ # Feature-specific modules
├── services/ # Business logic services
├── lib/ # Utility libraries
├── types/ # TypeScript definitions
└── styles/ # Global styles and themes
- RESTful Design: Standard HTTP methods and status codes
- Authentication: Bearer token and session-based auth
- Direct Service Calls: Server components and actions use services directly for better performance and security
- Client-Server Separation: Client components use API routes, server components use direct service calls
- Rate Limiting: Configurable limits per endpoint
- Error Handling: Consistent error response format
- Documentation: Comprehensive API documentation
- Firestore Collections: Optimized for real-time queries
- Denormalized Data: Performance-optimized data structure
- Security Rules: Row-level security implementation
- Indexing Strategy: Efficient query performance
- Subscription Tiers: Freemium model with premium features
- Confidential Access: Premium tier for exclusive networking
- Entity Verification: Enhanced credibility services
- Featured Listings: Promoted opportunity placements
- Enterprise Solutions: Custom solutions for large organizations
- Technology Companies: Startups to enterprise organizations
- Professional Services: Consulting, legal, financial services
- Healthcare Organizations: Hospitals, clinics, research institutions
- Manufacturing: Industrial and consumer goods companies
- Investment Firms: VCs, private equity, and investment banks
# Clone the repository
git clone https://github.com/connectplatform/ring.git
cd ring
# Install dependencies
npm install
# Set up environment variables
cp env.local.template .env.local
# Configure Firebase, NextAuth, and other services
# Run development server
npm run dev# Authentication
AUTH_SECRET=your-secret-key
NEXTAUTH_URL=http://localhost:3000
# Firebase Configuration
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_CLIENT_EMAIL=your-service-account-email
FIREBASE_PRIVATE_KEY=your-private-key
# Vercel Blob Storage
BLOB_READ_WRITE_TOKEN=your-blob-token
# WebSocket Configuration
NEXT_PUBLIC_WS_URL=ws://localhost:3000
# External APIs
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secretnpm run dev # Start development server with WebSocket support
npm run dev:nextjs # Start Next.js development server only
npm run dev:ws # Start development server with WebSocket support
npm run type-check # Run TypeScript type checking
npm run build # Build for production with type validation (includes prebuild step)
npm run build:skip-types # Build for production without type validation
npm run build:clean # Clean build with fresh start
npm run start # Start production server with WebSocket support
npm run lint # Run ESLint
npm run test # Run test suite
npm run test:watch # Run tests in watch mode
npm run test:coverage # Run tests with coverage report
npm run setup # Set up environment configuration
npm run analyze # Analyze bundle size (skips type validation for speed)- Rate Limiting: 5 auth/min, 100 API/min, 10 WebSocket/min per IP
- CORS Protection: Environment-specific origins, no wildcards
- Input Validation: XSS prevention and sanitization
- Session Security: IP-bound auth cache with hijacking prevention
- Token Validation: JWT expiry checks with clock skew protection
- Subscription Security: Centralized context prevents duplicate subscriptions
- Error Handling: Generic messages prevent information leakage
# Test rate limiting
for i in {1..10}; do curl http://localhost:3000/api/websocket/auth; done
# Test CORS protection
curl -H "Origin: https://evil.com" http://localhost:3000/api/notifications
# Check security headers
curl -I http://localhost:3000/api/notifications- Interactive Docs: connectplatform.github.io/ring
- API Reference: Comprehensive endpoint documentation
- Code Examples: Multiple language examples
- Postman Collection: Ready-to-use API collection
- Setup Guides: Environment configuration and deployment
- Architecture Docs: System design and patterns
- API Client Guide: RingApiClient integration and best practices
- Security Guide: Security Implementation Guide
- Contributing Guide: Development workflow and standards
- Security Guidelines: Best practices and compliance
We welcome contributions to Ring Platform! Please see our Contributing Guide for details on:
- Development Workflow: Git flow and branch management
- Code Standards: TypeScript, React, and Next.js best practices
- Testing Requirements: Unit tests and integration tests
- Documentation: API docs and code documentation
- Security: Security review process and guidelines
Ring Platform is proprietary software. All rights reserved.
- Platform: ring.ck.ua
- Documentation: connectplatform.github.io/ring
- Admin Console: ring.ck.ua/admin
- Support: support@ring.ck.ua
Ring Platform - Connecting Professionals, Empowering Businesses, Enabling Opportunities