A comprehensive SaaS platform for finding, analyzing, and acquiring profitable businesses with AI-powered due diligence and data insights.
- Advanced Business Search: Powerful filtering by industry, location, financials, and custom metrics
- AI-Powered Due Diligence: Automated risk assessment, ROI projections, and SBA loan qualification
- Multi-Tenant Architecture: Full organization and user management with role-based access
- Subscription Management: Three-tier pricing with Stripe integration ($49/$149/$399)
- Data Export: CSV and JSON export capabilities with tier-based restrictions
- Quality Scoring: Automated data quality assessment for all listings
- Risk Analysis: Financial, legal, operational, and market risk evaluation
- ROI Projections: Comprehensive financial analysis and valuation tools
- SBA Qualification: Automated Small Business Administration loan eligibility assessment
- Responsive Design: Mobile-optimized interface with design system from marketing site
- Real-time Analytics: Usage tracking and dashboard metrics
- Watchlist Management: Save and organize business opportunities
- Team Collaboration: Multi-user organizations with permission management
- Node.js + TypeScript: Type-safe server-side development
- Express.js: RESTful API with OpenAPI specifications
- PostgreSQL: Primary database for transactional data
- Firestore: Real-time features and caching
- Firebase Auth: Authentication with custom JWT claims
- Stripe: Subscription and payment processing
- Next.js: React framework with SSR and SEO optimization
- TypeScript: Full type safety across the application
- Tailwind CSS: Utility-first styling with custom design system
- Firebase SDK: Client-side authentication
- Node.js 18+
- PostgreSQL 13+
- Firebase project
- Stripe account
-
Clone the repository
git clone <repository-url> cd cashflow-trader
-
Install dependencies
npm install
-
Environment Configuration
cp .env.example .env # Edit .env with your configuration values -
Database Setup
# Create PostgreSQL database createdb cashflow_finder # Run database schema psql -d cashflow_finder -f src/server/database/schema.sql
-
Firebase Setup
- Create a new Firebase project
- Enable Authentication with Email/Password
- Generate service account credentials
- Add configuration to .env file
-
Stripe Setup
- Create Stripe account and get API keys
- Create subscription products for three tiers
- Set up webhook endpoint for
/api/webhooks/stripe - Add price IDs to .env file
# Run both frontend and backend in development
npm run dev
# Backend will run on http://localhost:3000
# Frontend will run on http://localhost:3001# Build the application
npm run build
# Start production server
npm start- 100 business searches/month
- Basic listing access
- Standard contact information
- Limited data history (30 days)
- Email support only
- 500 searches/month
- Advanced filtering
- Full contact data
- ROI calculation tools
- CSV exports & data enrichment
- SBA loan qualification assessments
- 12-month data history
- Due diligence reports
- Priority support
- Unlimited searches
- API access
- Custom integrations
- White-label options
- Advanced analytics
- Dedicated account manager
- Custom data feeds
- Bulk operations
- Comprehensive due diligence automation
- GDPR/SOC2 Compliance: Data encryption, access controls, audit trails
- Role-Based Access: Granular permissions for multi-tenant organizations
- Rate Limiting: API protection and usage controls
- Data Encryption: At-rest and in-transit encryption with Cloud KMS
- Privacy by Design: Minimal data collection with explicit consent
- Usage Tracking: Comprehensive analytics for searches, exports, and API calls
- Real-time Dashboards: Business metrics and conversion analytics
- Revenue Attribution: Multi-touch attribution for affiliate programs
- Performance Monitoring: System health and response time tracking
The API follows RESTful conventions with comprehensive error handling:
POST /api/auth/signup - Create new user account
POST /api/auth/login - Authenticate user
GET /api/auth/me - Get current user info
GET /api/business/search - Search business listings
GET /api/business/:id - Get specific business
POST /api/business/export - Export search results
POST /api/business/:id/watchlist - Add to watchlist
GET /api/subscription/status - Get subscription status
POST /api/subscription/upgrade - Upgrade subscription tier
GET /api/subscription/usage - Get current usage
- Frontend: Vercel or Netlify
- Backend: Google Cloud Run or AWS Lambda
- Database: Google Cloud SQL or AWS RDS
- CDN: Cloudflare
See .env.example for complete configuration requirements.
Based on comprehensive competitor analysis:
- Subscription Revenue: $49-$399/month recurring revenue
- Affiliate Commissions: Business financing, legal services, insurance
- Premium Services: Due diligence reports, business valuations
- API Access: Enterprise integrations and custom solutions
- Revenue: $50K MRR with 25% month-over-month growth
- Users: 1,000 paying customers across all tiers
- Conversion: 20% trial-to-paid conversion rate
- Retention: 85% annual retention rate
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is proprietary and confidential. All rights reserved.
For technical support or questions:
- Create an issue in this repository
- Email: support@cashflowfinder.com
- Documentation: [Internal Wiki]
Cash Flow Finder - Empowering business acquisition decisions with AI-powered insights and comprehensive data intelligence.