From 7b7160f44adc0b5d2b036eb84a82dbb367f7ed34 Mon Sep 17 00:00:00 2001 From: fatihalp Date: Mon, 27 Jul 2026 01:50:17 +0300 Subject: [PATCH 01/10] Strict Mode Added --- .env.example | 6 +- AGENTS.md | 433 +-------- CODE_OF_CONDUCT.md | 15 + ...03_03_093635_create_activity_log_table.php | 29 +- .../Admin/Providers/AdminPanelProvider.php | 2 + .../Admin/Providers/AdminServiceProvider.php | 5 +- Modules/Admin/README.md | 9 + .../Support/Filament/ResourceTableActions.php | 2 + .../Support/Filament/ResourceTableColumns.php | 2 + Modules/Category/CategoryPlugin.php | 4 +- .../Database/Seeders/CategorySeeder.php | 6 +- ...4_01_01_000002_create_categories_table.php | 8 +- .../Admin/Resources/CategoryResource.php | 7 +- .../CategoryResource/Pages/CreateCategory.php | 2 + .../CategoryResource/Pages/EditCategory.php | 2 + .../CategoryResource/Pages/ListCategories.php | 2 + .../Pages/ListCategoryActivities.php | 2 + .../Http/Controllers/CategoryController.php | 7 +- Modules/Category/Models/Category.php | 18 +- .../Providers/CategoryServiceProvider.php | 5 +- Modules/Category/README.md | 9 + .../Category/resources/views/index.blade.php | 5 - .../views/themes/otoplus/index.blade.php | 5 - Modules/Category/routes/web.php | 2 + .../App/Events/ConversationReadUpdated.php | 5 +- .../App/Events/InboxMessageCreated.php | 5 +- .../Controllers/ConversationController.php | 8 +- .../Conversation/App/Models/Conversation.php | 5 +- .../App/Models/ConversationMessage.php | 7 +- .../Providers/ConversationServiceProvider.php | 2 + .../App/Support/QuickMessageCatalog.php | 2 + .../Seeders/ConversationDemoSeeder.php | 2 + ...3_04_000000_create_conversation_tables.php | 8 +- Modules/Conversation/README.md | 9 + Modules/Conversation/routes/web.php | 2 + .../Demo/App/Console/CleanupDemoCommand.php | 2 + .../Demo/App/Console/PrepareDemoCommand.php | 2 + .../App/Http/Controllers/DemoController.php | 5 +- .../Http/Middleware/ResolveDemoRequest.php | 6 +- Modules/Demo/App/Models/DemoInstance.php | 2 + .../App/Providers/DemoServiceProvider.php | 2 + .../Demo/App/Support/DemoSchemaManager.php | 5 +- Modules/Demo/App/Support/DemoStoragePath.php | 2 + .../Demo/App/Support/TurnstileVerifier.php | 2 + .../Database/Seeders/DemoContentSeeder.php | 5 +- ..._07_000000_create_demo_instances_table.php | 2 + Modules/Demo/README.md | 8 + Modules/Demo/routes/web.php | 2 + .../Http/Controllers/FavoriteController.php | 9 +- .../Favorite/App/Models/FavoriteSearch.php | 5 + .../App/Providers/FavoriteServiceProvider.php | 2 + .../Database/Seeders/FavoriteDemoSeeder.php | 5 +- ...6_03_04_000000_create_favorites_tables.php | 8 +- Modules/Favorite/README.md | 7 + Modules/Favorite/routes/web.php | 2 + .../Seeders/ListingCustomFieldSeeder.php | 2 + .../Seeders/ListingPanelDemoSeeder.php | 5 +- .../Database/Seeders/ListingSeeder.php | 2 + ...024_01_01_000003_create_listings_table.php | 13 +- .../2026_03_03_085614_create_media_table.php | 2 + .../Resources/ListingCustomFieldResource.php | 2 + .../Pages/CreateListingCustomField.php | 2 + .../Pages/EditListingCustomField.php | 2 + .../Pages/ListListingCustomFields.php | 2 + .../Admin/Resources/ListingResource.php | 2 + .../ListingResource/Pages/CreateListing.php | 2 + .../ListingResource/Pages/EditListing.php | 2 + .../Pages/ListListingActivities.php | 2 + .../ListingResource/Pages/ListListings.php | 2 + .../Admin/Widgets/ListingOverview.php | 2 + .../Admin/Widgets/ListingsTrendChart.php | 2 + .../Http/Controllers/ListingController.php | 8 +- Modules/Listing/ListingPlugin.php | 4 +- Modules/Listing/Models/Listing.php | 16 +- Modules/Listing/Models/ListingCustomField.php | 7 +- .../Providers/ListingServiceProvider.php | 5 +- Modules/Listing/README.md | 10 + .../Listing/States/ActiveListingStatus.php | 4 +- .../Listing/States/ExpiredListingStatus.php | 4 +- Modules/Listing/States/ListingStatus.php | 2 + .../Listing/States/PendingListingStatus.php | 4 +- Modules/Listing/States/SoldListingStatus.php | 4 +- .../Filament/AdminListingResourceSchema.php | 2 + .../ListingCustomFieldSchemaBuilder.php | 2 + .../Support/ListingCustomFieldSeedCatalog.php | 4 +- .../Listing/Support/ListingImageViewData.php | 2 + .../Listing/Support/ListingPanelHelper.php | 2 + .../Support/QuickListingCategorySuggester.php | 2 + .../Support/SampleListingImageCatalog.php | 4 + .../Listing/resources/views/index.blade.php | 7 - .../Listing/resources/views/show.blade.php | 115 --- .../Listing/resources/views/themes/README.md | 3 +- .../views/themes/otoplus/index.blade.php | 7 - .../views/themes/otoplus/show.blade.php | 854 ------------------ Modules/Listing/routes/web.php | 2 + .../Database/Seeders/LocationSeeder.php | 2 + ...24_01_01_000004_create_locations_table.php | 11 +- .../Filament/Admin/Resources/CityResource.php | 2 + .../CityResource/Pages/CreateCity.php | 2 + .../Resources/CityResource/Pages/EditCity.php | 2 + .../CityResource/Pages/ListCities.php | 2 + .../CityResource/Pages/ListCityActivities.php | 2 + .../Admin/Resources/CountryResource.php | 2 + .../CountryResource/Pages/CreateCountry.php | 2 + .../CountryResource/Pages/EditCountry.php | 2 + .../CountryResource/Pages/ListCountries.php | 2 + .../Pages/ListCountryActivities.php | 2 + .../Admin/Resources/DistrictResource.php | 2 + .../DistrictResource/Pages/CreateDistrict.php | 2 + .../DistrictResource/Pages/EditDistrict.php | 2 + .../Pages/ListDistrictActivities.php | 2 + .../DistrictResource/Pages/ListDistricts.php | 2 + .../Controllers/LocationLookupController.php | 2 + Modules/Location/LocationPlugin.php | 4 +- Modules/Location/Models/City.php | 11 +- Modules/Location/Models/Country.php | 11 +- Modules/Location/Models/District.php | 18 +- .../Providers/LocationServiceProvider.php | 5 +- Modules/Location/README.md | 9 + .../Location/Support/CountryCodeManager.php | 2 + Modules/Location/routes/web.php | 2 + .../App/Http/Controllers/PanelController.php | 2 + .../App/Http/Requests/StoreVideoRequest.php | 2 + .../Http/Requests/UpdateListingRequest.php | 2 + .../App/Http/Requests/UpdateVideoRequest.php | 2 + .../App/Livewire/PanelQuickListingForm.php | 2 + .../App/Providers/PanelServiceProvider.php | 2 + Modules/Panel/README.md | 7 + Modules/Panel/routes/web.php | 2 + .../App/Http/Controllers/HomeController.php | 2 + .../Http/Controllers/LanguageController.php | 2 + .../Controllers/PublicMediaController.php | 2 + .../App/Http/Middleware/BootstrapAppData.php | 2 + .../Site/App/Http/Middleware/SetLocale.php | 2 + .../App/Providers/SiteServiceProvider.php | 2 + Modules/Site/App/Settings/GeneralSettings.php | 2 + .../Site/App/Support/HomeSlideDefaults.php | 2 + Modules/Site/App/Support/LocalMedia.php | 2 + Modules/Site/App/Support/RequestAppData.php | 2 + .../App/Support/ScopedMediaPathGenerator.php | 2 + ...022_12_14_083707_create_settings_table.php | 2 + .../Admin/Pages/ManageGeneralSettings.php | 2 + Modules/Site/README.md | 8 + Modules/Site/SitePlugin.php | 4 +- .../Support/Filament/HomeSlideFormSchema.php | 2 + .../resources/views/layouts/app.blade.php | 573 +----------- Modules/Site/routes/web.php | 2 + .../Theme/Providers/ThemeServiceProvider.php | 2 + Modules/Theme/README.md | 7 + Modules/Theme/Support/ThemeManager.php | 6 +- Modules/Theme/config/theme.php | 8 +- .../Auth/ConfirmPasswordController.php | 2 + .../Auth/EmailVerificationController.php | 2 + .../Auth/ForgotPasswordController.php | 2 + .../Http/Controllers/Auth/LoginController.php | 5 +- .../Controllers/Auth/PasswordController.php | 6 +- .../Controllers/Auth/RegisterController.php | 7 +- .../Auth/ResetPasswordController.php | 2 + .../Controllers/Auth/SocialAuthController.php | 5 +- .../Http/Controllers/ProfileController.php | 2 + .../User/App/Http/Requests/LoginRequest.php | 2 + .../App/Http/Requests/RegisterRequest.php | 4 +- Modules/User/App/Models/Profile.php | 11 +- Modules/User/App/Models/SocialiteUser.php | 2 + Modules/User/App/Models/User.php | 26 +- .../App/Providers/UserServiceProvider.php | 5 +- Modules/User/App/States/ActiveUserStatus.php | 4 +- Modules/User/App/States/BannedUserStatus.php | 4 +- .../User/App/States/SuspendedUserStatus.php | 4 +- Modules/User/App/States/UserStatus.php | 2 + .../User/App/Support/AuthProviderCatalog.php | 2 + Modules/User/App/Support/AuthRedirector.php | 2 + Modules/User/App/Support/DemoUserCatalog.php | 4 +- .../App/Support/Filament/UserFormFields.php | 2 + .../User/Database/Seeders/AuthUserSeeder.php | 2 + .../Database/Seeders/UserWorkspaceSeeder.php | 14 +- ...01_01_000000_create_user_domain_tables.php | 13 +- ..._03_03_080610_create_permission_tables.php | 2 + ...03_092653_create_breezy_sessions_table.php | 2 + ...53_create_personal_access_tokens_table.php | 2 + ...026_03_03_092655_create_passkeys_table.php | 2 + ...03_094518_create_socialite_users_table.php | 2 + .../Filament/Admin/Resources/UserResource.php | 4 +- .../UserResource/Pages/CreateUser.php | 2 + .../Resources/UserResource/Pages/EditUser.php | 3 + .../UserResource/Pages/ListUserActivities.php | 2 + .../UserResource/Pages/ListUsers.php | 2 + Modules/User/README.md | 8 + Modules/User/UserPlugin.php | 4 +- Modules/User/routes/web.php | 2 + .../Database/Seeders/VideoDemoSeeder.php | 2 + .../2026_03_07_000000_create_video_tables.php | 3 + Modules/Video/Enums/VideoStatus.php | 2 + .../Admin/Resources/VideoResource.php | 6 +- .../VideoResource/Pages/CreateVideo.php | 2 + .../VideoResource/Pages/EditVideo.php | 2 + .../VideoResource/Pages/ListVideos.php | 2 + Modules/Video/Jobs/ProcessVideo.php | 2 + Modules/Video/Models/Video.php | 5 + .../Video/Providers/VideoServiceProvider.php | 2 + Modules/Video/README.md | 9 + .../Support/Filament/VideoFormSchema.php | 2 + .../Support/Filament/VideoTableSchema.php | 2 + Modules/Video/Support/VideoTranscoder.php | 2 + Modules/Video/VideoPlugin.php | 7 +- Modules/Video/config/video.php | 2 + README.md | 2 + app/Http/Controllers/Controller.php | 2 + app/Providers/AppServiceProvider.php | 11 +- bootstrap/providers.php | 7 +- composer.json | 14 +- config/activitylog.php | 73 ++ config/auth.php | 4 +- config/database.php | 5 +- config/permission.php | 12 +- config/quick-listing.php | 1 - config/settings.php | 16 +- config/theme.php | 8 - database/factories/UserFactory.php | 2 + .../0001_01_01_000001_create_cache_table.php | 2 + .../0001_01_01_000002_create_jobs_table.php | 2 + database/seeders/DatabaseSeeder.php | 20 +- ...6_03_03_120000_create_general_settings.php | 2 + ...000_add_missing_general_media_settings.php | 2 + lang/ar/messages.php | 1 + lang/de/messages.php | 1 + lang/en/messages.php | 1 + lang/es/messages.php | 1 + lang/fr/messages.php | 1 + lang/it/messages.php | 1 + lang/ja/messages.php | 1 + lang/pt/messages.php | 1 + lang/ru/messages.php | 1 + lang/tr/messages.php | 1 + lang/zh/messages.php | 1 + package.json | 26 +- phpunit.xml.dist | 37 + public/screenshot.jpg | Bin 0 -> 2136010 bytes public/themes/minimal | 1 - public/themes/talldaisy | 1 - resources/css/app.css | 230 ++--- resources/css/modules/panel-quick-create.css | 32 +- resources/js/app.js | 176 +--- resources/js/modules/site-nav.js | 531 +++++++++++ tests/Feature/.gitkeep | 0 tests/TestCase.php | 9 + tests/Unit/.gitkeep | 0 247 files changed, 1556 insertions(+), 2519 deletions(-) create mode 100644 CODE_OF_CONDUCT.md create mode 100644 Modules/Admin/README.md create mode 100644 Modules/Category/README.md delete mode 100644 Modules/Category/resources/views/index.blade.php delete mode 100644 Modules/Category/resources/views/themes/otoplus/index.blade.php create mode 100644 Modules/Conversation/README.md create mode 100644 Modules/Demo/README.md create mode 100644 Modules/Favorite/README.md create mode 100644 Modules/Listing/README.md delete mode 100644 Modules/Listing/resources/views/index.blade.php delete mode 100644 Modules/Listing/resources/views/show.blade.php delete mode 100644 Modules/Listing/resources/views/themes/otoplus/index.blade.php delete mode 100644 Modules/Listing/resources/views/themes/otoplus/show.blade.php create mode 100644 Modules/Location/README.md create mode 100644 Modules/Panel/README.md create mode 100644 Modules/Site/README.md create mode 100644 Modules/Theme/README.md create mode 100644 Modules/User/README.md create mode 100644 Modules/Video/README.md create mode 100644 config/activitylog.php delete mode 100644 config/theme.php create mode 100644 phpunit.xml.dist create mode 100644 public/screenshot.jpg delete mode 120000 public/themes/minimal delete mode 120000 public/themes/talldaisy create mode 100644 resources/js/modules/site-nav.js create mode 100644 tests/Feature/.gitkeep create mode 100644 tests/TestCase.php create mode 100644 tests/Unit/.gitkeep diff --git a/.env.example b/.env.example index 4cda70dbc51..46f4fe70617 100644 --- a/.env.example +++ b/.env.example @@ -3,9 +3,9 @@ APP_ENV=local APP_KEY= APP_DEBUG=true APP_URL=http://localhost:8000 -OC_THEME=otoplus -OC_THEME_LISTING=otoplus -OC_THEME_CATEGORY=otoplus +OC_THEME=default +OC_THEME_LISTING=default +OC_THEME_CATEGORY=default APP_LOCALE=en APP_FALLBACK_LOCALE=en diff --git a/AGENTS.md b/AGENTS.md index 626e2f1e265..12b011d0b09 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,422 +1,11 @@ -Act as a Senior Laravel & FilamentPHP Architect. Refactor the attached code as a greenfield project adhering to the following strict constraints: -1. Architecture: Enforce strict SOLID principles, prioritize brevity, and completely ignore backward compatibility. -2. Cleanup: Remove all legacy code, comments, tests, and PHPDocs. -3. Refactoring: Move all database logic into Models and extract repetitive Filament code into dedicated Helper classes. Identify and fix any existing logical errors. -4. Database: Consolidate migrations into a single file per table or topic (e.g., users, cache, jobs) to reduce the overall number of migration files. -5. Modularity: Use the `laravel-modules` package to encapsulate all features, routing, and Filament resources strictly inside their respective modules. -6. Frontend: Optimize and reduce the CSS footprint while maintaining the exact same visual output. - -=== - - -=== foundation rules === - -# Laravel Boost Guidelines - -The Laravel Boost guidelines are specifically curated by Laravel maintainers for this application. These guidelines should be followed closely to ensure the best experience when building Laravel applications. - -## Foundational Context - -This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions. - -- php - 8.4.18 -- filament/filament (FILAMENT) - v5 -- laravel/ai (AI) - v0 -- laravel/framework (LARAVEL) - v12 -- laravel/prompts (PROMPTS) - v0 -- laravel/reverb (REVERB) - v1 -- laravel/sanctum (SANCTUM) - v4 -- laravel/socialite (SOCIALITE) - v5 -- livewire/livewire (LIVEWIRE) - v4 -- laravel/boost (BOOST) - v2 -- laravel/mcp (MCP) - v0 -- laravel/pail (PAIL) - v1 -- laravel/pint (PINT) - v1 -- laravel/sail (SAIL) - v1 -- phpunit/phpunit (PHPUNIT) - v11 -- alpinejs (ALPINEJS) - v3 -- laravel-echo (ECHO) - v2 -- tailwindcss (TAILWINDCSS) - v3 - -## Skills Activation - -This project has domain-specific skills available. You MUST activate the relevant skill whenever you work in that domain—don't wait until you're stuck. - -- `tailwindcss-development` — Styles applications using Tailwind CSS v3 utilities. Activates when adding styles, restyling components, working with gradients, spacing, layout, flex, grid, responsive design, dark mode, colors, typography, or borders; or when the user mentions CSS, styling, classes, Tailwind, restyle, hero section, cards, buttons, or any visual/UI changes. -- `developing-with-ai-sdk` — Builds AI agents, generates text and chat responses, produces images, synthesizes audio, transcribes speech, generates vector embeddings, reranks documents, and manages files and vector stores using the Laravel AI SDK (laravel/ai). Supports structured output, streaming, tools, conversation memory, middleware, queueing, broadcasting, and provider failover. Use when building, editing, updating, debugging, or testing any AI functionality, including agents, LLMs, chatbots, text generation, image generation, audio, transcription, embeddings, RAG, similarity search, vector stores, prompting, structured output, or any AI provider (OpenAI, Anthropic, Gemini, Cohere, Groq, xAI, ElevenLabs, Jina, OpenRouter). - -## Conventions - -- You must follow all existing code conventions used in this application. When creating or editing a file, check sibling files for the correct structure, approach, and naming. -- Use descriptive names for variables and methods. For example, `isRegisteredForDiscounts`, not `discount()`. -- Check for existing components to reuse before writing a new one. - -## Verification Scripts - -- Do not create verification scripts or tinker when tests cover that functionality and prove they work. Unit and feature tests are more important. - -## Application Structure & Architecture - -- Stick to existing directory structure; don't create new base folders without approval. -- Do not change the application's dependencies without approval. - -## Frontend Bundling - -- If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `npm run build`, `npm run dev`, or `composer run dev`. Ask them. - -## Documentation Files - -- You must only create documentation files if explicitly requested by the user. - -## Replies - -- Be concise in your explanations - focus on what's important rather than explaining obvious details. - -=== boost rules === - -# Laravel Boost - -- Laravel Boost is an MCP server that comes with powerful tools designed specifically for this application. Use them. - -## Artisan - -- Use the `list-artisan-commands` tool when you need to call an Artisan command to double-check the available parameters. - -## URLs - -- Whenever you share a project URL with the user, you should use the `get-absolute-url` tool to ensure you're using the correct scheme, domain/IP, and port. - -## Tinker / Debugging - -- You should use the `tinker` tool when you need to execute PHP to debug code or query Eloquent models directly. -- Use the `database-query` tool when you only need to read from the database. -- Use the `database-schema` tool to inspect table structure before writing migrations or models. - -## Reading Browser Logs With the `browser-logs` Tool - -- You can read browser logs, errors, and exceptions using the `browser-logs` tool from Boost. -- Only recent browser logs will be useful - ignore old logs. - -## Searching Documentation (Critically Important) - -- Boost comes with a powerful `search-docs` tool you should use before trying other approaches when working with Laravel or Laravel ecosystem packages. This tool automatically passes a list of installed packages and their versions to the remote Boost API, so it returns only version-specific documentation for the user's circumstance. You should pass an array of packages to filter on if you know you need docs for particular packages. -- Search the documentation before making code changes to ensure we are taking the correct approach. -- Use multiple, broad, simple, topic-based queries at once. For example: `['rate limiting', 'routing rate limiting', 'routing']`. The most relevant results will be returned first. -- Do not add package names to queries; package information is already shared. For example, use `test resource table`, not `filament 4 test resource table`. - -### Available Search Syntax - -1. Simple Word Searches with auto-stemming - query=authentication - finds 'authenticate' and 'auth'. -2. Multiple Words (AND Logic) - query=rate limit - finds knowledge containing both "rate" AND "limit". -3. Quoted Phrases (Exact Position) - query="infinite scroll" - words must be adjacent and in that order. -4. Mixed Queries - query=middleware "rate limit" - "middleware" AND exact phrase "rate limit". -5. Multiple Queries - queries=["authentication", "middleware"] - ANY of these terms. - -=== php rules === - -# PHP - -- Always use curly braces for control structures, even for single-line bodies. - -## Constructors - -- Use PHP 8 constructor property promotion in `__construct()`. - - `public function __construct(public GitHub $github) { }` -- Do not allow empty `__construct()` methods with zero parameters unless the constructor is private. - -## Type Declarations - -- Always use explicit return type declarations for methods and functions. -- Use appropriate PHP type hints for method parameters. - - -```php -protected function isAccessible(User $user, ?string $path = null): bool -{ - ... -} -``` - -## Enums - -- Typically, keys in an Enum should be TitleCase. For example: `FavoritePerson`, `BestLake`, `Monthly`. - -## Comments - -- Prefer PHPDoc blocks over inline comments. Never use comments within the code itself unless the logic is exceptionally complex. - -## PHPDoc Blocks - -- Add useful array shape type definitions when appropriate. - -=== laravel/core rules === - -# Do Things the Laravel Way - -- Use `php artisan make:` commands to create new files (i.e. migrations, controllers, models, etc.). You can list available Artisan commands using the `list-artisan-commands` tool. -- If you're creating a generic PHP class, use `php artisan make:class`. -- Pass `--no-interaction` to all Artisan commands to ensure they work without user input. You should also pass the correct `--options` to ensure correct behavior. - -## Database - -- Always use proper Eloquent relationship methods with return type hints. Prefer relationship methods over raw queries or manual joins. -- Use Eloquent models and relationships before suggesting raw database queries. -- Avoid `DB::`; prefer `Model::query()`. Generate code that leverages Laravel's ORM capabilities rather than bypassing them. -- Generate code that prevents N+1 query problems by using eager loading. -- Use Laravel's query builder for very complex database operations. - -### Model Creation - -- When creating new models, create useful factories and seeders for them too. Ask the user if they need any other things, using `list-artisan-commands` to check the available options to `php artisan make:model`. - -### APIs & Eloquent Resources - -- For APIs, default to using Eloquent API Resources and API versioning unless existing API routes do not, then you should follow existing application convention. - -## Controllers & Validation - -- Always create Form Request classes for validation rather than inline validation in controllers. Include both validation rules and custom error messages. -- Check sibling Form Requests to see if the application uses array or string based validation rules. - -## Authentication & Authorization - -- Use Laravel's built-in authentication and authorization features (gates, policies, Sanctum, etc.). - -## URL Generation - -- When generating links to other pages, prefer named routes and the `route()` function. - -## Queues - -- Use queued jobs for time-consuming operations with the `ShouldQueue` interface. - -## Configuration - -- Use environment variables only in configuration files - never use the `env()` function directly outside of config files. Always use `config('app.name')`, not `env('APP_NAME')`. - -## Testing - -- When creating models for tests, use the factories for the models. Check if the factory has custom states that can be used before manually setting up the model. -- Faker: Use methods such as `$this->faker->word()` or `fake()->randomDigit()`. Follow existing conventions whether to use `$this->faker` or `fake()`. -- When creating tests, make use of `php artisan make:test [options] {name}` to create a feature test, and pass `--unit` to create a unit test. Most tests should be feature tests. - -## Vite Error - -- If you receive an "Illuminate\Foundation\ViteException: Unable to locate file in Vite manifest" error, you can run `npm run build` or ask the user to run `npm run dev` or `composer run dev`. - -=== laravel/v12 rules === - -# Laravel 12 - -- CRITICAL: ALWAYS use `search-docs` tool for version-specific Laravel documentation and updated code examples. -- Since Laravel 11, Laravel has a new streamlined file structure which this project uses. - -## Laravel 12 Structure - -- In Laravel 12, middleware are no longer registered in `app/Http/Kernel.php`. -- Middleware are configured declaratively in `bootstrap/app.php` using `Application::configure()->withMiddleware()`. -- `bootstrap/app.php` is the file to register middleware, exceptions, and routing files. -- `bootstrap/providers.php` contains application specific service providers. -- The `app\Console\Kernel.php` file no longer exists; use `bootstrap/app.php` or `routes/console.php` for console configuration. -- Console commands in `app/Console/Commands/` are automatically available and do not require manual registration. - -## Database - -- When modifying a column, the migration must include all of the attributes that were previously defined on the column. Otherwise, they will be dropped and lost. -- Laravel 12 allows limiting eagerly loaded records natively, without external packages: `$query->latest()->limit(10);`. - -### Models - -- Casts can and likely should be set in a `casts()` method on a model rather than the `$casts` property. Follow existing conventions from other models. - -=== pint/core rules === - -# Laravel Pint Code Formatter - -- If you have modified any PHP files, you must run `vendor/bin/pint --dirty --format agent` before finalizing changes to ensure your code matches the project's expected style. -- Do not run `vendor/bin/pint --test --format agent`, simply run `vendor/bin/pint --format agent` to fix any formatting issues. - -=== phpunit/core rules === - -# PHPUnit - -- This application uses PHPUnit for testing. All tests must be written as PHPUnit classes. Use `php artisan make:test --phpunit {name}` to create a new test. -- If you see a test using "Pest", convert it to PHPUnit. -- Every time a test has been updated, run that singular test. -- When the tests relating to your feature are passing, ask the user if they would like to also run the entire test suite to make sure everything is still passing. -- Tests should cover all happy paths, failure paths, and edge cases. -- You must not remove any tests or test files from the tests directory without approval. These are not temporary or helper files; these are core to the application. - -## Running Tests - -- Run the minimal number of tests, using an appropriate filter, before finalizing. -- To run all tests: `php artisan test --compact`. -- To run all tests in a file: `php artisan test --compact tests/Feature/ExampleTest.php`. -- To filter on a particular test name: `php artisan test --compact --filter=testName` (recommended after making a change to a related file). - -=== tailwindcss/core rules === - -# Tailwind CSS - -- Always use existing Tailwind conventions; check project patterns before adding new ones. -- IMPORTANT: Always use `search-docs` tool for version-specific Tailwind CSS documentation and updated code examples. Never rely on training data. -- IMPORTANT: Activate `tailwindcss-development` every time you're working with a Tailwind CSS or styling-related task. - -=== filament/filament rules === - -## Filament - -- Filament is used by this application. Follow the existing conventions for how and where it is implemented. -- Filament is a Server-Driven UI (SDUI) framework for Laravel that lets you define user interfaces in PHP using structured configuration objects. Built on Livewire, Alpine.js, and Tailwind CSS. -- Use the `search-docs` tool for official documentation on Artisan commands, code examples, testing, relationships, and idiomatic practices. If `search-docs` is unavailable, refer to https://filamentphp.com/docs. - -### Artisan - -- Always use Filament-specific Artisan commands to create files. Find available commands with the `list-artisan-commands` tool, or run `php artisan --help`. -- Always inspect required options before running a command, and always pass `--no-interaction`. - -### Patterns - -Always use static `make()` methods to initialize components. Most configuration methods accept a `Closure` for dynamic values. - -Use `Get $get` to read other form field values for conditional logic: - - -use Filament\Forms\Components\Select; -use Filament\Forms\Components\TextInput; -use Filament\Schemas\Components\Utilities\Get; - -Select::make('type') - ->options(CompanyType::class) - ->required() - ->live(), - -TextInput::make('company_name') - ->required() - ->visible(fn (Get $get): bool => $get('type') === 'business'), - - - -Use `state()` with a `Closure` to compute derived column values: - - -use Filament\Tables\Columns\TextColumn; - -TextColumn::make('full_name') - ->state(fn (User $record): string => "{$record->first_name} {$record->last_name}"), - - - -Actions encapsulate a button with an optional modal form and logic: - - -use Filament\Actions\Action; -use Filament\Forms\Components\TextInput; - -Action::make('updateEmail') - ->schema([ - TextInput::make('email') - ->email() - ->required(), - ]) - ->action(fn (array $data, User $record) => $record->update($data)) - - - -### Testing - -Always authenticate before testing panel functionality. Filament uses Livewire, so use `Livewire::test()` or `livewire()` (available when `pestphp/pest-plugin-livewire` is in `composer.json`): - - -use function Pest\Livewire\livewire; - -livewire(ListUsers::class) - ->assertCanSeeTableRecords($users) - ->searchTable($users->first()->name) - ->assertCanSeeTableRecords($users->take(1)) - ->assertCanNotSeeTableRecords($users->skip(1)); - - - - -use function Pest\Laravel\assertDatabaseHas; -use function Pest\Livewire\livewire; - -livewire(CreateUser::class) - ->fillForm([ - 'name' => 'Test', - 'email' => 'test@example.com', - ]) - ->call('create') - ->assertNotified() - ->assertRedirect(); - -assertDatabaseHas(User::class, [ - 'name' => 'Test', - 'email' => 'test@example.com', -]); - - - - -use function Pest\Livewire\livewire; - -livewire(CreateUser::class) - ->fillForm([ - 'name' => null, - 'email' => 'invalid-email', - ]) - ->call('create') - ->assertHasFormErrors([ - 'name' => 'required', - 'email' => 'email', - ]) - ->assertNotNotified(); - - - - -use Filament\Actions\DeleteAction; -use function Pest\Livewire\livewire; - -livewire(EditUser::class, ['record' => $user->id]) - ->callAction(DeleteAction::class) - ->assertNotified() - ->assertRedirect(); - - - - -use Filament\Actions\Testing\TestAction; -use function Pest\Livewire\livewire; - -livewire(ListUsers::class) - ->callAction(TestAction::make('promote')->table($user), [ - 'role' => 'admin', - ]) - ->assertNotified(); - - - -### Correct Namespaces - -- Form fields (`TextInput`, `Select`, etc.): `Filament\Forms\Components\` -- Infolist entries (`TextEntry`, `IconEntry`, etc.): `Filament\Infolists\Components\` -- Layout components (`Grid`, `Section`, `Fieldset`, `Tabs`, `Wizard`, etc.): `Filament\Schemas\Components\` -- Schema utilities (`Get`, `Set`, etc.): `Filament\Schemas\Components\Utilities\` -- Actions (`DeleteAction`, `CreateAction`, etc.): `Filament\Actions\`. Never use `Filament\Tables\Actions\`, `Filament\Forms\Actions\`, or any other sub-namespace for actions. -- Icons: `Filament\Support\Icons\Heroicon` enum (e.g., `Heroicon::PencilSquare`) - -### Common Mistakes - -- **Never assume public file visibility.** File visibility is `private` by default. Always use `->visibility('public')` when public access is needed. -- **Never assume full-width layout.** `Grid`, `Section`, and `Fieldset` do not span all columns by default. Explicitly set column spans when needed. - -=== laravel/ai rules === - -## Laravel AI SDK - -- This application uses the Laravel AI SDK (`laravel/ai`) for all AI functionality. -- Activate the `developing-with-ai-sdk` skill when building, editing, updating, debugging, or testing AI agents, text generation, chat, streaming, structured output, tools, image generation, audio, transcription, embeddings, reranking, vector stores, files, conversation memory, or any AI provider integration (OpenAI, Anthropic, Gemini, Cohere, Groq, xAI, ElevenLabs, Jina, OpenRouter). - - +# Architecture & Data +* **Modular Monolith:** Strict boundaries; zero cross-module JOINs. +* **Design:** SOLID, KISS, MVC. Clean Apple style: minimalist, text-minimal, no animations. +* **Database:** PostgreSQL with SoftDeletes everywhere. +* **Logic:** Fat Models handle all DB interactions. +* **Shared Code:** Keep global helpers in the Laravel root. + +# Code Standards +* **Types:** `declare(strict_types=1);` in every file. +* **Language:** : English codebase. Translate each module inside of. +* **Comments:** Zero. Code must be entirely self-documenting. diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 00000000000..813e6d8e4c4 --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,15 @@ +# Code of Conduct + +## Contributing + +For guidelines on how to contribute to this project, please see our [Contributing Guidelines](CONTRIBUTING.md). + +## License + +This project is licensed under an open-source license. For more information on choosing and adding a license, see [Choosing a license](https://docs.github.com/articles/adding-a-license-to-a-repository/). + +## Security Policy + +If you have discovered a security vulnerability, please email us at: **alp@visiosoft.com.tr** + +Please do not open a public GitHub issue for security vulnerabilities. We take security seriously and will respond to your report as soon as possible. diff --git a/Modules/Admin/Database/migrations/2026_03_03_093635_create_activity_log_table.php b/Modules/Admin/Database/migrations/2026_03_03_093635_create_activity_log_table.php index 0fee00b1462..775d4e2c4b7 100644 --- a/Modules/Admin/Database/migrations/2026_03_03_093635_create_activity_log_table.php +++ b/Modules/Admin/Database/migrations/2026_03_03_093635_create_activity_log_table.php @@ -1,5 +1,7 @@ create(config('activitylog.table_name'), function (Blueprint $table): void { - $table->bigIncrements('id'); - $table->string('log_name')->nullable(); - $table->text('description'); - $table->nullableMorphs('subject', 'subject'); - $table->string('event')->nullable(); - $table->nullableMorphs('causer', 'causer'); - $table->json('properties')->nullable(); - $table->uuid('batch_uuid')->nullable(); - $table->timestamps(); - $table->index('log_name'); - }); + Schema::create('activity_log', function (Blueprint $table): void { + $table->id(); + $table->string('log_name')->nullable()->index(); + $table->text('description'); + $table->nullableMorphs('subject', 'subject'); + $table->string('event')->nullable(); + $table->nullableMorphs('causer', 'causer'); + $table->json('attribute_changes')->nullable(); + $table->json('properties')->nullable(); + $table->timestamps(); + }); } public function down(): void { - Schema::connection(config('activitylog.database_connection')) - ->dropIfExists(config('activitylog.table_name')); + Schema::dropIfExists('activity_log'); } }; diff --git a/Modules/Admin/Providers/AdminPanelProvider.php b/Modules/Admin/Providers/AdminPanelProvider.php index 6309c0157be..4b2e05dd667 100644 --- a/Modules/Admin/Providers/AdminPanelProvider.php +++ b/Modules/Admin/Providers/AdminPanelProvider.php @@ -1,5 +1,7 @@ loadMigrationsFrom(module_path('Admin', 'Database/migrations')); } - public function register(): void - {} + public function register(): void {} } diff --git a/Modules/Admin/README.md b/Modules/Admin/README.md new file mode 100644 index 00000000000..081d7067215 --- /dev/null +++ b/Modules/Admin/README.md @@ -0,0 +1,9 @@ +# Admin + +Bootstraps the staff Filament panel at `/admin`. + +`AdminPanelProvider` registers the panel, its plugins (Breezy profile/2FA, impersonation, developer logins, file manager, activity log, state-fusion) and pulls in each domain module's Filament plugin (Category, Listing, Location, Site, User, Video) so their resources appear in the same panel without those modules depending on each other. + +`Support/Filament/ResourceTableActions` and `ResourceTableColumns` are shared, stateless factories for common table columns and row actions, reused across every module's Filament resource to keep resource classes thin. + +Also owns the `activity_log` table migration used by every model with the `LogsActivity` trait. diff --git a/Modules/Admin/Support/Filament/ResourceTableActions.php b/Modules/Admin/Support/Filament/ResourceTableActions.php index 3c699c5c33b..b1b1474ff5d 100644 --- a/Modules/Admin/Support/Filament/ResourceTableActions.php +++ b/Modules/Admin/Support/Filament/ResourceTableActions.php @@ -1,5 +1,7 @@ $childName) { - $childSlug = $data['slug'] . '-' . \Illuminate\Support\Str::slug($childName); + $childSlug = $data['slug'].'-'.Str::slug($childName); Category::updateOrCreate( ['slug' => $childSlug], ['name' => $childName, 'slug' => $childSlug, 'parent_id' => $parent->id, 'level' => 1, 'sort_order' => $i, 'is_active' => true] diff --git a/Modules/Category/Database/migrations/2024_01_01_000002_create_categories_table.php b/Modules/Category/Database/migrations/2024_01_01_000002_create_categories_table.php index a35aa1a3f9b..6d98324c53d 100644 --- a/Modules/Category/Database/migrations/2024_01_01_000002_create_categories_table.php +++ b/Modules/Category/Database/migrations/2024_01_01_000002_create_categories_table.php @@ -1,7 +1,10 @@ id(); $table->string('name'); - $table->string('slug')->unique(); + $table->string('slug'); $table->text('description')->nullable(); $table->string('icon')->nullable(); $table->foreignId('parent_id')->nullable()->constrained('categories')->nullOnDelete(); @@ -19,7 +22,10 @@ public function up(): void $table->integer('sort_order')->default(0); $table->boolean('is_active')->default(true); $table->timestamps(); + $table->softDeletes(); }); + + DB::statement('CREATE UNIQUE INDEX categories_slug_unique ON categories (slug) WHERE deleted_at IS NULL'); } public function down(): void diff --git a/Modules/Category/Filament/Admin/Resources/CategoryResource.php b/Modules/Category/Filament/Admin/Resources/CategoryResource.php index 774daec2f62..8beb5afbc31 100644 --- a/Modules/Category/Filament/Admin/Resources/CategoryResource.php +++ b/Modules/Category/Filament/Admin/Resources/CategoryResource.php @@ -1,5 +1,7 @@ schema([ - TextInput::make('name')->required()->maxLength(255)->live(onBlur: true)->afterStateUpdated(fn ($state, $set) => $set('slug', \Illuminate\Support\Str::slug($state))), + TextInput::make('name')->required()->maxLength(255)->live(onBlur: true)->afterStateUpdated(fn ($state, $set) => $set('slug', Str::slug($state))), TextInput::make('slug')->required()->maxLength(255)->unique(ignoreRecord: true), TextInput::make('description')->maxLength(500), TextInput::make('icon')->maxLength(100), diff --git a/Modules/Category/Filament/Admin/Resources/CategoryResource/Pages/CreateCategory.php b/Modules/Category/Filament/Admin/Resources/CategoryResource/Pages/CreateCategory.php index 841aa486a3f..a3af6649d1e 100644 --- a/Modules/Category/Filament/Admin/Resources/CategoryResource/Pages/CreateCategory.php +++ b/Modules/Category/Filament/Admin/Resources/CategoryResource/Pages/CreateCategory.php @@ -1,5 +1,7 @@ 'img/category/car.png', @@ -41,7 +45,7 @@ public function getActivitylogOptions(): LogOptions return LogOptions::defaults() ->logFillable() ->logOnlyDirty() - ->dontSubmitEmptyLogs(); + ->dontLogEmptyChanges(); } public function parent(): BelongsTo @@ -56,7 +60,7 @@ public function children(): HasMany public function listings(): HasMany { - return $this->hasMany(\Modules\Listing\Models\Listing::class); + return $this->hasMany(Listing::class); } public function scopeActive(Builder $query): Builder @@ -353,12 +357,12 @@ private function collectAncestorIds(): array public function listingCustomFields(): HasMany { - return $this->hasMany(\Modules\Listing\Models\ListingCustomField::class); + return $this->hasMany(ListingCustomField::class); } public function activeListings(): HasMany { - return $this->hasMany(\Modules\Listing\Models\Listing::class)->where('status', 'active'); + return $this->hasMany(Listing::class)->where('status', 'active'); } public function resolvedIconPath(): ?string diff --git a/Modules/Category/Providers/CategoryServiceProvider.php b/Modules/Category/Providers/CategoryServiceProvider.php index 458f335cc6f..2e406a41ad6 100644 --- a/Modules/Category/Providers/CategoryServiceProvider.php +++ b/Modules/Category/Providers/CategoryServiceProvider.php @@ -1,5 +1,7 @@ loadViewsFrom(module_path($this->moduleName, 'resources/views'), 'category'); } - public function register(): void - {} + public function register(): void {} } diff --git a/Modules/Category/README.md b/Modules/Category/README.md new file mode 100644 index 00000000000..0d71e2da8c7 --- /dev/null +++ b/Modules/Category/README.md @@ -0,0 +1,9 @@ +# Category + +The classifieds category taxonomy: a self-referencing tree (`parent_id`) with slug, icon, sort order and active flag. + +- Public routes/controller render the category index and directory pages. +- `Category` model carries the tree-building and lookup logic (root/child queries, listing counts per category, header navigation items, admin hierarchy tree) so controllers and Filament resources stay thin. +- `Filament/Admin/Resources/CategoryResource` manages categories from the admin panel. + +Other modules (Listing, Favorite) depend on `Category` for classification but never query its table directly — they go through the model's public API. diff --git a/Modules/Category/resources/views/index.blade.php b/Modules/Category/resources/views/index.blade.php deleted file mode 100644 index b9ec195522d..00000000000 --- a/Modules/Category/resources/views/index.blade.php +++ /dev/null @@ -1,5 +0,0 @@ -@extends('app::layouts.app') - -@section('content') - @include('category::partials.index-content', ['categories' => $categories]) -@endsection diff --git a/Modules/Category/resources/views/themes/otoplus/index.blade.php b/Modules/Category/resources/views/themes/otoplus/index.blade.php deleted file mode 100644 index b9ec195522d..00000000000 --- a/Modules/Category/resources/views/themes/otoplus/index.blade.php +++ /dev/null @@ -1,5 +0,0 @@ -@extends('app::layouts.app') - -@section('content') - @include('category::partials.index-content', ['categories' => $categories]) -@endsection diff --git a/Modules/Category/routes/web.php b/Modules/Category/routes/web.php index 5ce9962d63c..6c268a0b49a 100644 --- a/Modules/Category/routes/web.php +++ b/Modules/Category/routes/web.php @@ -1,4 +1,6 @@ user(); @@ -124,7 +126,7 @@ public function start(Request $request, Listing $listing): RedirectResponse | Js ->with('success', $messageBody !== '' ? 'Message sent.' : 'Conversation started.'); } - public function send(Request $request, Conversation $conversation): RedirectResponse | JsonResponse + public function send(Request $request, Conversation $conversation): RedirectResponse|JsonResponse { $user = $request->user(); $userId = (int) $user->getKey(); @@ -275,11 +277,11 @@ private function broadcastMessageCreated( if ($participantId === $senderId) { broadcast($event)->toOthers(); + continue; } broadcast($event); } } - } diff --git a/Modules/Conversation/App/Models/Conversation.php b/Modules/Conversation/App/Models/Conversation.php index 144faf6f983..6e4f3cf9596 100644 --- a/Modules/Conversation/App/Models/Conversation.php +++ b/Modules/Conversation/App/Models/Conversation.php @@ -1,17 +1,20 @@ foreignId('buyer_id')->constrained('users')->cascadeOnDelete(); $table->timestamp('last_message_at')->nullable(); $table->timestamps(); + $table->softDeletes(); - $table->unique(['listing_id', 'buyer_id']); $table->index(['seller_id', 'last_message_at']); $table->index(['buyer_id', 'last_message_at']); }); + DB::statement('CREATE UNIQUE INDEX conversations_listing_id_buyer_id_unique ON conversations (listing_id, buyer_id) WHERE deleted_at IS NULL'); + Schema::create('conversation_messages', function (Blueprint $table): void { $table->id(); $table->foreignId('conversation_id')->constrained('conversations')->cascadeOnDelete(); @@ -28,6 +33,7 @@ public function up(): void $table->text('body'); $table->timestamp('read_at')->nullable(); $table->timestamps(); + $table->softDeletes(); $table->index(['conversation_id', 'created_at']); $table->index(['conversation_id', 'read_at']); diff --git a/Modules/Conversation/README.md b/Modules/Conversation/README.md new file mode 100644 index 00000000000..7b51f412317 --- /dev/null +++ b/Modules/Conversation/README.md @@ -0,0 +1,9 @@ +# Conversation + +Realtime buyer/seller messaging tied to a listing. + +- `Conversation` (one per listing/buyer pair) and `ConversationMessage` models hold the inbox and read-state logic. +- Messages broadcast over Laravel Reverb/Echo on a private `users.{id}.inbox` channel via the `InboxMessageCreated` and `ConversationReadUpdated` events. +- The inbox UI (list pane + thread pane) lives under `resources/views`, backed by `resources/assets/js/conversation.js` for live updates. + +A conversation is started from a listing's detail page and always links back to the `Listing` and `User` models by relationship, never by cross-module query. diff --git a/Modules/Conversation/routes/web.php b/Modules/Conversation/routes/web.php index c4832c66ba5..c81540a090c 100644 --- a/Modules/Conversation/routes/web.php +++ b/Modules/Conversation/routes/web.php @@ -1,5 +1,7 @@ \Database\Seeders\DatabaseSeeder::class, + '--class' => DatabaseSeeder::class, '--database' => $this->defaultConnection, '--force' => true, ]); diff --git a/Modules/Demo/App/Support/DemoStoragePath.php b/Modules/Demo/App/Support/DemoStoragePath.php index 3be0eeefe05..2ab418d9689 100644 --- a/Modules/Demo/App/Support/DemoStoragePath.php +++ b/Modules/Demo/App/Support/DemoStoragePath.php @@ -1,5 +1,7 @@ call([ - \Modules\User\Database\Seeders\UserWorkspaceSeeder::class, + UserWorkspaceSeeder::class, ]); } } diff --git a/Modules/Demo/Database/migrations/2026_03_07_000000_create_demo_instances_table.php b/Modules/Demo/Database/migrations/2026_03_07_000000_create_demo_instances_table.php index bee2c384a5b..44cbf3f184a 100644 --- a/Modules/Demo/Database/migrations/2026_03_07_000000_create_demo_instances_table.php +++ b/Modules/Demo/Database/migrations/2026_03_07_000000_create_demo_instances_table.php @@ -1,5 +1,7 @@ redirector->sanitize((string) $request->input('redirect_to', '')); diff --git a/Modules/Favorite/App/Models/FavoriteSearch.php b/Modules/Favorite/App/Models/FavoriteSearch.php index ea4d0e4ea07..c86d571a4bc 100644 --- a/Modules/Favorite/App/Models/FavoriteSearch.php +++ b/Modules/Favorite/App/Models/FavoriteSearch.php @@ -1,13 +1,18 @@ 'array']; diff --git a/Modules/Favorite/App/Providers/FavoriteServiceProvider.php b/Modules/Favorite/App/Providers/FavoriteServiceProvider.php index 7b340c71a7c..b384dc36a80 100644 --- a/Modules/Favorite/App/Providers/FavoriteServiceProvider.php +++ b/Modules/Favorite/App/Providers/FavoriteServiceProvider.php @@ -1,5 +1,7 @@ favoriteListings()->syncWithoutDetaching($payload); } - private function seedFavoriteSeller(User $user, User $seller, \Illuminate\Support\Carbon $timestamp): void + private function seedFavoriteSeller(User $user, User $seller, Carbon $timestamp): void { if ((int) $user->getKey() === (int) $seller->getKey()) { return; diff --git a/Modules/Favorite/Database/migrations/2026_03_04_000000_create_favorites_tables.php b/Modules/Favorite/Database/migrations/2026_03_04_000000_create_favorites_tables.php index 350194c75ea..d438fbd2275 100644 --- a/Modules/Favorite/Database/migrations/2026_03_04_000000_create_favorites_tables.php +++ b/Modules/Favorite/Database/migrations/2026_03_04_000000_create_favorites_tables.php @@ -1,7 +1,10 @@ json('filters')->nullable(); $table->string('signature', 64); $table->timestamps(); - - $table->unique(['user_id', 'signature']); + $table->softDeletes(); }); + + DB::statement('CREATE UNIQUE INDEX favorite_searches_user_id_signature_unique ON favorite_searches (user_id, signature) WHERE deleted_at IS NULL'); } public function down(): void diff --git a/Modules/Favorite/README.md b/Modules/Favorite/README.md new file mode 100644 index 00000000000..a2f72d820c4 --- /dev/null +++ b/Modules/Favorite/README.md @@ -0,0 +1,7 @@ +# Favorite + +Everything a buyer can save for later: favorited listings, favorited sellers, and saved searches. + +- Favoriting a listing/seller is a simple pivot toggle, implemented on the `User` model (`toggleFavoriteListing`, `toggleFavoriteSeller`). +- `FavoriteSearch` is the one real entity this module owns: a named, de-duplicated (by signature) saved search with its filters serialized as JSON. +- The favorites index page lists saved listings, sellers, and searches for the current user. diff --git a/Modules/Favorite/routes/web.php b/Modules/Favorite/routes/web.php index 79d30bf97c9..c2af9fb92e9 100644 --- a/Modules/Favorite/routes/web.php +++ b/Modules/Favorite/routes/web.php @@ -1,5 +1,7 @@ statusForIndex($index)) { 'expired' => now()->subDays(4 + ($index % 5)), diff --git a/Modules/Listing/Database/Seeders/ListingSeeder.php b/Modules/Listing/Database/Seeders/ListingSeeder.php index 7160aaf79b4..95b19d16938 100644 --- a/Modules/Listing/Database/Seeders/ListingSeeder.php +++ b/Modules/Listing/Database/Seeders/ListingSeeder.php @@ -1,5 +1,7 @@ id(); $table->string('title'); - $table->string('slug')->unique(); + $table->string('slug'); $table->text('description')->nullable(); $table->decimal('price', 10, 2)->nullable(); $table->string('currency', 3)->default('USD'); @@ -30,11 +33,14 @@ public function up(): void $table->decimal('latitude', 10, 7)->nullable(); $table->decimal('longitude', 10, 7)->nullable(); $table->timestamps(); + $table->softDeletes(); }); + DB::statement('CREATE UNIQUE INDEX listings_slug_unique ON listings (slug) WHERE deleted_at IS NULL'); + Schema::create('listing_custom_fields', function (Blueprint $table): void { $table->id(); - $table->string('name')->unique(); + $table->string('name'); $table->string('label'); $table->string('type', 32); $table->foreignId('category_id')->nullable()->constrained('categories')->nullOnDelete(); @@ -45,7 +51,10 @@ public function up(): void $table->boolean('is_active')->default(true); $table->unsignedInteger('sort_order')->default(0); $table->timestamps(); + $table->softDeletes(); }); + + DB::statement('CREATE UNIQUE INDEX listing_custom_fields_name_unique ON listing_custom_fields (name) WHERE deleted_at IS NULL'); } public function down(): void diff --git a/Modules/Listing/Database/migrations/2026_03_03_085614_create_media_table.php b/Modules/Listing/Database/migrations/2026_03_03_085614_create_media_table.php index e1fa63b1e07..f04e044cbb6 100644 --- a/Modules/Listing/Database/migrations/2026_03_03_085614_create_media_table.php +++ b/Modules/Listing/Database/migrations/2026_03_03_085614_create_media_table.php @@ -1,5 +1,7 @@ logFillable() ->logOnlyDirty() - ->dontSubmitEmptyLogs(); + ->dontLogEmptyChanges(); } public function category() @@ -604,9 +607,6 @@ public function canRevealContactTo(?User $user): bool return (int) $this->user_id !== (int) $user->getKey(); } - /** - * @return array{phone: string, email: string} - */ public function contactDetailsFor(?User $user): array { $canAccess = $this->canRevealContactTo($user) @@ -743,7 +743,7 @@ private function applyAdminStatus(mixed $status): void }, }; - if ($this->status::class === $target) { + if ($target === $this->status::class) { return; } diff --git a/Modules/Listing/Models/ListingCustomField.php b/Modules/Listing/Models/ListingCustomField.php index 13c4fce0637..fb03b437c15 100644 --- a/Modules/Listing/Models/ListingCustomField.php +++ b/Modules/Listing/Models/ListingCustomField.php @@ -1,14 +1,19 @@ belongsTo(\Modules\Category\Models\Category::class); + return $this->belongsTo(Category::class); } public function scopeActive(Builder $query): Builder diff --git a/Modules/Listing/Providers/ListingServiceProvider.php b/Modules/Listing/Providers/ListingServiceProvider.php index 04e4bfd278c..7098d858cf1 100644 --- a/Modules/Listing/Providers/ListingServiceProvider.php +++ b/Modules/Listing/Providers/ListingServiceProvider.php @@ -1,5 +1,7 @@ loadRoutesFrom(module_path($this->moduleName, 'routes/web.php')); } - public function register(): void - {} + public function register(): void {} } diff --git a/Modules/Listing/README.md b/Modules/Listing/README.md new file mode 100644 index 00000000000..53454890fe1 --- /dev/null +++ b/Modules/Listing/README.md @@ -0,0 +1,10 @@ +# Listing + +The core classifieds entity: title, price, category, location, media, custom fields, and a status lifecycle (pending, active, sold, expired) modeled with `spatie/laravel-model-states`. + +- `Listing` is a deliberately fat model: browse/search scopes, media handling (gallery/card/thumbnail conversions via Spatie MediaLibrary), status transitions, and every read model used by the public pages and the panel dashboard all live here rather than in controllers. +- Public browsing (`ListingController`) renders through the pluggable theme system (`Modules/Theme`) — see `resources/views/themes/default` for the active theme and `resources/views/themes/README.md` for how theming works. +- `ListingCustomField` defines the dynamic, per-category form fields shown when creating a listing. +- `Filament/Admin/Resources/ListingResource` is the staff admin view, including moderation and dashboard widgets. + +Depends on `Category`, `Location`, `User`, `Video`, and `Conversation` only through their models' public relationships/APIs — never raw joins across module tables. diff --git a/Modules/Listing/States/ActiveListingStatus.php b/Modules/Listing/States/ActiveListingStatus.php index 5f41e2ac33f..4ab00792cd2 100644 --- a/Modules/Listing/States/ActiveListingStatus.php +++ b/Modules/Listing/States/ActiveListingStatus.php @@ -1,5 +1,7 @@ name ?? '')) !== '' ? trim((string) $selectedCategory->name).' Listings and Prices' : 'All Listings and Prices') - -@section('content') - @include('listing::partials.index-content') -@endsection diff --git a/Modules/Listing/resources/views/show.blade.php b/Modules/Listing/resources/views/show.blade.php deleted file mode 100644 index 50e27b959df..00000000000 --- a/Modules/Listing/resources/views/show.blade.php +++ /dev/null @@ -1,115 +0,0 @@ -@extends('app::layouts.app') -@section('content') -@php - $title = trim((string) ($listing->title ?? '')); - $displayTitle = ($title !== '' && preg_match('/[\pL\pN]/u', $title)) ? $title : 'Untitled listing'; - - $city = trim((string) ($listing->city ?? '')); - $country = trim((string) ($listing->country ?? '')); - $location = implode(', ', array_filter([$city, $country], fn ($value) => $value !== '')); - - $description = trim((string) ($listing->description ?? '')); - $displayDescription = ($description !== '' && preg_match('/[\pL\pN]/u', $description)) - ? $description - : 'No description provided.'; - - $hasPrice = !is_null($listing->price); - $priceValue = $hasPrice ? (float) $listing->price : null; -@endphp -
-
-
-
- -
-
-
-

