WorknEarn – Instant Jobs Marketplace

✨ Key Features

• Instant Job Posts: rich job briefs, categories, skills/tags, budgets (fixed/hourly), deadlines, attachments.
• Proposals & Bids: freelancer proposals with cover letters, milestones, delivery estimates, and portfolio links.
• Escrow & Payouts: fund-on-hire, milestone releases, platform commissions, refundable holds, and payout requests.
• Chat & File Sharing: secure, real-time messaging with attachments and typing/read indicators.
• Dispute Center: structured disputes, evidence upload, moderator tools, and resolution outcomes.
• Ratings & Reviews: two-sided feedback, verified completion badges, and profile reputation scores.
• Job Types: remote & on-site jobs, micro-tasks, recurring gigs, and featured/urgent listings.
• Search & Matching: keyword/category filters, geo-radius search, price/time filters, and saved searches.
• Subscriptions & Fees: plans for clients/freelancers, credits for bids, featured boosts, coupons.
• KYC & Compliance: optional ID checks, tax profile fields, downloadable invoices and receipts.
• Notifications: email and in-app alerts for bids, messages, milestones, disputes, and payouts.
• CMS & Pages: editable policies (ToS, Privacy), blog/announcements, FAQs, contact forms.
• Admin Console: user moderation, category/skills taxonomy, fees, withdrawals, disputes, logs.
• Localization: multi-language UI, currency settings, RTL support, and locale-aware formats.
• Responsive UI: mobile-first layout, accessible components, and dark mode.

Note: Feature names and toggles follow the upstream author’s implementation; this list reflects standard capabilities in instant job portals.

⚙️ Technical Stack

Provided as released by the original developer. Typical marketplace stack includes:

• Backend: PHP (8.1/8.2+) with Laravel (or comparable modern PHP framework), RESTful controllers, queue workers (Supervisor).
• Frontend: Blade/Vue/React components, Tailwind CSS for styling, Vite/Mix for asset builds.
• Database: MySQL/MariaDB (8.0+ recommended), optional Redis for cache/queues.
• Payments: Stripe/PayPal (or equivalent gateways) for escrow, platform fees, and withdrawals.
• Server Requirements: Nginx/Apache, PHP extensions (pdo, mbstring, json, curl, openssl, gd/imagick), Composer, Node.js, HTTPS/SSL.
• Optional: Docker compose for local dev, S3-compatible object storage for media, mail (SMTP) for system emails.

Transparency: Check the included docs for the exact version matrix used by this release.

🧩 Installation Guide (Quick Start)

1. Prepare Server: PHP 8.2+, MySQL 8+, Nginx/Apache with HTTPS. Install Composer & Node.js.
2. Upload Files: Copy the source to your web root. Ensure write permissions for storage/ and bootstrap/cache.
3. Configure Env: Copy .env.example to .env; set APP_URL, DB credentials, mail (SMTP), payment keys, and app settings.
4. Install Dependencies: composer install --no-dev then php artisan key:generate. Build assets via npm ci && npm run build.
5. Migrate DB: php artisan migrate --seed to create tables and seed defaults (roles, categories, settings).
6. Optimize & Queues: php artisan config:cache and start workers (php artisan queue:work or Supervisor).
7. Go Live: Create plans/fees, connect payment webhooks, and test end-to-end (post → bid → escrow → delivery → payout).

Tip: Enable OPCache, tune MySQL, and offload media to S3 for scalability.

📦 Deliverables

• Complete source code as provided by the original developer.
• Migrations/Seeders for database bootstrap.
• Environment template (.env.example) and config samples.
• Admin credentials (seeded placeholders; change on first login).
• Documentation (installation and usage notes, when included).
• Changelog or release notes (if supplied).

📱 Supported Platforms

• Web App: modern browsers (Chrome, Edge, Firefox, Safari).
• Server: Linux (Ubuntu/Debian/CentOS/Alma), macOS, or Windows Server with PHP-FPM/Apache.
• Mobile: responsive UI; installable as a PWA where supported.

🧠 Notes

• License: Distributed here under the GPL. See the included license file for terms.
• Customization: adjust categories/skills, fees/commissions, and locations; enable KYC only where required; localize currency and date formats.
• SEO Assurance: structured headings, descriptive titles/meta, clean URLs, schema-ready markup, and fast, mobile-first performance.
• Security: enforce HTTPS, rotate gateway keys, validate uploads, configure rate limits, and keep dependencies updated.

👨‍💻 Original Developer Credit

Authorship belongs to the original developer (commercial marketplace listing, e.g.,
CodeCanyon). All credits and trademarks remain with the upstream author.

🔒 Disclaimer

GPL Redistribution Notice: This is a GPL-licensed redistribution of the upstream source code. We are
not the original publisher and provide no implied affiliation, warranty, or support. Updates and official
support are available only from the original developer under their terms. Use in accordance with the GPL and applicable laws.