AI-Powered Direct Meat Sales (Sell-Cattle)

Overview

AI-Powered Direct Meat Sales is a modern web application that connects ranchers and customers for direct, transparent, and efficient meat sales. The platform leverages AI to help ranchers create compelling cattle listings, provides quality assessment tools, and ensures direct communication between all parties.

Key Features

• AI-Generated Listing Descriptions: Automatically generate professional, market-oriented descriptions for cattle listings using OpenAI.
• Multi-Step Listing Creation: Ranchers can easily create, preview, and publish listings with detailed information and images.
• Quality Assessment: Integrated tools for assessing and displaying cattle quality metrics.
• Order Management: Customers can place orders directly; ranchers and admins can manage orders through dedicated dashboards.
• Messaging System: Secure, real-time messaging between ranchers and customers.
• User Roles: Support for Ranchers, Customers, and Admins, each with tailored dashboards and permissions.
• Secure Authentication: User registration, login, password reset, and account management.
• Geolocation & Pricing: Location-aware pricing and listing features.
• Responsive Design: Fully responsive UI for desktop and mobile devices.

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm, yarn, pnpm,

Installation

1. Open the repository with your terminal either in code editor or cmd
2. Install dependencies:

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Set up environment variables:
   • The .env.local is already available here

Running Locally

npm run dev
# or
yarn dev
# or
pnpm dev

Visit http://localhost:3000 in your browser.

User Roles & Workflows

Ranchers

• Register/Login: Create an account as a rancher.
• Create Listings: Use the multi-step form to add cattle details, upload images, and generate AI-powered descriptions.
• Manage Listings: Edit, update, or remove listings from your dashboard.
• Order Management: View and manage orders placed by customers.
• Messaging: Communicate with interested buyers directly.
• Can also place Orders: Initiate and track orders for selected cattle.

Customers

• Browse Listings: Search and filter available cattle listings.
• Place/trace Orders: Initiate and track orders for selected cattle.
• Messaging: Contact ranchers for more information or negotiation.
• Profile Management: Update personal information and view order history.
• Can also create Listings: Can also use the multi-step form to add cattle details, upload images, and generate AI-powered descriptions.

Admins

• Dashboard: Oversee all users, listings, and orders.
• Moderation: Edit, or remove listings and handle disputes.
• Analytics: Access platform-wide statistics and reports.

Creating a Listing (Rancher Workflow)

1. Login/Register as a rancher.
2. Go to Create Listing.
3. Fill in cattle details (breed, weight, age, gender, etc.).
4. Click Generate AI Description to auto-fill a professional description.
5. Upload images and set price/location.
6. Preview your listing and submit.
7. Manage your listings and respond to customer inquiries/orders from your dashboard.

Order & Messaging System

• Customers can place orders directly from listings.
• Both parties can communicate via the built-in messaging system.
• Order status and history are available in user dashboards.

Terms & Conditions

By using this platform, you agree to the Terms and Conditions, which include:

• Providing accurate information
• Using the platform in good faith
• Complying with all applicable laws

FAQ & Support

• For common questions, visit the FAQ section in the app.
• For technical support, contact the platform administrator or use the contact form.

Technologies Used

• Next.js, React, Zustand, Redux Toolkit
• Supabase (auth & database)
• Goodlemaps
• Twilio sendgrid
• Google vertex for hosting Cattle price prediction
• OpenAI (AI descriptions)
• Bootstrap, SCSS, FontAwesome