{{ $displayTitle }}

- - @if($hasPrice) - @if($priceValue > 0) - {{ number_format($priceValue, 0) }} {{ $listing->currency ?? 'USD' }} - @else - Free - @endif - @else - Price on request - @endif - -
-
- @auth -
- @csrf - -
- @if($listing->user && (int) $listing->user->id !== (int) auth()->id()) -
- @csrf - -
- @if($existingConversationId) - - Open chat - - @else -
- @csrf - -
- @endif - @endif - @else - - Log in to save - - @endauth -
-

{{ $location !== '' ? $location : 'Location not specified' }}

-

Posted {{ $listing->created_at?->diffForHumans() ?? 'recently' }}

-
-

Description

-

{{ $displayDescription }}

-
- @if(($presentableCustomFields ?? []) !== []) -
-

Listing details

-
- @foreach($presentableCustomFields as $field) -
-

{{ $field['label'] }}

-

{{ $field['value'] }}

-
- @endforeach -
-
- @endif -
-

Contact Seller

- @if($listing->user) -

Name: {{ $listing->user->name }}

- @endif - @if($listing->contact_phone) -

Phone: {{ $listing->contact_phone }}

- @endif - @if($listing->contact_email) -

Email: {{ $listing->contact_email }}

- @endif - @if(!$listing->contact_phone && !$listing->contact_email) -

