LivestockWay — Super Admin Manual

Admin Responsibilities

• User Management: Create, suspend, delete user accounts
• Pricing & Subscriptions: Configure hauler plans and billing
• Dispute Resolution: Arbitrate payment/delivery conflicts
• Financial: Monitor settlements, payouts, platform revenue
• Support: Respond to help tickets
• Content: Manage blog, alerts, notifications
• Monitoring: Track platform health and metrics

Dashboard Widgets

1View All Users

1. From admin sidebar, click "Users"
2. See a table of all registered users (haulers, shippers, drivers, etc.)
3. Filter by: Role, Status (active/suspended), Subscription plan, Join date
4. Search by: Email, name, company

2View User Details

1. Click on a user to open their profile
2. See: Email, phone, address, account creation date, last login
3. For haulers: Subscription plan, Stripe Connect status, total earnings
4. For shippers: Total shipments, total spent
5. Trip history and recent activity

3Suspend or Delete User

If a user violates terms of service:

1. Open user profile
2. Suspend: User cannot log in, but account data preserved
3. Delete: Account permanently removed (irreversible)
4. Optionally add a note: reason for suspension/deletion

4Send Admin Notification

1. On user profile, click "Send Message"
2. Compose message (e.g., "Please verify your Stripe Connect account")
3. Send — user receives in-app notification + email

1View Current Pricing

1. From admin sidebar, click "Pricing"
2. See all active plans with pricing tiers
3. Each plan shows: Name, price, trip limit, features

2Edit a Plan

1. Click on a pricing plan
2. Edit fields:
   • Plan Name (e.g., "Premium$")
   • Price per month/year
   • Max trips allowed (or "unlimited")
   • Features included (e.g., GPS tracking, support, fleet size cap)
   • Is Active: Toggle plan on/off (new signups can't choose inactive plans)
3. Click "Save Changes"
4. ⚠️ CAUTION: Changes affect new subscribers only. Existing subscribers keep their old rate until renewal.

3Create New Pricing Tier

1. Click "+ Add New Plan"
2. Fill in plan details (as above)
3. Set Stripe product ID (backend integration needed)
4. Click "Create Plan"
5. New plan appears as option for hauler signups

1View All Subscriptions

1. From admin sidebar, click "Subscriptions"
2. See table of all active subscriptions with:
   • Hauler name, plan, price, start date, renewal date
   • Payment status (active, upcoming renewal, payment failed, cancelled)
3. Filter by: Plan, status, renewal date, revenue

2Manage Individual Subscription

1. Click on a subscription to edit
2. Options:
   • Extend expiry date (e.g., give free month promo)
   • Upgrade/downgrade plan (change tier, refund/charge difference)
   • Pause subscription (temporarily freeze, don't charge)
   • Cancel subscription (irrevocable; hauler loses access at end of cycle)
3. Add notes for reason (e.g., "Loyalty discount applied")

3Subscription Metrics

Dashboard shows:

• MRR (Monthly Recurring Revenue): $X from active monthly subscriptions
• Churn Rate: % of subscribers cancelling per month
• LTV (Lifetime Value): Avg revenue per hauler lifetime
• Renewal Analytics: Upcoming renewals, payment success rate

1View Pending Disputes

1. From admin sidebar, click "Disputes"
2. See all open disputes with status:
   • Opened: Shipper raised issue, awaiting response from hauler
   • In Progress: Both parties have submitted evidence
   • Awaiting Admin Review: Ready for arbitration

2Review a Dispute

1. Click on a dispute to open full case
2. See:
   • Trip details, contract amount, payment mode
   • Shipper's claim: Description, photos, loss amount
   • Hauler's response: Explanation, counter-evidence (if provided)
3. Review all uploaded photos/documentation

3Make a Decision

Based on evidence, choose one:

4Document Decision

1. Write a brief admin note (e.g., "Photos show clear mortality. Shipper refunded 50%.")
2. Select decision from dropdown
3. Click "Issue Resolution"
4. System automatically:
   • Processes refund/payout (if needed)
   • Sends notification to both shipper and hauler
   • Marks dispute as closed

Revenue Dashboard

View financial summary:

1Monitor Payouts

1. Go to "Settlements" or "Payouts" section
2. View daily/weekly payout runs
3. Each run shows:
   • Number of haulers paid
   • Total amount transferred to Stripe accounts
   • Failed transfers (retry available)
   • Timestamp & status

2Retry Failed Payouts

1. If a payout fails (incorrect bank info, Stripe issue, etc.):
2. Click the failed payout row to see details
3. Error reason shown (e.g., "Invalid bank account number")
4. Click "Retry Transfer" to attempt again
5. Or, contact hauler to verify bank information

1View Support Queue

1. From admin sidebar, click "Support Tickets"
2. See all tickets from users (sorted by priority/date)
3. Status: Open, In Progress, Closed

2Respond to Ticket

1. Click on an open ticket
2. Review user's issue description and any attachments
3. In the reply field, type your response
4. Options:
   • "Send Reply" — User gets notified
   • "Mark as Resolved" — Close ticket
   • "Escalate" — Flag for higher priority/review

Common Support Issues

1Manage Blog

1. From sidebar, click "Blog"
2. View all published blog posts
3. Actions:
   • "+ New Post" — Create blog article
   • "Edit" — Modify existing post
   • "Publish/Unpublish" — Control visibility
   • "Delete" — Remove old posts

2Create Blog Post

1. Click "+ New Post"
2. Fill in:
   • Title (e.g., "Best Practices for Livestock Transport")
   • Content (rich text editor with formatting)
   • Cover Image (upload or link)
   • Summary (appears in blog list)
   • Tags (e.g., "tips", "safety", "regulations")
3. Click "Publish"
4. Post appears on public blog page

3Notifications & Alerts

1. Go to "Notifications" menu
2. Create alerts for users (banners, email, in-app):
3. Examples:
   • "System maintenance tonight 2 AM - 4 AM PST"
   • "New feature: Automated route planning available now"
   • "Stripe Connect verification process updated"
4. Target: All users, haulers only, shippers only, specific roles

Available Reports

• User Growth — New signups by week, retention rate
• Trip Analytics — Trips completed, avg delivery time, cancellation rate
• Revenue Report — Fees collected, subscription MRR, net revenue
• Payment Health — Failed payouts, disputes, refunds
• Geographic Heatmap — Regions with most activity
• Top Haulers — By earnings, ratings, trips completed
• Top Shippers — By shipments, spending

1Generate Report

1. From sidebar, click "Reports"
2. Select report type & date range
3. Click "Generate"
4. Report displays in table + charts
5. Options to "Export as PDF" or "Download CSV"

2Monitor System Health

Regular checks to ensure platform stability:

• API Health: Response times, error rates
• Database: Query performance, disk usage
• Stripe Integration: Webhook status, payment processing
• Email Service: Delivery rate, bounces
• GPS Tracking: Location updates, real-time accuracy