Initial commit: LaraArchitect v1.0.0

Author: Karim-Ashraf

.gitattributes

@@ -0,0 +1,10 @@
+* text=auto eol=lf
+
+/.github export-ignore
+/docs export-ignore
+/tests export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/phpunit.xml export-ignore
+/phpstan.neon.dist export-ignore
+/pint.json export-ignore

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug Report
+about: Report a problem with LaraArchitect
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Description
+
+<!-- A clear and concise description of what the bug is -->
+
+## Steps To Reproduce
+
+<!-- If the bug involves the generator, include the exact `make:module` command and any relevant config -->
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+<!-- What you expected to happen -->
+
+## Actual Behavior
+
+<!-- What actually happened. Include error output / generated code if relevant -->
+
+## Environment
+
+- PHP Version:
+- Laravel Version:
+- LaraArchitect Version:
+- OS:
+
+## Additional Context
+
+<!-- Anything else that might help: published config, custom stubs, custom generators, ... -->

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature Request
+about: Suggest an idea for LaraArchitect
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Is your feature request related to a problem?
+
+<!-- A clear and concise description of what the problem is -->
+
+## Describe the solution you'd like
+
+<!-- A clear and concise description of what you want to happen.
+     For new patterns/generators, describe the files you'd expect `make:module` to produce -->
+
+## Describe alternatives you've considered
+
+<!-- Any alternative solutions or workarounds you've considered,
+     e.g. a custom generator registered via config -->
+
+## Additional context
+
+<!-- Add any other context or code examples about the feature request here -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Description
+
+<!-- Describe your changes in detail -->
+
+## Motivation and Context
+
+<!-- Why is this change required? What problem does it solve?
+     Link related issues: Fixes #123 -->
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change)
+- [ ] New feature (non-breaking change)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+
+## How Has This Been Tested?
+
+<!-- Describe the tests you added or ran -->
+
+## Checklist
+
+- [ ] `composer test` passes
+- [ ] `composer analyse` (PHPStan) passes
+- [ ] `composer format` (Pint) has been run
+- [ ] I have added tests covering my changes
+- [ ] I have updated `README.md` where behavior changed
+- [ ] I have added an entry under `[Unreleased]` in `CHANGELOG.md`

.github/workflows/tests.yml