No contact details provided.

- @endif -
-
- ← Back to listings -
-
-
-
-
-@endsection diff --git a/Modules/Listing/resources/views/themes/README.md b/Modules/Listing/resources/views/themes/README.md index 7984fb255c6..0052b981fe2 100644 --- a/Modules/Listing/resources/views/themes/README.md +++ b/Modules/Listing/resources/views/themes/README.md @@ -1,6 +1,6 @@ # Listing Theme Contract -Active template is resolved from `config('theme.modules.listing')`. +Active template is resolved from `config('theme.modules.listing')`, defaulting to `default`. Directory structure: @@ -11,7 +11,6 @@ Fallback order: 1. `listing::themes.{active}.{view}` 2. `listing::themes.default.{view}` -3. `listing::{view}` To add a new theme: diff --git a/Modules/Listing/resources/views/themes/otoplus/index.blade.php b/Modules/Listing/resources/views/themes/otoplus/index.blade.php deleted file mode 100644 index 561bb9a1b65..00000000000 --- a/Modules/Listing/resources/views/themes/otoplus/index.blade.php +++ /dev/null @@ -1,7 +0,0 @@ -@extends('app::layouts.app') - -@section('title', trim((string) ($selectedCategory?->name ?? '')) !== '' ? trim((string) $selectedCategory->name).' Listings and Prices' : 'All Listings and Prices') - -@section('content') - @include('listing::partials.index-content') -@endsection diff --git a/Modules/Listing/resources/views/themes/otoplus/show.blade.php b/Modules/Listing/resources/views/themes/otoplus/show.blade.php deleted file mode 100644 index cdcc4ccf41e..00000000000 --- a/Modules/Listing/resources/views/themes/otoplus/show.blade.php +++ /dev/null @@ -1,854 +0,0 @@ -@extends('app::layouts.app') - -@section('content') -@php - $title = trim((string) ($listing->title ?? '')); - $displayTitle = $title !== '' ? $title : 'Untitled listing'; - - $priceLabel = 'Price on request'; - if (! is_null($listing->price)) { - $priceValue = (float) $listing->price; - $formattedPrice = number_format($priceValue, 2, '.', ','); - $formattedPrice = rtrim(rtrim($formattedPrice, '0'), '.'); - $priceLabel = $priceValue > 0 - ? $formattedPrice.' '.($listing->currency ?: 'TRY') - : 'Free'; - } - - $locationLabel = collect([$listing->city, $listing->country]) - ->filter(fn ($value) => is_string($value) && trim($value) !== '') - ->implode(' / '); - - $publishedAt = $listing->created_at?->format('M j, Y') ?? 'Recently'; - $postedAgo = $listing->created_at?->diffForHumans() ?? 'Listed recently'; - $galleryImages = collect($gallery ?? []) - ->filter(fn ($value) => is_array($value) && is_array($value['gallery'] ?? null)) - ->values() - ->all(); - $initialGalleryImage = $galleryImages[0]['gallery'] ?? null; - $galleryCount = count($galleryImages); - - $description = trim((string) ($listing->description ?? '')); - $displayDescription = $description !== '' ? $description : 'No description added for this listing.'; - - $sellerName = trim((string) ($listing->user?->name ?? 'Marketplace Seller')); - $sellerInitial = mb_strtoupper(mb_substr($sellerName, 0, 1)); - $sellerMemberText = $listing->user?->created_at - ? 'Member since '.$listing->user->created_at->format('M Y') - : 'New seller'; - - $referenceCode = '#'.str_pad((string) $listing->getKey(), 8, '0', STR_PAD_LEFT); - $isOwnListing = auth()->check() && (int) auth()->id() === (int) $listing->user_id; - $canStartConversation = auth()->check() && $listing->user && ! $isOwnListing; - $loginRedirectRoute = route('login', ['redirect' => request()->fullUrl()]); - $chatConversation = $detailConversation ?? null; - $chatMessages = $chatConversation?->messages ?? collect(); - $chatSendUrl = $chatConversation ? route('conversations.messages.send', $chatConversation) : ''; - $chatReadUrl = $chatConversation ? route('conversations.read', $chatConversation) : ''; - $chatStartUrl = route('conversations.start', $listing); - $chatUnreadCount = max(0, (int) ($chatConversation?->unread_count ?? 0)); - - $hasContactDetails = $listing->hasContactDetails(); - $hasContactPhone = filled($listing->contact_phone); - $hasContactEmail = filled($listing->contact_email); - $canRevealContact = auth()->check() && ! $isOwnListing && $hasContactDetails; - $contactRevealUrl = route('listings.contact', $listing); - - $primaryContactHref = null; - $primaryContactLabel = 'Call'; - $primaryContactType = null; - - if ($isOwnListing) { - if ($hasContactPhone) { - $primaryContactHref = 'tel:'.preg_replace('/\s+/', '', (string) $listing->contact_phone); - $primaryContactLabel = 'Call'; - $primaryContactType = 'phone'; - } elseif ($hasContactEmail) { - $primaryContactHref = 'mailto:'.$listing->contact_email; - $primaryContactLabel = 'Email'; - $primaryContactType = 'email'; - } - } elseif ($hasContactDetails) { - if ($hasContactPhone) { - $primaryContactLabel = 'Call'; - $primaryContactType = 'phone'; - } elseif ($hasContactEmail) { - $primaryContactLabel = 'Email'; - $primaryContactType = 'email'; - } - } - - $reportEmail = config('mail.from.address', 'support@example.com'); - $reportUrl = 'mailto:'.$reportEmail.'?subject='.rawurlencode('Report listing '.$referenceCode); - $shareUrl = route('listings.show', $listing); - - $detailRows = collect([ - ['label' => 'Listing ID', 'value' => $referenceCode], - ['label' => 'Published', 'value' => $publishedAt], - ['label' => 'Category', 'value' => $listing->category?->name ?? 'General'], - ['label' => 'Location', 'value' => $locationLabel !== '' ? $locationLabel : 'Not specified'], - ]) - ->merge( - collect($presentableCustomFields ?? [])->map(fn (array $field) => [ - 'label' => trim((string) ($field['label'] ?? '')), - 'value' => trim((string) ($field['value'] ?? '')), - ]) - ) - ->filter(fn (array $item) => $item['label'] !== '' && $item['value'] !== '') - ->unique(fn (array $item) => mb_strtolower($item['label'])) - ->values(); - $summaryRows = $detailRows->take(8); - $sellerListingsUrl = $listing->user ? route('listings.index', ['user' => $listing->user->getKey()]) : route('listings.index'); - $locationText = $locationLabel !== '' ? $locationLabel : 'Location not specified'; -@endphp - -
- - -
-
-

