refactor: adopt modular domain architecture (#747)

* refactor: stabilize model identities for domain migration * refactor: extract module platform context * refactor: assign models to domain contexts * refactor: extract ai platform context * refactor: extract storage platform context * refactor: extract mail platform context * refactor: extract pdf platform context * refactor: extract operations platform context * refactor: move installation into operations platform * refactor: extract money domain context * refactor: extract taxation domain context * refactor: extract catalog domain context * refactor: extract metadata domain context * refactor: extract reporting domain context * refactor: extract purchases domain context * refactor: extract receivables domain context * refactor: extract accounts domain context * refactor: complete reporting statement boundary * refactor: extract contacts domain context * refactor: extract sales domain context * refactor: remove legacy application layers * fix: migrate legacy bouncer role identities
2026-09-01 21:00:58 +00:00 · 2026-08-05 17:40:03 +02:00
parent a34bf0909f
commit 5ef7804e60
878 changed files with 8997 additions and 5707 deletions
@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Platform\Modules\Http\Controllers\Company;
+
+use App\Platform\Http\Controller;
+use App\Platform\Modules\Models\Module;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Str;
+use InvoiceShelf\Modules\Registry as ModuleRegistry;
+
+/**
+ * Read-only company-context Active Modules index.
+ *
+ * Lists every module the super admin has activated on this instance
+ * (Module::enabled = true) and reports whether each one has registered a
+ * settings schema. The frontend uses this to render the company-context
+ * "Modules" landing page with a Settings button per active module.
+ *
+ * Activation is instance-global; per-company customization happens through
+ * settings (per CompanySetting under the module.{slug}.* prefix).
+ *
+ * Slug convention: nwidart stores the module's PascalCase class name in
+ * `modules.name` (e.g. "SalesTaxUs"), but URLs and registry keys use the
+ * kebab-case form ("sales-tax-us") for readability. We normalize via
+ * Str::kebab() so module authors can call Registry::registerMenu('sales-tax-us')
+ * naturally without thinking about the storage format.
+ */
+class CompanyModulesController extends Controller
+{
+    public function index(): JsonResponse
+    {
+        $this->authorize('manage module settings');
+
+        $modules = Module::query()
+            ->where('enabled', true)
+            ->get()
+            ->map(function (Module $module) {
+                $slug = Str::kebab($module->name);
+                $menu = ModuleRegistry::menuFor($slug);
+                $translatedMenuTitle = $this->translateMenuTitle($menu['title'] ?? null);
+                $displayName = $translatedMenuTitle ?? Str::headline($module->name);
+
+                return [
+                    'slug' => $slug,
+                    'name' => $module->name,
+                    'display_name' => $displayName,
+                    'version' => $module->version,
+                    'has_settings' => ModuleRegistry::settingsFor($slug) !== null,
+                    'menu' => $menu === null
+                        ? null
+                        : [
+                            ...$menu,
+                            'title' => $translatedMenuTitle ?? $menu['title'],
+                        ],
+                ];
+            })
+            ->values();
+
+        return response()->json(['data' => $modules]);
+    }
+
+    private function translateMenuTitle(?string $title): ?string
+    {
+        if ($title === null) {
+            return null;
+        }
+
+        $translatedTitle = __($title);
+
+        if (! is_string($translatedTitle) || $translatedTitle === $title) {
+            return null;
+        }
+
+        return $translatedTitle;
+    }
+}
@@ -0,0 +1,178 @@
+<?php
+
+namespace App\Platform\Modules\Http\Controllers\Company;
+
+use App\Platform\Http\Controller;
+use App\Platform\Modules\Contracts\ModuleSettingsStore;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use InvoiceShelf\Modules\Registry as ModuleRegistry;
+use InvoiceShelf\Modules\Settings\Schema;
+
+/**
+ * Schema-driven module settings backend.
+ *
+ * Each active module's ServiceProvider::boot() calls
+ * Registry::registerSettings($slug, $schema) once at app boot. This controller
+ * exposes that schema to the frontend, validates submitted values against the
+ * schema's per-field rules, and persists per-company values into CompanySetting
+ * under the key prefix `module.{slug}.{field_key}`.
+ *
+ * Activation is instance-global, but settings are per-company — two companies
+ * on the same instance can configure the same activated module differently.
+ */
+class ModuleSettingsController extends Controller
+{
+    public function __construct(private ModuleSettingsStore $settings) {}
+
+    public function show(Request $request, string $slug): JsonResponse
+    {
+        $this->authorize('manage module settings');
+
+        $schema = ModuleRegistry::settingsFor($slug);
+
+        if ($schema === null) {
+            abort(404, "Module '{$slug}' has not registered a settings schema.");
+        }
+
+        $values = collect($schema->fields())
+            ->mapWithKeys(fn (array $field) => [
+                $field['key'] => $this->settings->get(
+                    "module.{$slug}.{$field['key']}",
+                    $request->header('company')
+                ) ?? $field['default'],
+            ])
+            ->all();
+
+        return response()->json([
+            'schema' => $this->translateSchema($schema->toArray()),
+            'values' => $values,
+        ]);
+    }
+
+    public function update(Request $request, string $slug): JsonResponse
+    {
+        $this->authorize('manage module settings');
+
+        $schema = ModuleRegistry::settingsFor($slug);
+
+        if ($schema === null) {
+            abort(404, "Module '{$slug}' has not registered a settings schema.");
+        }
+
+        $rules = $this->buildRules($schema);
+        $allowedKeys = array_keys($rules);
+
+        $validated = $request->validate($rules);
+
+        $companyId = $request->header('company');
+
+        // Only persist keys the schema knows about — silently drop unknown keys
+        // rather than letting modules write arbitrary settings.
+        $settingsToWrite = [];
+        foreach ($allowedKeys as $key) {
+            if (array_key_exists($key, $validated)) {
+                $settingsToWrite["module.{$slug}.{$key}"] = $this->normalizeForStorage($validated[$key]);
+            }
+        }
+
+        if ($settingsToWrite !== []) {
+            $this->settings->put($settingsToWrite, $companyId);
+        }
+
+        return response()->json(['success' => true]);
+    }
+
+    /**
+     * Convert a Schema's field rule arrays into a flat Laravel validator rules array.
+     *
+     * Field rules are passed through verbatim — a field declared as
+     * `'rules' => ['required', 'string', 'max:255']` becomes
+     * `['my_field' => ['required', 'string', 'max:255']]`. The frontend's
+     * BaseSchemaForm.vue understands a subset of these for client-side validation;
+     * the backend validator is the source of truth.
+     *
+     * @return array<string, array<int, string>>
+     */
+    private function buildRules(Schema $schema): array
+    {
+        $rules = [];
+
+        foreach ($schema->fields() as $field) {
+            $rules[$field['key']] = $this->withTypeRule($field);
+        }
+
+        return $rules;
+    }
+
+    /**
+     * Prepend a sensible per-type validation rule so booleans must be booleans,
+     * numbers must be numeric, etc., even if the module didn't declare it.
+     *
+     * @param  array<string, mixed>  $field
+     * @return array<int, string>
+     */
+    private function withTypeRule(array $field): array
+    {
+        /** @var array<int, string> $declared */
+        $declared = $field['rules'] ?? [];
+
+        $typeRule = match ($field['type']) {
+            'switch' => 'boolean',
+            'number' => 'numeric',
+            'multiselect' => 'array',
+            default => 'nullable',
+        };
+
+        // Avoid duplicating the type rule if the module already declared it
+        if (in_array($typeRule, $declared, true)) {
+            return $declared;
+        }
+
+        return array_merge([$typeRule], $declared);
+    }
+
+    /**
+     * CompanySetting stores everything as strings. Cast booleans, ints, and
+     * arrays to a representation that round-trips through getSetting/setSetting
+     * without losing information. Reads happen in show() above and naturally
+     * return strings; the frontend handles re-coercion in BaseSchemaForm.vue.
+     */
+    /**
+     * Translate section titles and field labels in the schema so the
+     * frontend receives ready-to-display strings instead of Laravel
+     * translation keys it cannot resolve (e.g. `sales_tax_us::settings.greeting`).
+     *
+     * @param  array{sections: list<array<string, mixed>>}  $schema
+     * @return array{sections: list<array<string, mixed>>}
+     */
+    private function translateSchema(array $schema): array
+    {
+        foreach ($schema['sections'] as &$section) {
+            if (isset($section['title'])) {
+                $section['title'] = __($section['title']);
+            }
+
+            foreach ($section['fields'] as &$field) {
+                if (isset($field['label'])) {
+                    $field['label'] = __($field['label']);
+                }
+            }
+        }
+
+        return $schema;
+    }
+
+    private function normalizeForStorage(mixed $value): string
+    {
+        if (is_bool($value)) {
+            return $value ? '1' : '0';
+        }
+
+        if (is_array($value)) {
+            return json_encode($value, JSON_UNESCAPED_SLASHES) ?: '[]';
+        }
+
+        return (string) ($value ?? '');
+    }
+}