Skip to content

lancejia24/v3

Repository files navigation

Local Deals & Events Platform

A comprehensive platform for discovering and managing local deals and events in Long Island's Nassau and Suffolk counties.

Table of Contents

Features

For Customers

Account & Profile

  • User authentication (email/password)
  • Customizable user profiles
  • Personalized preferences
  • Activity tracking dashboard
  • Saved items and collections

Testing:

  1. Sign up with email/password
  2. Verify profile customization options
  3. Set notification preferences
  4. Check activity log
  5. Create and manage collections

Deal Discovery

  • Browse local deals and coupons
  • Save favorite deals
  • Track redemptions
  • Multiple view modes (grid, list, map)
  • Advanced filtering and sorting
  • Quick filters (ending soon, free, popular)

Testing:

  1. Search for deals using filters
  2. Save deals to collections
  3. Redeem a coupon
  4. Switch between view modes
  5. Apply and clear filters

Event Discovery

  • Browse upcoming events
  • Event categories and filtering
  • Map view for event locations
  • Ticket purchase integration
  • Event reminders

Testing:

  1. Browse events by category
  2. View event details
  3. Save events
  4. Test map integration
  5. Set event reminders

Job Search

  • Browse job listings
  • Apply for jobs
  • Track applications
  • Resume management
  • Job alerts

Testing:

  1. Search for jobs
  2. Submit job applications
  3. Upload and manage resumes
  4. Check application status
  5. Set up job alerts

Social Features

  • Follow favorite businesses
  • Rate and review businesses
  • Vote on helpful reviews
  • Share deals and events
  • Create and share collections
  • Business timeline interaction

Testing:

  1. Follow/unfollow businesses
  2. Write and edit reviews
  3. Vote on other reviews
  4. Share content
  5. Interact with business posts

For Businesses

Business Profile

  • Detailed business information
  • Business hours
  • Photo gallery
  • Location mapping
  • Social media links
  • Amenities and payment methods

Testing:

  1. Create business profile
  2. Update business details
  3. Add photos
  4. Set business hours
  5. Configure amenities

Deal Management

  • Create and manage coupons
  • Set expiration dates
  • Add terms and conditions
  • Track redemptions
  • Batch upload capabilities
  • Export functionality

Testing:

  1. Create new coupon
  2. Edit existing coupon
  3. Upload batch coupons
  4. Track redemption stats
  5. Export coupon data

Event Management

  • Create and manage events
  • Set event dates and times
  • Add venue information
  • Ticket URL integration
  • Event categories
  • Batch upload tools

Testing:

  1. Create new event
  2. Edit event details
  3. Upload batch events
  4. Monitor event stats
  5. Export event data

Job Management

  • Post job listings
  • Track applications
  • Manage candidates
  • Interview scheduling
  • Application analytics

Testing:

  1. Create job posting
  2. Review applications
  3. Update application status
  4. Schedule interviews
  5. View job analytics

Advertising

  • Multiple ad placements
    • Header banner
    • Sidebar ads
    • Footer placement
    • Featured spots
  • Campaign management
  • Budget controls
  • Performance tracking
  • A/B testing

Testing:

  1. Create ad campaign
  2. Set budget and schedule
  3. Choose ad placement
  4. Monitor performance
  5. Test A/B variants

Timeline & Updates

  • Post business updates
  • Share photos
  • Engage with followers
  • Track engagement
  • Manage comments

Testing:

  1. Create timeline post
  2. Add images to post
  3. Respond to comments
  4. Monitor engagement
  5. Manage interactions

Analytics & Insights

  • Real-time performance metrics
  • Customer engagement tracking
  • Redemption analytics
  • View and click tracking
  • Export capabilities

Testing:

  1. View analytics dashboard
  2. Check engagement metrics
  3. Monitor redemptions
  4. Track ad performance
  5. Export reports

Customer Engagement

  • Respond to reviews
  • Message customers
  • Track response rates
  • Manage reputation

Testing:

  1. Respond to reviews
  2. Send customer messages
  3. Check response metrics
  4. Monitor reputation score

For Administrators

User Management

  • User account oversight
  • Role management
  • Account status control
  • Activity monitoring

Testing:

  1. View user accounts
  2. Change user roles
  3. Suspend/activate accounts
  4. Monitor user activity

Content Moderation

  • Review management
  • Content approval system
  • Report handling
  • Automated content checks

Testing:

  1. Review reported content
  2. Approve/reject submissions
  3. Handle user reports
  4. Check moderation logs

Category Management

  • Manage deal categories
  • Event category control
  • Category hierarchy
  • Usage analytics

Testing:

  1. Create categories
  2. Edit category details
  3. Arrange hierarchy
  4. View category stats

System Settings

  • Platform configuration
  • Email templates
  • Notification settings
  • System maintenance

Testing:

  1. Update system settings
  2. Edit email templates
  3. Configure notifications
  4. Perform maintenance

Analytics & Reporting

  • Platform-wide analytics
  • User engagement metrics
  • Business performance stats
  • Content performance tracking
  • Export capabilities

Testing:

  1. View platform analytics
  2. Check engagement stats
  3. Monitor performance
  4. Generate reports
  5. Export data

Technology Stack

  • Frontend: React with TypeScript
  • Styling: Tailwind CSS
  • Database: Supabase (PostgreSQL)
  • Authentication: Supabase Auth
  • Maps: Leaflet
  • Icons: Lucide React
  • Forms: React Hook Form
  • Validation: Zod
  • Charts: Recharts

Getting Started

  1. Clone the repository
  2. Install dependencies:
    npm install
  3. Set up environment variables:
    VITE_SUPABASE_URL=your_supabase_url
    VITE_SUPABASE_ANON_KEY=your_supabase_key
    
  4. Start the development server:
    npm run dev

Development

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run test - Run tests
  • npm run lint - Run linting

Test Accounts

For testing purposes, use these accounts:

Customer Account

  • Email: [email protected]
  • Password: password123
  • Features to test:
    • Deal browsing and saving
    • Event discovery
    • Business reviews
    • Job applications

Business Account

  • Email: [email protected]
  • Password: password123
  • Features to test:
    • Deal management
    • Event creation
    • Job postings
    • Analytics dashboard

Admin Account

  • Email: [email protected]
  • Password: password123
  • Features to test:
    • User management
    • Content moderation
    • System settings
    • Analytics overview

About

Created with StackBlitz ⚡️

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published