{{ $referenceCode }}

-

{{ $displayTitle }}

-
- {{ $listing->category?->name ?? 'Marketplace listing' }} - {{ $sellerName }} - {{ $postedAgo }} -
-
- -
-
- - - @auth -
- @csrf - -
- @else - Save listing - @endauth - - -
-
-
- -
-
-
-
-
Photo gallery
-
- - @if($initialGalleryImage) - - - - {{ $displayTitle }} - - @else -
No photos uploaded yet.
- @endif - - @if($galleryCount > 1) - - - @endif - - @if($galleryCount > 0) -
- 1 / {{ $galleryCount }} -
- @endif -
- - @if($galleryImages !== []) -
- @foreach($galleryImages as $index => $image) - @php - $galleryImage = $image['gallery'] ?? null; - $thumbImage = $image['thumb'] ?? $galleryImage; - @endphp - - @endforeach -
- @endif -
- -
-
-
{{ $priceLabel }}
-
{{ $publishedAt }}
-
- -
{{ $locationText }}
- -
- @foreach($summaryRows as $row) -
- {{ $row['label'] }} - {{ $row['value'] }} -
- @endforeach -
- - Report this listing -
- - -
- -
-
- - -
- -
-
- @foreach($detailRows as $row) -
- {{ $row['label'] }} - {{ $row['value'] }} -
- @endforeach -
-
- -
-
- {!! nl2br(e($displayDescription)) !!} -
-
-
- - @if(($listingVideos ?? collect())->isNotEmpty()) -
-
-
-