@@ -0,0 +1,102 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ['8.2', '8.3', '8.4', '8.5']
+        laravel: ['11.*', '12.*', '13.*']
+        stability: [prefer-stable]
+        include:
+          - laravel: '11.*'
+            testbench: '9.*'
+          - laravel: '12.*'
+            testbench: '10.*'
+          - laravel: '13.*'
+            testbench: '11.*'
+        exclude:
+          # Laravel 13 requires PHP 8.3+
+          - laravel: '13.*'
+            php: '8.2'
+          # Laravel 11 supports PHP 8.2 - 8.4
+          - laravel: '11.*'
+            php: '8.5'
+
+    name: P${{ matrix.php }} - L${{ matrix.laravel }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, curl, libxml, mbstring, zip, pdo, sqlite, pdo_sqlite, bcmath, intl, iconv
+          coverage: none
+
+      - name: Setup problem matchers
+        run: |
+          echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+          echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+      - name: Install dependencies
+        run: |
+          composer require "illuminate/support:${{ matrix.laravel }}" --no-interaction --no-update
+          composer require --dev "orchestra/testbench:${{ matrix.testbench }}" --no-interaction --no-update
+          composer update --${{ matrix.stability }} --prefer-dist --no-interaction
+
+      - name: Execute tests
+        run: vendor/bin/phpunit --no-coverage
+
+  phpstan:
+    runs-on: ubuntu-latest
+
+    name: PHPStan
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: dom, curl, libxml, mbstring, zip, pdo, sqlite, pdo_sqlite, bcmath, intl, iconv
+          coverage: none
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction
+
+      - name: Run PHPStan
+        run: vendor/bin/phpstan analyse --no-progress
+
+  pint:
+    runs-on: ubuntu-latest
+
+    name: Pint
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          coverage: none
+
+      - name: Install dependencies
+        run: composer update --prefer-dist --no-interaction
+
+      - name: Run Pint
+        run: vendor/bin/pint --test

.gitignore

@@ -0,0 +1,6 @@
+/vendor/
+/coverage/
+composer.lock
+.phpunit.result.cache
+.phpunit.cache/
+.DS_Store

CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to `lara-architect` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-07-21
+
+### Added
+
+- **Architecture building blocks**
+  - `BaseService` with transactional CRUD, lifecycle hooks (`created`, `updated`, `deleted`, `restored`, `forceDeleted`) and repository delegation.
+  - `BaseRepository` with full CRUD, eager loading, pagination and `getBy` criteria queries.
+  - `BaseAction` for single-purpose, transaction-wrapped operations.
+  - `BaseData` DTO with array/request hydration, backed-enum support and `toArray()` serialization.
+  - Contracts (`Repository`, `CrudService`, `Action`) for container binding and swappable implementations.
+- **Soft-delete aware operations**
+  - `deleteMany()`, `deleteAll()`, `restore()`, `restoreAll()`, `forceDelete()` and `trashed()` on repositories and services.
+  - `SoftDeletesNotEnabledException` thrown when soft-delete operations are used on models without the `SoftDeletes` trait.
+- **Query filters**
+  - `QueryFilter` base class mapping request query parameters to filter methods.
+  - `Filterable` model trait providing a `filter()` scope.
+  - `filter()` method on repositories and services returning paginated, filtered results.
+- **Module generator** (`php artisan make:module`)
+  - Architecture presets: `service-repository`, `actions`, and custom presets via config.
+  - Field definition syntax (`--fields="title:string, status:enum, price:decimal:nullable"`) driving migrations, validation, casts, factories and DTOs.
+  - Generators for model, migration, factory, service, repository, action, DTO, controller, form requests, API resources, enums and query filters.
+  - Publishable, customizable stubs.
+- **HTTP layer**
+  - `BaseFormRequest` with a consistent JSON validation error envelope.
+  - `RespondsWithJson` controller trait (`respondSuccess`, `respondCreated`, `respondDeleted`, `respondError`).
+- **Model concerns**: `HasUuid` trait with configurable UUID column.
+- **Enum support**: string-backed enum generation wired into model casts, `Rule::enum()` validation, factories and DTO property types.
+- `architect:patterns` command listing registered generators and presets.
+- Support for Laravel 11, 12 and 13 (PHP 8.2 – 8.5, per framework requirements).
+- Full test suite (PHPUnit via Orchestra Testbench), PHPStan level 5 (Larastan) and Laravel Pint.
+
+[Unreleased]: https://github.com/karim-ashraf/lara-architect/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/karim-ashraf/lara-architect/releases/tag/v1.0.0

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to LaraArchitect
+
+Thank you for considering contributing to LaraArchitect! Contributions of all kinds are welcome: bug reports, feature ideas, documentation improvements and pull requests.
+
+## Reporting issues
+
+Before opening an issue, please:
+
+1. Search existing issues to avoid duplicates.
+2. Include the package version, Laravel version and PHP version.
+3. Provide a minimal reproduction — the `make:module` command you ran, the relevant config, and the actual vs. expected output.
+
+For security vulnerabilities, please **do not** open a public issue. Email the maintainer instead.
+
+## Development setup
+
+```bash
+git clone https://github.com/karim-ashraf/lara-architect.git
+cd lara-architect
+composer install
+```
+
+The test suite boots a full Laravel application through [Orchestra Testbench](https://github.com/orchestral/testbench), so no separate Laravel app is required.
+
+## Before submitting a pull request
+
+Run the full verification suite locally — CI runs the same three checks against every supported PHP/Laravel combination:
+
+```bash
+composer test      # PHPUnit (unit + feature tests)
+composer analyse   # PHPStan level 5 (Larastan)
+composer format    # Laravel Pint (code style)
+```
+
+All three must pass. A few guidelines:
+
+- **Add tests.** New features need feature or unit tests; bug fixes need a regression test that fails without the fix.
+- **Keep PRs focused.** One feature or fix per pull request makes review faster.
+- **Follow the existing style.** Pint enforces formatting; PHPStan enforces type safety. New public methods should carry proper generics/docblocks where Eloquent types are involved.
+- **Update documentation.** If you change behavior or add a feature, update `README.md` and add an entry under `[Unreleased]` in `CHANGELOG.md`.
+- **Stubs and generators.** When adding a new pattern generator, register it in `config/lara-architect.php`, add its stub under `stubs/`, and cover it in `tests/Feature/MakeModuleCommandTest.php`.
+
+## Commit messages
+
+Use clear, imperative commit messages (e.g. `Add restoreAll support to BaseRepository`). Reference related issues where applicable (`Fixes #12`).
+
+## Branching
+
+- Create feature branches from `main`.
+- Target pull requests at `main`.
+
+## Code of conduct
+
+Be respectful and constructive. We want this to be a welcoming project for everyone.

LICENSE.md

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) 2026 Karim Ashraf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.