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-02 13:21:02 +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;
+    }
+}