Videos

-

Additional media attached to the listing.

-
-
- -
- @foreach($listingVideos as $video) -
- -

{{ $video->titleLabel() }}

-
- @endforeach -
-
- @endif - -
-
-
- @if(! $listing->user) - - @elseif($canStartConversation) - - @elseif($isOwnListing) - - @else - Message - @endif - - @if($primaryContactHref) - {{ $primaryContactLabel }} - @elseif($primaryContactType && $canRevealContact) - - @elseif($primaryContactType && ! auth()->check()) - {{ $primaryContactLabel }} - @else - - @endif -
-
-
- - @if($canStartConversation) - - @endif - - @if(($relatedListings ?? collect())->isNotEmpty() || ($themePillCategories ?? collect())->isNotEmpty()) -
- @if(($relatedListings ?? collect())->isNotEmpty()) -
-
-

Similar listings

-

More listings with a similar category and visual profile.

-
-
- -
- - -
- @foreach(($relatedListings ?? collect()) as $related) - @php - $relatedImage = $related->primaryImageData('card'); - $relatedPrice = 'Price on request'; - if (! is_null($related->price)) { - $relatedPriceValue = (float) $related->price; - $relatedFormattedPrice = number_format($relatedPriceValue, 2, '.', ','); - $relatedFormattedPrice = rtrim(rtrim($relatedFormattedPrice, '0'), '.'); - $relatedPrice = $relatedPriceValue > 0 - ? $relatedFormattedPrice.' '.($related->currency ?: 'TRY') - : 'Free'; - } - @endphp - - -
- @if($relatedImage) - @include('listing::partials.responsive-image', [ - 'image' => $relatedImage, - 'alt' => $related->title, - 'class' => 'w-full h-full object-cover', - ]) - @endif -
-
-
{{ $relatedPrice }}
-
{{ $related->title }}
-
{{ trim(collect([$related->city, $related->country])->filter()->implode(', ')) }}
-
- - @endforeach -
- - -
- @endif - - @if(($themePillCategories ?? collect())->isNotEmpty()) -
-

