This commit is contained in:
Codex
2026-07-10 09:14:42 -05:00
parent e27fcc6c19
commit 63820994f8
55 changed files with 2195 additions and 86 deletions
+62 -40
View File
@@ -1,58 +1,80 @@
<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
# Provider Exchange
<p align="center">
<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
</p>
Provider Exchange is an early Laravel prototype for a provider-centered field service network and work-order exchange.
## About Laravel
The product goal is not to clone Field Nation. The first version focuses on:
Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
- provider and buyer profiles;
- community posts;
- buyer job posts;
- provider quotes;
- work-order assignment and status tracking;
- mutual reviews;
- peer-review dispute records;
- external profile/rating snapshots from Field Nation, WorkMarket, and similar platforms.
- [Simple, fast routing engine](https://laravel.com/docs/routing).
- [Powerful dependency injection container](https://laravel.com/docs/container).
- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
- [Robust background job processing](https://laravel.com/docs/queues).
- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
## Guardrails
Laravel is accessible, powerful, and provides tools required for large, robust applications.
- The platform does not hold money in v1.
- The platform does not set or recommend market rates.
- Providers control their own rate cards and terms.
- Buyers control their own posted offer terms.
- Payment remains direct between buyer and provider unless a compliant payment partner is added later.
- Reputation is mutual: providers review buyers and buyers review providers.
- Dispute records are reputational/peer-review records, not legal adjudication.
## Learning Laravel
Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.
In addition, [Laracasts](https://laracasts.com) contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
You can also watch bite-sized lessons with real-world projects on [Laravel Learn](https://laravel.com/learn), where you will be guided through building a Laravel application from scratch while learning PHP fundamentals.
## Agentic Development
Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install [Laravel Boost](https://laravel.com/docs/ai) to supercharge your AI workflow:
## Local Setup
```bash
composer require laravel/boost --dev
php artisan boost:install
composer install
npm install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate:fresh --seed
npm run build
php artisan serve --host=0.0.0.0 --port=8123
```
Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.
## Demo Accounts
## Contributing
All seeded demo accounts use password `password`.
Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
- `admin@example.com`
- `provider@example.com`
- `buyer@example.com`
- `hybrid@example.com`
## Code of Conduct
## Test Commands
In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
```bash
php artisan test
npm run build
```
## Security Vulnerabilities
## Current Roadmap Status
If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
1. Foundation: Laravel app, auth, roles, seeded demo users.
2. Profiles: provider and buyer profiles.
3. Social layer: community feed posts.
4. Job posts: buyer job-post creation and listing.
5. Quote flow: provider quotes and buyer acceptance.
6. Work orders: assignment, status transitions, deliverables, completion notes.
7. Reviews: mutual buyer/provider reviews.
8. Disputes: peer-review dispute records.
9. API prep: Sanctum installed with starter API routes.
10. Hardening: tests, seed data, setup docs, and no-payment/no-rate-setting guardrails.
## License
## External Profile Imports
The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
Provider profiles support manual external snapshots. For Field Nation, the first version records:
- platform name;
- external provider ID;
- profile URL if available;
- rating;
- review count;
- completed jobs;
- notes or copied review summaries.
Public search did not expose a Field Nation profile for provider ID `172-630`, so any automated Field Nation import should be treated as a later authenticated/export-assisted workflow rather than a public scrape assumption.