OneBot: Leantime 改造版源码（BOM/Univer 表格/AI 接管/品牌替换等）

app/Domain/Install/Services/Install.php

@@ -0,0 +1,125 @@
+<?php
+
+namespace Leantime\Domain\Install\Services;
+
+use Illuminate\Contracts\Container\BindingResolutionException;
+use Leantime\Core\Configuration\AppSettings;
+use Leantime\Domain\Install\Repositories\Install as InstallRepository;
+use Leantime\Domain\Setting\Services\Setting as SettingService;
+
+class Install
+{
+    /**
+     * @param  AppSettings  $appSettings  Application settings (version metadata).
+     * @param  InstallRepository  $installRepo  Install data-access layer (DB setup/update). The Install
+     *                                          domain runs before the full app/DB bootstrap is guaranteed,
+     *                                          so the service legitimately wraps the repository directly.
+     * @param  SettingService  $settingService  Setting service used to read the stored db-version.
+     */
+    public function __construct(
+        protected AppSettings $appSettings,
+        protected InstallRepository $installRepo,
+        protected SettingService $settingService
+    ) {}
+
+    /**
+     * currentVersion - gets the currently installed leantime version
+     *
+     * @api
+     */
+    public function currentVersion(): string
+    {
+        return $this->appSettings->appVersion;
+    }
+
+    /**
+     * isInstalled - determines whether Leantime has already been installed.
+     *
+     * @return bool True when the installation has already completed.
+     *
+     * @api
+     */
+    public function isInstalled(): bool
+    {
+        return $this->installRepo->checkIfInstalled();
+    }
+
+    /**
+     * validateInstallInput - validates the admin/company fields submitted during installation.
+     *
+     * Throws on the first missing field, preserving the original per-field error order
+     * (email, firstname, lastname, company). The exception message carries the language
+     * key the controller should surface as a notification.
+     *
+     * @param  array  $values  Submitted install values (email, firstname, lastname, company).
+     *
+     * @throws \InvalidArgumentException When a required field is missing.
+     *
+     * @api
+     */
+    public function validateInstallInput(array $values): void
+    {
+        if (empty($values['email'])) {
+            throw new \InvalidArgumentException('notification.enter_email');
+        }
+
+        if (empty($values['firstname'])) {
+            throw new \InvalidArgumentException('notification.enter_firstname');
+        }
+
+        if (empty($values['lastname'])) {
+            throw new \InvalidArgumentException('notification.enter_lastname');
+        }
+
+        if (empty($values['company'])) {
+            throw new \InvalidArgumentException('notification.enter_company');
+        }
+    }
+
+    /**
+     * runInstall - executes the database setup for a fresh installation.
+     *
+     * @param  array  $values  Validated install values (email, firstname, lastname, company).
+     * @return bool True on successful setup, false otherwise.
+     *
+     * @api
+     */
+    public function runInstall(array $values): bool
+    {
+        return $this->installRepo->setupDB($values);
+    }
+
+    /**
+     * needsUpdate - determines whether the stored db-version is behind the application's db-version.
+     *
+     * @return bool True when a database update is required.
+     *
+     * @api
+     */
+    public function needsUpdate(): bool
+    {
+        $dbVersion = $this->settingService->getSetting('db-version');
+
+        return $this->appSettings->dbVersion != $dbVersion;
+    }
+
+    /**
+     * runUpdate - executes pending database update scripts.
+     *
+     * Clears the cached db-version before running so the update starts from a clean state,
+     * then delegates to the repository. Returns true on success or an array of error messages
+     * on failure (preserving the repository's existing return contract).
+     *
+     * @return bool|array True on success, or an array of error messages on failure.
+     *
+     * @throws BindingResolutionException
+     *
+     * @api
+     */
+    public function runUpdate(): bool|array
+    {
+        session()->forget('db-version');
+
+        return $this->installRepo->updateDB();
+    }
+}