Explore categories

-
- @foreach(($themePillCategories ?? collect()) as $pillCategory) - {{ $pillCategory->name }} - @endforeach -
-
- @endif -
- @endif -
- - -@endsection diff --git a/Modules/Listing/routes/web.php b/Modules/Listing/routes/web.php index cacf366d205..f566a25704b 100644 --- a/Modules/Listing/routes/web.php +++ b/Modules/Listing/routes/web.php @@ -1,4 +1,6 @@ id(); $table->string('name'); - $table->string('code', 3)->unique(); + $table->string('code', 3); $table->string('phone_code', 10)->nullable(); $table->string('flag', 10)->nullable(); $table->boolean('is_active')->default(true); $table->timestamps(); + $table->softDeletes(); }); + DB::statement('CREATE UNIQUE INDEX countries_code_unique ON countries (code) WHERE deleted_at IS NULL'); + Schema::create('cities', function (Blueprint $table) { $table->id(); $table->string('name'); $table->foreignId('country_id')->constrained('countries')->cascadeOnDelete(); $table->boolean('is_active')->default(true); $table->timestamps(); + $table->softDeletes(); }); Schema::create('districts', function (Blueprint $table) { @@ -32,6 +39,7 @@ public function up(): void $table->foreignId('city_id')->constrained('cities')->cascadeOnDelete(); $table->boolean('is_active')->default(true); $table->timestamps(); + $table->softDeletes(); }); Schema::create('neighborhoods', function (Blueprint $table) { @@ -40,6 +48,7 @@ public function up(): void $table->foreignId('district_id')->constrained('districts')->cascadeOnDelete(); $table->boolean('is_active')->default(true); $table->timestamps(); + $table->softDeletes(); }); } diff --git a/Modules/Location/Filament/Admin/Resources/CityResource.php b/Modules/Location/Filament/Admin/Resources/CityResource.php index 9e2dc971aac..cb88464936e 100644 --- a/Modules/Location/Filament/Admin/Resources/CityResource.php +++ b/Modules/Location/Filament/Admin/Resources/CityResource.php @@ -1,5 +1,7 @@ logFillable() ->logOnlyDirty() - ->dontSubmitEmptyLogs(); + ->dontLogEmptyChanges(); } public function country(): BelongsTo diff --git a/Modules/Location/Models/Country.php b/Modules/Location/Models/Country.php index d93ba22d702..a943a37d77d 100644 --- a/Modules/Location/Models/Country.php +++ b/Modules/Location/Models/Country.php @@ -1,16 +1,19 @@ logFillable() ->logOnlyDirty() - ->dontSubmitEmptyLogs(); + ->dontLogEmptyChanges(); } public function cities(): HasMany diff --git a/Modules/Location/Models/District.php b/Modules/Location/Models/District.php index 32866899f87..373a475c8bb 100644 --- a/Modules/Location/Models/District.php +++ b/Modules/Location/Models/District.php @@ -1,15 +1,20 @@ 'boolean']; public function getActivitylogOptions(): LogOptions @@ -17,8 +22,11 @@ public function getActivitylogOptions(): LogOptions return LogOptions::defaults() ->logFillable() ->logOnlyDirty() - ->dontSubmitEmptyLogs(); + ->dontLogEmptyChanges(); } - public function city() { return $this->belongsTo(City::class); } + public function city() + { + return $this->belongsTo(City::class); + } } diff --git a/Modules/Location/Providers/LocationServiceProvider.php b/Modules/Location/Providers/LocationServiceProvider.php index 3f2383f99e9..c35023241a1 100644 --- a/Modules/Location/Providers/LocationServiceProvider.php +++ b/Modules/Location/Providers/LocationServiceProvider.php @@ -1,5 +1,7 @@ loadRoutesFrom(module_path($this->moduleName, 'routes/web.php')); } - public function register(): void - {} + public function register(): void {} } diff --git a/Modules/Location/README.md b/Modules/Location/README.md new file mode 100644 index 00000000000..97cb67fc287 --- /dev/null +++ b/Modules/Location/README.md @@ -0,0 +1,9 @@ +# Location + +The geographic hierarchy used for listing locations and browse filters: `Country` → `City` → `District` → neighborhood. + +- Each level model carries its own lookup/option-building helpers (`nameOptions`, `districtPayloads`, `resolveLookup`, etc.) used by both the public location picker and the panel's quick-create form. +- `LocationLookupController` exposes a small JSON endpoint for cascading country → city → district selects. +- `Filament/Admin/Resources` manage countries, cities, and districts from the admin panel. + +Listing does not join against these tables directly; it stores denormalized `city`/`country` strings plus latitude/longitude, populated through this module's lookups at creation time. diff --git a/Modules/Location/Support/CountryCodeManager.php b/Modules/Location/Support/CountryCodeManager.php index 7b8ada62aeb..24c565627eb 100644 --- a/Modules/Location/Support/CountryCodeManager.php +++ b/Modules/Location/Support/CountryCodeManager.php @@ -1,5 +1,7 @@ @if(! $demoLandingMode) @if($simplePage) -