merge: apply latest main to local development

.dockerignore

@@ -11,6 +11,7 @@ runtime
 JetBrainsMono-字体
 node_modules
 vendor
+bootstrap/cache/*
 .caiwu-build
 public/js
 public/css/app.css

app/Business/TableRegistry.php

@@ -154,6 +154,7 @@ class TableRegistry
             'trademark-management/renewal'                 => Trademark::class,
             'trademark-management/information'             => Trademark::class,
             'store-management/basic-information'           => StoreInformation::class,
+            'store-management/store-report'                => StoreInformation::class,
             'store-management/opening-process'             => StoreOpening::class,
             'store-management/changes'                     => StoreChange::class,
             'store-management/closing-process'             => StoreClosing::class,
@@ -241,7 +242,9 @@ class TableRegistry
         return in_array("{$section}/{$page}", [
             'company-management/basic-information',
             'store-management/basic-information',
+            'store-management/store-report',
             'trademark-management/information',
+            'financial-operations/installation-details',
         ], true);
     }
 

app/Business/UpstreamBusinessInformation.php

@@ -7,6 +7,9 @@ use InvalidArgumentException;
 use Modules\EcommerceFinance\Repositories\BusinessInformationMirrorRepository;
 use Modules\EcommerceFinance\Services\UpstreamQueryCacheFactory;
 use Modules\EcommerceFinance\Services\UpstreamReadOnlyQuery;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
+use Modules\EcommerceFinance\Repositories\StoreReportRepository;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
 
 class UpstreamBusinessInformation
 {
@@ -15,6 +18,9 @@ class UpstreamBusinessInformation
     public function __construct(
         private readonly UpstreamQueryCacheFactory $caches,
         private readonly BusinessInformationMirrorRepository $mirror,
+        private readonly InstallationDetailMirrorRepository $installationMirror,
+        // 兼容仍按旧构造方式调用的代码；容器解析时会正常注入仓储。
+        private readonly ?StoreReportRepository $storeReports = null,
     ) {}
 
     public function paginate(string $section, string $page, int $perPage = 50): LengthAwarePaginator
@@ -26,7 +32,9 @@ class UpstreamBusinessInformation
         $payload = match ($key) {
             'company-management/basic-information' => $this->companyPage($currentPage, $perPage),
             'store-management/basic-information' => $this->storePage($currentPage, $perPage),
+            'store-management/store-report' => $this->storeReportPage($currentPage, $perPage),
             'trademark-management/information' => $this->trademarkPage($currentPage, $perPage),
+            'financial-operations/installation-details' => $this->installationPage($currentPage, $perPage),
             default => ['data' => [], 'total' => 0],
         };
 
@@ -42,6 +50,15 @@ class UpstreamBusinessInformation
         );
     }
 
+    private function installationPage(int $page, int $perPage): array
+    {
+        $payload = $this->installationMirror->paginate($page, $perPage, InstallationDetailMirrorRepository::requestFilters());
+        if (! $payload['ready']) {
+            throw new ServiceUnavailableHttpException(null, '安装明细镜像尚未完成首次同步');
+        }
+        return ['data' => $payload['data'], 'total' => $payload['total']];
+    }
+
     /**
      * 将已登记的经营分析副本库查询还原成不经过页面缓存的固定只读查询。
      *
@@ -122,6 +139,32 @@ SQL);
         );
     }
 
+    private function storeReportPage(int $page, int $perPage): array
+    {
+        $stores = $this->allStores();
+        try {
+            $repository = $this->storeReports ?? app(StoreReportRepository::class);
+            $rows = $repository->rows($stores['data']);
+        } catch (\RuntimeException $exception) {
+            throw new ServiceUnavailableHttpException(null, $exception->getMessage(), $exception);
+        }
+        $offset = ($page - 1) * $perPage;
+
+        return ['data' => array_slice($rows, $offset, $perPage), 'total' => count($rows)];
+    }
+
+    /** @return array{data:array<int,array<string,mixed>>,total:int} */
+    private function allStores(): array
+    {
+        if (! $this->mirror->ready('store-information.read')) {
+            throw new ServiceUnavailableHttpException(null, '店铺资料共享镜像尚未完成首次同步。');
+        }
+
+        $rows = $this->mirror->allStores();
+        $rows = array_map(fn (array $row): array => $this->mapStore($row), $rows);
+        return ['data' => $rows, 'total' => count($rows)];
+    }
+
     private function storeSnapshot(UpstreamReadOnlyQuery $query, int $page, int $perPage): array
     {
         $offset = ($page - 1) * $perPage;
@@ -134,19 +177,20 @@ SELECT
     s.erpShopName AS erp_store_name,
     s.unifiedSocialCreditCode AS unified_social_credit_code,
     c.businessLicenseName AS company_name,
+    c.businessLicenseType AS company_type,
     s.trademarkNumber AS trademark_number,
     NULL AS trademark_name,
     s.platform AS platform,
     s.responsibleDepartment AS profit_center,
-    NULL AS store_manager,
-    NULL AS department_manager,
+    s.shopHead AS store_manager,
+    s.customerDeptManager AS department_manager,
     s.shopState AS store_status,
     s.shopBankAccount AS withdrawal_account,
     s.shopType AS store_type,
     s.channelType AS channel_mode
 FROM rpt.fys_shopInfo AS s
 OUTER APPLY (
-    SELECT TOP 1 company.businessLicenseName
+    SELECT TOP 1 company.businessLicenseName, company.businessLicenseType
     FROM rpt.fys_companyInfo AS company
     WHERE company.unifiedSocialCreditCode = NULLIF(s.unifiedSocialCreditCode, '')
     ORDER BY company.Id DESC
@@ -209,6 +253,11 @@ SQL);
             return $this->normalize($scope, $this->mirror->paginate($scope, $page, $perPage));
         }
 
+        if ((app(\App\Utilities\SystemDatabaseConfiguration::class)->current()['mode'] ?? '') === 'bootstrap'
+            && ! config('upstreams.local_configuration.enabled', false)) {
+            throw new ServiceUnavailableHttpException(null, '当前仍使用本机临时引导库。请在“系统设置 → 数据库管理 → 系统数据库”连接团队共享数据库，然后重新登录；无需另配上游 SQL Server。');
+        }
+
         $cache = $this->caches->forSource(self::SOURCE);
 
         return $cache->remember($scope, compact('page', 'perPage'), function () use ($resolver) {
@@ -266,7 +315,6 @@ SQL);
         $row = $this->toUtf8($row);
         $row['registration_date'] = $this->date($row['registration_date'] ?? null);
         $row['expiry_date'] = $this->date($row['expiry_date'] ?? null);
-        $row['trademark_type'] = $this->numericClassifications($row['trademark_type'] ?? null);
         $row['trademark_status'] = match ((string) ($row['trademark_status'] ?? '')) {
             '0' => '未启用',
             '1' => '有效',
@@ -276,22 +324,6 @@ SQL);
         return $row;
     }
 
-    /**
-     * 国际分类在上游偶尔带有“第”“类”等中文标记，Web 表只展示分类数字。
-     * 多个分类保留为逗号分隔的数字，空值继续保持为空。
-     */
-    private function numericClassifications(mixed $value): ?string
-    {
-        if ($value === null || trim((string) $value) === '') {
-            return null;
-        }
-
-        preg_match_all('/\d+/', (string) $value, $matches);
-        $values = array_values(array_unique($matches[0] ?? []));
-
-        return $values === [] ? null : implode(',', $values);
-    }
-
     private function toUtf8(array $row): array
     {
         foreach ($row as &$value) {

app/Console/Commands/ApplicationReady.php

@@ -2,6 +2,7 @@
 
 namespace App\Console\Commands;
 
+use App\Utilities\SystemDatabaseConfiguration;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\DB;
 use Throwable;
@@ -18,7 +19,7 @@ class ApplicationReady extends Command
 
     protected $description = '检查应用安装、运行目录和数据库是否已经可用';
 
-    public function handle(): int
+    public function handle(SystemDatabaseConfiguration $configuration): int
     {
         if (! config('app.installed')) {
             return $this->failed('APP_INSTALLED 未被 Laravel 加载。', self::EXIT_NOT_INSTALLED);
@@ -42,7 +43,11 @@ class ApplicationReady extends Command
             return $this->failed('Laravel 数据库连接失败。', self::EXIT_DATABASE_CONNECTION_FAILED);
         }
 
-        $this->components->info('应用已就绪。');
+        if ($configuration->current()['mode'] === 'bootstrap') {
+            $this->components->info('本地网页和临时引导库已就绪；团队共享数据尚未接入。');
+        } else {
+            $this->components->info('应用运行正常，当前数据库可查询。团队数据接入状态请运行 system-database:verify 检查。');
+        }
 
         return self::SUCCESS;
     }

app/Console/Commands/BusinessMirrorStatus.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Modules\EcommerceFinance\Repositories\GenericBusinessMirrorRepository;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
+use Throwable;
+
+class BusinessMirrorStatus extends Command
+{
+    protected $signature = 'business-mirror:status {dataset?} {--json}';
+    protected $description = '只读查看已登记镜像的启用、首次完成和最近同步状态';
+
+    public function handle(BusinessMirrorDatasetRegistry $datasets, GenericBusinessMirrorRepository $mirror): int
+    {
+        try {
+            $requested = $this->argument('dataset');
+            $selected = $requested ? [$requested => $datasets->get($requested)] : $datasets->all();
+            $rows = [];
+            foreach ($selected as $key => $dataset) {
+                $state = $mirror->state($dataset);
+                $rows[] = [
+                    'dataset' => $key, 'enabled' => $datasets->scheduled($key),
+                    'initial_completed' => ($state['initial_completed_at'] ?? null) !== null,
+                    'status' => $state['status'] ?? ($datasets->automaticInitialSyncAllowed($key) ? 'queued' : 'not_initialized'),
+                    'last_attempted_at' => $state['last_attempted_at'] ?? null,
+                    'last_succeeded_at' => $state['last_succeeded_at'] ?? null,
+                    'error_code' => $state['last_error_code'] ?? null,
+                ];
+            }
+            if ($this->option('json')) $this->line(json_encode($rows, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR));
+            else $this->table(['数据集', '启用', '首次完成', '状态', '最近尝试', '最近完成', '错误类型'], array_map(fn ($r) => array_values($r), $rows));
+            return self::SUCCESS;
+        } catch (Throwable) {
+            $this->error('无法读取镜像状态，请确认共享系统数据库和业务镜像库已接入。');
+            return self::FAILURE;
+        }
+    }
+}

app/Console/Commands/ConnectTeamSystemDatabase.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Utilities\SystemDatabaseConfiguration;
+use App\Utilities\TeamSystemDatabaseProfile;
+use Illuminate\Console\Command;
+use Throwable;
+
+class ConnectTeamSystemDatabase extends Command
+{
+    protected $signature = 'system-database:connect-team {--password-stdin : 从标准输入读取首次接入密码，不使用命令行明文参数}';
+
+    protected $description = '本地开发环境使用已有密码跟随最新团队连接资料，不迁移或写入共享数据库';
+
+    public function handle(SystemDatabaseConfiguration $configuration, TeamSystemDatabaseProfile $profile): int
+    {
+        if (! app()->environment(['local', 'development', 'testing'])) {
+            $this->error('此命令仅用于本地开发环境，不修改生产服务器连接。');
+            return self::FAILURE;
+        }
+
+        $current = $configuration->current();
+        $password = $this->option('password-stdin')
+            ? rtrim((string) fgets(STDIN, 1002), "\r\n")
+            : (string) ($current['password'] ?? '');
+
+        try {
+            $settings = $profile->settings($password);
+        } catch (Throwable) {
+            $this->warn('本机尚未保存有效的团队密码。请在系统数据库页面输入一次密码；已有配置未修改，无需另配上游账号。');
+            return VerifySystemDatabase::EXIT_SHARED_NOT_CONFIGURED;
+        }
+
+        try {
+            // 只探测最新端点，不先连接可能已停用的旧服务器。
+            $result = $configuration->probe($settings);
+            $settings['prefix'] = $result['prefix'];
+            if ($this->matches($current, $settings)) {
+                $this->info('本机已连接最新团队系统数据库，业务镜像共用此连接。');
+                return self::SUCCESS;
+            }
+        } catch (Throwable) {
+            $this->error('最新团队数据库接入未通过验证，原配置已保留。请检查网络、TLS和共享库访问权限；不要改填上游账号。');
+            return self::FAILURE;
+        }
+
+        try {
+            $configuration->persist($settings);
+        } catch (Throwable) {
+            $this->error('本机配置保存或复核失败。请核对私有配置备份和系统连接状态；不要仅修改运行模式或绕过验证。');
+            return self::FAILURE;
+        }
+        $this->info('已备份并更新本机系统库、业务镜像库连接。请重新登录；未迁移或同步业务数据。');
+        return self::SUCCESS;
+    }
+
+    private function matches(array $current, array $settings): bool
+    {
+        foreach (['host', 'port', 'database', 'username', 'password', 'prefix', 'tls_required', 'tls_verify_server_cert', 'tls_ca'] as $key) {
+            if (($current[$key] ?? null) != ($settings[$key] ?? null)) return false;
+        }
+        $mirror = (array) config('database.connections.business_mirror');
+        return ($current['mode'] ?? '') === 'shared'
+            && config('upstreams.stored_configuration.enabled', false)
+            && ! config('upstreams.local_configuration.enabled', false)
+            && data_get($mirror, 'read.host.0') === $settings['host']
+            && data_get($mirror, 'write.host.0') === $settings['host']
+            && (int) ($mirror['port'] ?? 0) === (int) $settings['port']
+            && ($mirror['database'] ?? '') === $settings['mirror_database']
+            && ($mirror['username'] ?? '') === $settings['username']
+            && ($mirror['password'] ?? '') === $settings['password']
+            && empty($mirror['unix_socket']);
+    }
+}

app/Console/Commands/ImportStoreReportData.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Modules\EcommerceFinance\Services\StoreReportDataImporter;
+use Throwable;
+
+class ImportStoreReportData extends Command
+{
+    protected $signature = 'store-report:import-data
+        {--bills= : 五个平台原始账单 XLSX 文件或目录}
+        {--lifecycles= : 店铺生命周期 XLSX 文件}
+        {--batch=500 : 单批写入共享业务镜像的行数}';
+
+    protected $description = '将平台原始账单和店铺生命周期原子导入团队共享业务镜像';
+
+    public function handle(StoreReportDataImporter $importer): int
+    {
+        $bills = trim((string) $this->option('bills'));
+        $lifecycles = trim((string) $this->option('lifecycles'));
+        if ($bills === '' && $lifecycles === '') {
+            $this->error('请至少指定 --bills 或 --lifecycles。');
+            return self::INVALID;
+        }
+
+        try {
+            if ($bills !== '') {
+                $result = $importer->importBills($bills, (int) $this->option('batch'));
+                $this->info('平台账单共享镜像导入完成：' . number_format($result['row_count']) . ' 行。');
+            }
+            if ($lifecycles !== '') {
+                $result = $importer->importLifecycles($lifecycles, (int) $this->option('batch'));
+                $this->info('店铺生命周期共享镜像导入完成：' . number_format($result['row_count']) . ' 行。');
+            }
+        } catch (Throwable $exception) {
+            report($exception);
+            $this->error('店铺维度报表数据导入失败，已保留上一版共享数据。');
+            return self::FAILURE;
+        }
+
+        return self::SUCCESS;
+    }
+}

app/Console/Commands/InspectUpstream.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\DB;
+use Modules\EcommerceFinance\Services\UpstreamReadOnlyQueryFactory;
+use Modules\EcommerceFinance\Services\UpstreamSourceRegistry;
+use Modules\EcommerceFinance\Services\UpstreamSqlDialect;
+use Throwable;
+
+class InspectUpstream extends Command
+{
+    protected $signature = 'upstream:inspect {source?} {schema?} {object?} {--columns= : 明确选择样本字段；不填时只显示字段目录} {--limit=5 : 样本上限，最多20行}';
+    protected $description = '通过统一驱动查看目录或有限只读样本，不生成快照或启动同步';
+
+    public function handle(UpstreamSourceRegistry $sources, UpstreamReadOnlyQueryFactory $queries): int
+    {
+        $source = (string) $this->argument('source');
+        $schema = (string) $this->argument('schema');
+        $object = (string) $this->argument('object');
+        try {
+            if ($source === '') {
+                $rows = [];
+                foreach ($sources->all() as $key => $definition) $rows[] = [$key, $definition['label'], $sources->driver($key), $sources->enabled($key) ? '启用' : '停用'];
+                $this->table(['内部标识', '数据库名称', '类型', '状态'], $rows);
+                return self::SUCCESS;
+            }
+            $sources->definition($source);
+            if ($schema === '' || $object === '') {
+                $objects = DB::table('upstream_schema_columns')->where('source_key', $source)
+                    ->when($schema !== '', fn ($q) => $q->where('schema_name', $schema))
+                    ->select('schema_name', 'object_name')->distinct()->orderBy('schema_name')->orderBy('object_name')->get();
+                $this->table(['Schema', '表 / 视图'], $objects->map(fn ($row) => [$row->schema_name, $row->object_name])->all());
+                return self::SUCCESS;
+            }
+            $catalog = DB::table('upstream_schema_columns')->where('source_key', $source)
+                ->where('schema_name', $schema)->where('object_name', $object)->orderBy('ordinal_position')
+                ->get(['column_name', 'data_type', 'is_nullable']);
+            if ($catalog->isEmpty()) {
+                $this->error('尚无该对象的字段目录，请先核实来源并同步数据字典。');
+                return self::FAILURE;
+            }
+            if (! $this->option('columns')) {
+                $this->table(['字段', '类型', '允许空值'], $catalog->map(fn ($c) => [$c->column_name, $c->data_type, $c->is_nullable ? '是' : '否'])->all());
+                return self::SUCCESS;
+            }
+            $columns = array_values(array_unique(array_filter(array_map('trim', explode(',', (string) $this->option('columns'))))));
+            if ($columns === [] || array_diff($columns, $catalog->pluck('column_name')->all())) {
+                $this->error('样本字段必须来自该对象的数据字典。');
+                return self::FAILURE;
+            }
+            $dialect = new UpstreamSqlDialect($sources->driver($source));
+            $sql = $dialect->select(implode(', ', array_map($dialect->quote(...), $columns)),
+                'FROM ' . $dialect->quote($schema) . '.' . $dialect->quote($object),
+                min(max((int) $this->option('limit'), 1), 20));
+            $rows = $queries->forSource($source)->select($sql);
+            $this->table($columns, array_map(fn ($row) => array_values($row), $rows));
+            $this->info('样本仅用于字段核实，不能作为完整业务数据。');
+            return self::SUCCESS;
+        } catch (Throwable) {
+            $this->error('只读检查未完成，请检查共享连接、来源启用状态和访问权限。');
+            return self::FAILURE;
+        }
+    }
+}

app/Console/Commands/RegisterBusinessMirror.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
+use Modules\EcommerceFinance\Services\UpstreamSourceRegistry;
+use Throwable;
+
+class RegisterBusinessMirror extends Command
+{
+    protected $signature = 'business-mirror:register {source} {schema} {object}
+        {--keys= : 逗号分隔的稳定唯一键}
+        {--columns= : 逗号分隔的明确同步字段，必须包含稳定键及增量字段}
+        {--watermark= : 可靠更新时间字段；留空为仅按主键追加}
+        {--enable-sync : 启用并批准可断点首次同步及后续增量}
+        {--disable-sync : 停用此数据集的自动同步，保留镜像数据}';
+
+    protected $description = '登记声明式镜像数据集；生产启用前需获得同步范围授权';
+
+    public function handle(BusinessMirrorDatasetRegistry $datasets, UpstreamSourceRegistry $sources): int
+    {
+        if (! Schema::hasTable('business_mirror_datasets')) {
+            $this->error('尚未执行镜像数据集登记表迁移。');
+            return self::FAILURE;
+        }
+        $source = (string) $this->argument('source');
+        $schema = (string) $this->argument('schema');
+        $object = (string) $this->argument('object');
+        $key = $source . '.' . $schema . '.' . $object;
+        try {
+            $sources->definition($source);
+            if (strlen($key) > 191 || isset(config('upstream_mirrors.datasets', [])[$key])) {
+                throw new \RuntimeException('数据集键过长或由现有代码维护，不能覆盖。');
+            }
+            if ($this->option('disable-sync')) {
+                if ($this->option('enable-sync')) throw new \RuntimeException('不能同时启用和停用。');
+                if (DB::table('business_mirror_datasets')->where('dataset_key', $key)->update(['sync_enabled' => false, 'updated_at' => now()]) !== 1) {
+                    throw new \RuntimeException('未找到该登记数据集。');
+                }
+                $this->info('已停止自动同步，现有镜像保留。');
+                return self::SUCCESS;
+            }
+            $keys = $this->csv((string) $this->option('keys'));
+            $columns = $this->csv((string) $this->option('columns'));
+            $watermark = trim((string) $this->option('watermark'));
+            if ($keys === [] || $columns === [] || array_diff([...$keys, ...($watermark === '' ? [] : [$watermark])], $columns)) {
+                throw new \RuntimeException('请明确字段和稳定键；同步字段必须包含稳定键及增量字段。');
+            }
+            $catalog = DB::table('upstream_schema_columns')->where('source_key', $source)
+                ->where('schema_name', $schema)->where('object_name', $object)->pluck('column_name')->all();
+            if (array_diff($columns, $catalog)) {
+                throw new \RuntimeException('字段不在数据字典中，请先同步该来源字典并核实字段。');
+            }
+            $definition = ['source_key' => $source, 'schema' => $schema, 'object' => $object,
+                'target' => 'mirror_' . substr(hash('sha256', $key), 0, 24),
+                'keys' => $keys, 'columns' => $columns, 'watermark' => $watermark];
+            $datasets->validate($key, $definition);
+            $enable = (bool) $this->option('enable-sync');
+            DB::transaction(function () use ($key, $source, $definition, $enable): void {
+                $existing = DB::table('business_mirror_datasets')->where('dataset_key', $key)->lockForUpdate()->first();
+                if ($existing !== null && json_decode($existing->definition, true) != $definition) {
+                    throw new \RuntimeException('已有数据集定义不同，不能覆盖稳定键、字段或同步游标。请先完成变更评估。');
+                }
+                if ($existing !== null) {
+                    if ($enable) DB::table('business_mirror_datasets')->where('dataset_key', $key)->update([
+                        'sync_enabled' => true, 'initial_sync_approved' => true, 'updated_at' => now(),
+                    ]);
+                    return;
+                }
+                DB::table('business_mirror_datasets')->insert([
+                    'dataset_key' => $key, 'source_key' => $source, 'definition' => json_encode($definition, JSON_THROW_ON_ERROR),
+                    'sync_enabled' => $enable, 'initial_sync_approved' => $enable, 'created_at' => now(), 'updated_at' => now(),
+                ]);
+            });
+            $this->info($key . ($enable ? '：已启用，生产调度将自动执行首次同步并持续增量。' : '：已登记，自动同步未启用。'));
+            return self::SUCCESS;
+        } catch (\Illuminate\Database\QueryException) {
+            $this->error('登记失败，请检查系统数据库状态；原数据集保留。');
+        } catch (\RuntimeException|\InvalidArgumentException $e) {
+            $this->error($e->getMessage());
+        } catch (Throwable) {
+            $this->error('登记失败，未启用新同步。请检查系统数据库状态。');
+        }
+        return self::FAILURE;
+    }
+
+    private function csv(string $value): array
+    {
+        return array_values(array_unique(array_filter(array_map('trim', explode(',', $value)))));
+    }
+}

app/Console/Commands/SyncBusinessMirrors.php

@@ -35,23 +35,27 @@ class SyncBusinessMirrors extends Command
         $requested = $this->argument('dataset');
         $keys = $requested === null
             ? $this->scheduledKeys($datasets, $mirror)
-            : [(string) $requested];
+            : [['key' => (string) $requested, 'full' => (bool) $this->option('full'), 'catchup' => false]];
         $maxDatasets = max((int) ($this->option('max-datasets')
-            ?? config('upstream_mirrors.table_sync.max_datasets_per_run', 1)), 1);
+            ?? config('upstream_pipeline.sync.max_datasets', 8)), 1);
         $processed = 0;
         $failed = false;
+        $deadline = microtime(true) + max((int) config('upstream_pipeline.sync.cycle_seconds', 30), 1);
 
-        foreach ($keys as $key) {
-            if ($processed >= $maxDatasets) {
+        foreach ($keys as $task) {
+            if ($processed >= $maxDatasets || ($processed > 0 && microtime(true) >= $deadline)) {
                 break;
             }
+            $key = $task['key'];
 
             try {
                 $result = $synchronizer->sync(
                     $key,
-                    (bool) $this->option('full'),
+                    (bool) $task['full'],
                     $this->option('batch') === null ? null : (int) $this->option('batch'),
-                    $this->option('max-batches') === null ? null : (int) $this->option('max-batches'),
+                    $this->option('max-batches') === null
+                        ? ($task['catchup'] ? max((int) config('upstream_pipeline.sync.catchup_batches', 6), 1) : null)
+                        : (int) $this->option('max-batches'),
                 );
             } catch (Throwable $exception) {
                 $failed = true;
@@ -105,7 +109,7 @@ class SyncBusinessMirrors extends Command
         return $failed ? self::FAILURE : self::SUCCESS;
     }
 
-    /** @return list<string> */
+    /** @return list<array{key:string,full:bool,catchup:bool,last_attempted_at:string}> */
     private function scheduledKeys(
         BusinessMirrorDatasetRegistry $datasets,
         GenericBusinessMirrorRepository $mirror,
@@ -117,17 +121,20 @@ class SyncBusinessMirrors extends Command
         ), true);
 
         foreach ($datasets->all() as $key => $dataset) {
-            if (isset($dedicated[$key])) {
+            if (isset($dedicated[$key]) || ! $datasets->scheduled($key)) {
                 continue;
             }
 
             $state = $mirror->state($dataset);
-            if (! is_array($state) || ($state['initial_completed_at'] ?? null) === null) {
-                continue;
-            }
+            $initial = ! is_array($state) || ($state['initial_completed_at'] ?? null) === null;
+            if ($initial && ! $datasets->automaticInitialSyncAllowed($key)) continue;
+            if (($state['status'] ?? '') === 'failed' && ! empty($state['last_attempted_at'])
+                && now()->diffInSeconds(\Illuminate\Support\Carbon::parse($state['last_attempted_at'])) < 300) continue;
 
             $scheduled[] = [
                 'key' => $key,
+                'full' => $initial || (bool) $this->option('full'),
+                'catchup' => $initial || ($state['status'] ?? '') === 'running',
                 'last_attempted_at' => (string) ($state['last_attempted_at'] ?? ''),
             ];
         }
@@ -136,6 +143,15 @@ class SyncBusinessMirrors extends Command
             [$left['last_attempted_at'], $left['key']] <=> [$right['last_attempted_at'], $right['key']]
         );
 
-        return array_column($scheduled, 'key');
+        // Alternate unfinished windows and routine refreshes: catch-up progresses
+        // every cycle without starving small tables or monopolizing a source.
+        $catchup = array_values(array_filter($scheduled, fn ($task) => $task['catchup']));
+        $routine = array_values(array_filter($scheduled, fn ($task) => ! $task['catchup']));
+        $ordered = [];
+        while ($catchup !== [] || $routine !== []) {
+            if ($routine !== []) $ordered[] = array_shift($routine);
+            if ($catchup !== []) $ordered[] = array_shift($catchup);
+        }
+        return $ordered;
     }
 }

app/Console/Commands/UpstreamSyncSchemaCatalog.php

@@ -32,7 +32,7 @@ class UpstreamSyncSchemaCatalog extends Command
         $requested = $this->argument('source');
         $sourceKeys = $requested
             ? [(string) $requested]
-            : array_keys((array) config('upstreams.sources', []));
+            : array_keys($sources->all());
         $cache = $cacheManager->store((string) config('upstreams.snapshots.cache_store', 'upstream_shared'));
         $failed = false;
 

app/Console/Commands/VerifySystemDatabase.php

@@ -15,6 +15,8 @@ class VerifySystemDatabase extends Command
 
     public const EXIT_SYSTEM_TABLE_VALIDATION_FAILED = 12;
 
+    public const EXIT_SHARED_NOT_CONFIGURED = 13;
+
     protected $signature = 'system-database:verify';
 
     protected $description = '在新的 Laravel 进程中验证当前共享系统数据库';
@@ -30,12 +32,16 @@ class VerifySystemDatabase extends Command
             );
         }
 
-        if (
-            $settings['mode'] !== 'shared'
-            || ! config('upstreams.stored_configuration.enabled', false)
-        ) {
+        if ($settings['mode'] === 'bootstrap') {
+            $this->components->warn('当前仍使用本机临时引导库，尚未接入团队共享系统数据库；本次没有测试远程连接。');
+            $this->line('下一步：在“系统设置 → 数据库管理 → 系统数据库”中输入一次负责人提供的系统数据库密码。');
+
+            return self::EXIT_SHARED_NOT_CONFIGURED;
+        }
+
+        if ($settings['mode'] !== 'shared' || ! config('upstreams.stored_configuration.enabled', false)) {
             return $this->failed(
-                '新配置未被 Laravel 加载。',
+                '共享配置未完整启用，请通过系统数据库连接页面重新保存；不要仅手工修改运行模式。',
                 self::EXIT_CONFIG_NOT_LOADED
             );
         }

app/Http/Controllers/Business/Pages.php

@@ -21,6 +21,7 @@ use Modules\EcommerceFinance\Repositories\AlibabaBillRepository;
 use Modules\EcommerceFinance\Repositories\CourierInformationMirrorRepository;
 use Modules\EcommerceFinance\Repositories\EdgeBandingRepository;
 use Modules\EcommerceFinance\Repositories\InventoryRepository;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
 use Modules\EcommerceFinance\Repositories\JdWalletBillRepository;
 use Modules\EcommerceFinance\Repositories\NonJingxiRefundMirrorRepository;
 use Modules\EcommerceFinance\Repositories\PinduoduoSpreadBillRepository;
@@ -58,6 +59,7 @@ class Pages extends Controller
     public function __construct(
         private readonly EdgeBandingRepository $edgeBanding,
         private readonly InventoryRepository $inventory,
+        private readonly InstallationDetailMirrorRepository $installationDetails,
         private readonly NonJingxiRefundMirrorRepository $nonJingxiRefunds,
         private readonly ProductCatalogMirrorRepository $productCatalog,
         private readonly ProductPriceMirrorRepository $productPrices,
@@ -161,6 +163,18 @@ class Pages extends Controller
         ));
     }
 
+    public function installationDetails(string $guid)
+    {
+        $section = collect(SidebarPermissions::navigationFor(user()))->firstWhere('slug', 'financial-operations');
+        abort_unless($section && collect($section['pages'] ?? [])->contains('slug', 'installation-details'), 403, '当前账号没有该页面权限。');
+        $payload = $this->installationDetails->details($guid);
+        if (! $payload['ready']) {
+            return response()->json(['message' => '安装明细镜像尚未完成首次同步'], 503);
+        }
+
+        return response()->json(['data' => $payload['data'], 'has_more' => $payload['has_more'] ?? false]);
+    }
+
     protected function viewData(
         array $section,
         ?array $page = null,

app/Http/Controllers/SystemSettings/Databases.php

@@ -15,6 +15,7 @@ use Illuminate\Routing\Controller;
 use Illuminate\Validation\Rule;
 use Illuminate\Validation\ValidationException;
 use Modules\EcommerceFinance\Services\UpstreamOdbcConnection;
+use Modules\EcommerceFinance\Services\UpstreamDatabaseProbe;
 use Modules\EcommerceFinance\Services\UpstreamSourceRegistry;
 use Modules\EcommerceFinance\Services\UpstreamStoredConfiguration;
 use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
@@ -210,7 +211,7 @@ class Databases extends Controller
 
         $data = $this->validateConnection($request);
         $connection = DatabaseConnection::create($this->attributes($data, null, $request));
-        $this->resetSource($connection->source_key, $storedConfiguration);
+        $this->resetSource($connection->sourceIdentifier(), $storedConfiguration);
 
         flash('数据库配置已新增。')->success();
 
@@ -233,12 +234,12 @@ class Databases extends Controller
     {
         abort_unless($storedConfiguration->editable() && $storedConfiguration->enabled(), 403);
         $connection = $this->connection($connection);
-        $oldSource = $connection->source_key;
+        $oldSource = $connection->sourceIdentifier();
         $data = $this->validateConnection($request, $connection);
         $connection->update($this->attributes($data, $connection, $request));
 
         $this->resetSource($oldSource, $storedConfiguration);
-        $this->resetSource($connection->source_key, $storedConfiguration);
+        $this->resetSource($connection->sourceIdentifier(), $storedConfiguration);
 
         flash('数据库配置已修改。')->success();
 
@@ -249,7 +250,7 @@ class Databases extends Controller
     {
         abort_unless($storedConfiguration->editable() && $storedConfiguration->enabled(), 403);
         $connection = $this->connection($connection);
-        $source = $connection->source_key;
+        $source = $connection->sourceIdentifier();
         $connection->delete();
         $this->resetSource($source, $storedConfiguration);
 
@@ -258,24 +259,27 @@ class Databases extends Controller
         return redirect()->route('system-settings.databases.index');
     }
 
-    public function test(int $connection, UpstreamStoredConfiguration $storedConfiguration)
+    public function test(int $connection, UpstreamStoredConfiguration $storedConfiguration, UpstreamDatabaseProbe $probe)
     {
         abort_unless($storedConfiguration->editable() && $storedConfiguration->enabled(), 403);
         $connection = $this->connection($connection);
 
         try {
-            UpstreamOdbcConnection::probeConfiguration($this->odbcConfiguration($connection), $connection->name);
+            $probe->probe($connection->driver, $this->odbcConfiguration($connection), $connection->name);
         } catch (DecryptException $exception) {
             throw ValidationException::withMessages([
                 'connection' => $exception->getMessage(),
             ]);
-        } catch (ServiceUnavailableHttpException) {
+        } catch (ServiceUnavailableHttpException $exception) {
             throw ValidationException::withMessages([
-                'connection' => '连接失败。请检查地址、端口、数据库、账号、网络白名单和本机 ODBC 驱动。',
+                'connection' => $connection->driver !== 'sqlsrv'
+                    ? $exception->getMessage()
+                    : 'SQL Server 连接失败。请检查地址、端口、数据库、账号、网络白名单和 ODBC 驱动。',
             ]);
         }
 
-        flash($connection->name . '连接成功，仅执行了 SELECT 1 只读测试。')->success();
+        $protocol = match ($connection->driver) { 'pgsql' => ' PostgreSQL SSL ', 'mysql' => ' MySQL/MariaDB TLS ', default => '' };
+        flash($connection->name . $protocol . '连接成功，仅执行了 SELECT 1 只读测试。')->success();
 
         return redirect()->route('system-settings.databases.index');
     }
@@ -283,8 +287,17 @@ class Databases extends Controller
     private function validateConnection(Request $request, ?DatabaseConnection $connection = null): array
     {
         $sourceKeys = array_keys($this->sourceLabels());
+        $request->merge(['driver' => $request->input('driver', $connection?->driver ?? 'sqlsrv')]);
+        $postgres = in_array($request->input('driver'), ['pgsql', 'mysql'], true);
+
+        if ($postgres && $request->input('source_key', $connection?->source_key)) {
+            throw ValidationException::withMessages([
+                'source_key' => '现有业务来源使用 SQL Server，不能更换其数据库类型。请单独添加新数据库。',
+            ]);
+        }
 
         return $request->validate([
+            'driver' => ['required', Rule::in(['sqlsrv', 'pgsql', 'mysql'])],
             'name' => [
                 'required',
                 'string',
@@ -300,15 +313,20 @@ class Databases extends Controller
                     ->where(fn ($query) => $query->where('company_id', UpstreamStoredConfiguration::SYSTEM_COMPANY_ID))
                     ->ignore($connection?->id),
             ],
-            'host' => ['required', 'string', 'max:191', 'not_regex:/[;\x00-\x1F]/'],
+            'host' => ['required', 'string', 'max:191', function ($attribute, $value, $fail) {
+                if (! filter_var($value, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)
+                    && ! preg_match('/^[a-z0-9_.-]+$/i', $value)) {
+                    $fail('主机地址只填写域名或 IP，端口请单独填写。');
+                }
+            }],
             'port' => ['required', 'integer', 'between:1,65535'],
             'database_name' => ['required', 'string', 'max:191', 'not_regex:/[;\x00-\x1F]/'],
             'username' => ['required', 'string', 'max:191', 'not_regex:/[;\x00-\x1F]/'],
             'password' => [$connection ? 'nullable' : 'required', 'string', 'max:1000'],
-            'odbc_driver' => ['required', 'string', 'max:128', 'not_regex:/[;{}\x00-\x1F]/'],
-            'tds_version' => ['required', 'regex:/^\d+(?:\.\d+)?$/', 'max:16'],
+            'odbc_driver' => [$postgres ? 'nullable' : 'required', 'string', 'max:128', 'not_regex:/[;{}\x00-\x1F]/'],
+            'tds_version' => [$postgres ? 'nullable' : 'required', 'regex:/^\d+(?:\.\d+)?$/', 'max:16'],
             'connect_timeout' => ['required', 'integer', 'between:1,30'],
-            'query_timeout' => ['required', 'integer', 'between:1,120'],
+            'query_timeout' => ['required', 'integer', $postgres ? 'between:1,15' : 'between:1,120'],
             'allowed_scopes' => ['nullable', 'string', 'max:4000'],
             'enabled' => ['nullable', 'boolean'],
         ]);
@@ -318,18 +336,19 @@ class Databases extends Controller
     {
         $attributes = [
             'company_id' => UpstreamStoredConfiguration::SYSTEM_COMPANY_ID,
-            'source_key' => $data['source_key'] ?? null,
+            'source_key' => array_key_exists('source_key', $data) ? $data['source_key'] : $connection?->source_key,
             'name' => trim($data['name']),
-            'driver' => 'sqlsrv',
+            'driver' => $data['driver'],
             'host' => trim($data['host']),
             'port' => (int) $data['port'],
             'database_name' => trim($data['database_name']),
             'username' => trim($data['username']),
-            'odbc_driver' => trim($data['odbc_driver']),
-            'tds_version' => trim($data['tds_version']),
+            'odbc_driver' => $data['driver'] !== 'sqlsrv' ? null : trim($data['odbc_driver']),
+            'tds_version' => $data['driver'] !== 'sqlsrv' ? null : trim($data['tds_version']),
             'connect_timeout' => (int) $data['connect_timeout'],
             'query_timeout' => (int) $data['query_timeout'],
-            'allowed_scopes' => $this->parseScopes((string) ($data['allowed_scopes'] ?? '')),
+            'allowed_scopes' => array_key_exists('allowed_scopes', $data)
+                ? $this->parseScopes((string) $data['allowed_scopes']) : ($connection?->allowed_scopes ?? []),
             'charset' => 'UTF-8',
             'enabled' => $request->boolean('enabled'),
         ];
@@ -365,7 +384,7 @@ class Databases extends Controller
 
     private function sourceLabels(): array
     {
-        return collect((array) config('upstreams.sources', []))
+        return collect(app(UpstreamSourceRegistry::class)->all())
             ->mapWithKeys(fn (array $source, string $key) => [$key => $source['label'] ?? $key])
             ->all();
     }
@@ -374,8 +393,9 @@ class Databases extends Controller
     {
         return [
             'name' => '',
+            'driver' => 'sqlsrv',
             'source_key' => '',
-            'enabled' => false,
+            'enabled' => true,
             'host' => '',
             'port' => 1433,
             'database_name' => '',
@@ -392,6 +412,7 @@ class Databases extends Controller
     {
         return [
             'name' => $connection->name,
+            'driver' => $connection->driver,
             'source_key' => $connection->source_key,
             'enabled' => $connection->enabled,
             'host' => $connection->host,
@@ -441,6 +462,6 @@ class Databases extends Controller
         }
 
         $storedConfiguration->forget($source);
-        UpstreamOdbcConnection::reset($source);
+        \Modules\EcommerceFinance\Services\UpstreamConnection::reset($source);
     }
 }

app/Listeners/Menu/ShowInAdmin.php

@@ -42,7 +42,9 @@ class ShowInAdmin
                 continue;
             }
 
-            $pages = $this->sortByTitleLength($section['pages'] ?? []);
+            $pages = $section['slug'] === 'order-data'
+                ? array_values($section['pages'] ?? [])
+                : $this->sortByTitleLength($section['pages'] ?? []);
             $order = ($sectionIndex + 1) * 10;
 
             if (empty($pages)) {

app/Models/Business/InstallationDetail.php

@@ -0,0 +1,78 @@
+<?php
+
+namespace App\Models\Business;
+
+use App\Abstracts\Model;
+
+class InstallationDetail extends Model
+{
+    protected $table = 'business_installation_details';
+
+    protected $fillable = [
+        'company_id', 'installation_no', 'delete_status', 'quote_status', 'quote_deadline',
+        'installation_company', 'submitted_at', 'shipped_at', 'buyer_nickname', 'store_name',
+        'installation_type', 'pre_push_verification', 'push_status', 'push_result', 'arranged_status',
+        'order_no', 'item_quantity', 'buyer_name', 'buyer_phone', 'notes', 'province', 'city', 'district',
+        'address', 'requested_amount', 'settled_amount', 'image_urls', 'completed_status',
+        'customer_service_review', 'customer_service_reviewed_at', 'finance_review', 'finance_reviewed_at',
+        'actual_install_quantity', 'actual_install_fee', 'actual_install_product_name', 'installer_phone',
+        'installation_company_notes', 'installation_fee_payer', 'payment_channel', 'payment_transaction_no',
+        'payment_voucher', 'payment_amount', 'creator', 'related_guid', 'product_id', 'id_owner',
+        'department_owner', 'auxiliary_spu', 'product_store_code', 'item_no', 'barcode', 'product_name',
+        'supplier_name', 'detail_requested_amount', 'detail_requested_quantity', 'detail_settled_amount',
+        'detail_received_amount', 'change_reason', 'source_created_at', 'source_modified_at',
+        'product_name_1',
+    ];
+
+    protected $casts = [
+        'company_id' => 'integer',
+        'item_quantity' => 'integer',
+        'actual_install_quantity' => 'integer',
+        'detail_requested_quantity' => 'integer',
+        'requested_amount' => 'decimal:2',
+        'settled_amount' => 'decimal:2',
+        'actual_install_fee' => 'decimal:2',
+        'payment_amount' => 'decimal:2',
+        'detail_requested_amount' => 'decimal:2',
+        'detail_settled_amount' => 'decimal:2',
+        'detail_received_amount' => 'decimal:2',
+    ];
+
+    public static function columnLabels(): array
+    {
+        return [
+            'installation_no' => '安装单号', 'delete_status' => '删除状态', 'quote_status' => '报价状态',
+            'quote_deadline' => '报价截至时间', 'installation_company' => '安装公司', 'submitted_at' => '提交时间',
+            'shipped_at' => '发货时间', 'buyer_nickname' => '买家昵称', 'store_name' => '店铺名称',
+            'installation_type' => '类型', 'pre_push_verification' => '推送前验证', 'push_status' => '推送状态',
+            'push_result' => '推送结果', 'arranged_status' => '是否安排', 'order_no' => '订单编号',
+            'item_quantity' => '商品数量', 'buyer_name' => '买家姓名', 'buyer_phone' => '买家号码', 'notes' => '备注',
+            'province' => '省', 'city' => '市', 'district' => '区', 'address' => '地址',
+            'requested_amount' => '申请总金额', 'settled_amount' => '结算总金额', 'image_urls' => '图片地址',
+            'completed_status' => '是否完工', 'customer_service_review' => '客服审核',
+            'customer_service_reviewed_at' => '客服审核时间', 'finance_review' => '财务审核',
+            'finance_reviewed_at' => '财务审核时间', 'actual_install_quantity' => '实际安装数量',
+            'actual_install_fee' => '实际安装费用', 'actual_install_product_name' => '实际安装商品名称',
+            'installer_phone' => '安装师傅电话', 'installation_company_notes' => '安装公司备注',
+            'installation_fee_payer' => '安装费承担方', 'payment_channel' => '收款渠道',
+            'payment_transaction_no' => '收款交易单号', 'payment_voucher' => '收款凭证', 'payment_amount' => '收款金额',
+            'creator' => '创建人', 'related_guid' => '关联guid', 'product_id' => '商品id', 'id_owner' => 'ID负责人',
+            'department_owner' => '部门负责人', 'auxiliary_spu' => '辅助码Spu', 'product_store_code' => '商品店铺编码',
+            'item_no' => '货号', 'barcode' => '条形码', 'product_name' => '商品名称', 'supplier_name' => '供应商名称',
+            'detail_requested_amount' => '申请明细金额', 'detail_requested_quantity' => '申请明细数量',
+            'detail_settled_amount' => '结算明细金额', 'detail_received_amount' => '收款明细金额',
+            'change_reason' => '变更原因', 'source_created_at' => '创建时间', 'source_modified_at' => '修改时间',
+            'product_name_1' => '商品名称(1)',
+        ];
+    }
+
+    public static function fieldTypes(): array
+    {
+        return [
+            'item_quantity' => 'number', 'actual_install_quantity' => 'number', 'detail_requested_quantity' => 'number',
+            'requested_amount' => 'currency', 'settled_amount' => 'currency', 'actual_install_fee' => 'currency',
+            'payment_amount' => 'currency', 'detail_requested_amount' => 'currency',
+            'detail_settled_amount' => 'currency', 'detail_received_amount' => 'currency',
+        ];
+    }
+}

app/Models/Settings/DatabaseConnection.php

@@ -65,4 +65,10 @@ class DatabaseConnection extends Model
     {
         return $this->password;
     }
+
+    public function sourceIdentifier(): string
+    {
+        // Legacy names stay stable; new connections need no manually assigned binding.
+        return $this->source_key ?: 'database_' . $this->id;
+    }
 }

app/Utilities/SystemDatabaseConfiguration.php

@@ -175,9 +175,15 @@ class SystemDatabaseConfiguration
             : $this->current()['prefix'];
         $this->assertValidPrefix($prefix);
 
-        $updated = $this->replaceEnvironmentValues($current, [
+        $values = [
             'DB_CONNECTION' => 'mysql',
             'DB_HOST' => (string) $settings['host'],
+            // Laravel prioritizes split read/write hosts, URL and socket over
+            // DB_HOST. They must point to the same newly tested connection.
+            'DB_HOST_READ' => (string) $settings['host'],
+            'DB_HOST_WRITE' => (string) $settings['host'],
+            'DATABASE_URL' => '',
+            'DB_SOCKET' => '',
             'DB_PORT' => (string) $settings['port'],
             'DB_DATABASE' => (string) $settings['database'],
             'DB_USERNAME' => (string) $settings['username'],
@@ -196,7 +202,22 @@ class SystemDatabaseConfiguration
             // 另外维护完整的 DB_<SOURCE>_* 连接参数。
             'UPSTREAM_STORED_CONFIG_ENABLED' => 'true',
             'UPSTREAM_LOCAL_CONFIG_ENABLED' => 'false',
-        ]);
+        ];
+        if (isset($settings['mirror_database'])) {
+            // 团队接入统一两个库的端点，避免旧 BUSINESS_MIRROR_DB_* 覆盖新系统连接。
+            $values += [
+                'APP_INSTALLED' => 'true',
+                'BUSINESS_MIRROR_DB_HOST' => (string) $settings['host'],
+                'BUSINESS_MIRROR_DB_HOST_READ' => (string) $settings['host'],
+                'BUSINESS_MIRROR_DB_HOST_WRITE' => (string) $settings['host'],
+                'BUSINESS_MIRROR_DB_PORT' => (string) $settings['port'],
+                'BUSINESS_MIRROR_DB_DATABASE' => (string) $settings['mirror_database'],
+                'BUSINESS_MIRROR_DB_USERNAME' => (string) $settings['username'],
+                'BUSINESS_MIRROR_DB_PASSWORD' => (string) $settings['password'],
+                'BUSINESS_MIRROR_DB_SOCKET' => '',
+            ];
+        }
+        $updated = $this->replaceEnvironmentValues($current, $values);
 
         try {
             if (file_put_contents($this->environmentPath, $updated, LOCK_EX) === false) {
@@ -462,6 +483,7 @@ class SystemDatabaseConfiguration
                 VerifySystemDatabase::EXIT_CONFIG_NOT_LOADED => '新配置未被加载',
                 VerifySystemDatabase::EXIT_DATABASE_CONNECTION_FAILED => 'Laravel 数据库连接失败',
                 VerifySystemDatabase::EXIT_SYSTEM_TABLE_VALIDATION_FAILED => '系统表验证失败',
+                VerifySystemDatabase::EXIT_SHARED_NOT_CONFIGURED => '新配置仍指向本机临时引导库',
                 default => '应用级验证失败',
             };
         }
@@ -504,6 +526,14 @@ class SystemDatabaseConfiguration
             'DB_PASSWORD',
             'DB_PREFIX',
             'DB_SOCKET',
+            'BUSINESS_MIRROR_DB_HOST',
+            'BUSINESS_MIRROR_DB_HOST_READ',
+            'BUSINESS_MIRROR_DB_HOST_WRITE',
+            'BUSINESS_MIRROR_DB_PORT',
+            'BUSINESS_MIRROR_DB_DATABASE',
+            'BUSINESS_MIRROR_DB_USERNAME',
+            'BUSINESS_MIRROR_DB_PASSWORD',
+            'BUSINESS_MIRROR_DB_SOCKET',
             'MYSQL_ATTR_SSL_CIPHER',
             'MYSQL_ATTR_SSL_CA',
             'MYSQL_ATTR_SSL_VERIFY_SERVER_CERT',
@@ -554,10 +584,9 @@ class SystemDatabaseConfiguration
             $found = false;
 
             foreach ($lines as $index => $line) {
-                if (preg_match('/^' . preg_quote($key, '/') . '=/', $line) === 1) {
+                if (preg_match('/^\s*(?:export\s+)?' . preg_quote($key, '/') . '\s*=/', $line) === 1) {
                     $lines[$index] = $replacement;
                     $found = true;
-                    break;
                 }
             }
 

app/Utilities/TeamSystemDatabaseProfile.php

@@ -48,6 +48,7 @@ class TeamSystemDatabaseProfile
             'host' => $this->requiredString($profile, 'host'),
             'port' => $this->requiredPort($profile),
             'database' => $this->requiredString($profile, 'database'),
+            'mirror_database' => 'caiwu_business_mirror',
             'username' => $this->requiredString($profile, 'username'),
             'password' => $password,
             'tls_required' => true,

config/business_navigation.php

@@ -11,9 +11,9 @@ return [
                 'title' => '主体维度经营报表',
                 'directory' => [
                     'icon' => 'query_stats',
-                    'status' => '已接入店铺/公司资料',
-                    'description' => '已接入店铺和公司主体资料；销量、变更负责人等上游尚未提供的字段保留为空。',
-                    'empty' => '尚未读取到店铺或公司资料。请检查共享镜像或上游同步状态。',
+                    'status' => '尚未同步',
+                    'description' => '按店铺唯一 ID 和主体生效、失效日期归属销量；自动汇总前，先固定 Excel 中的报表字段。',
+                    'empty' => '经营报表尚未同步。完成店铺主体和销量镜像接入后，这里会显示可追溯的主体数据。',
                     'fields' => [
                         ['name' => 'city', 'label' => '市'],
                         ['name' => 'entity', 'label' => '主体'],
@@ -39,7 +39,7 @@ return [
                 'directory' => [
                     'icon' => 'business',
                     'status' => '既有只读上游',
-                    'description' => '沿用现有公司基础资料只读链路；Excel 中暂未匹配到的城市、认缴时间等字段保留为空。',
+                    'description' => '优先读取共享业务镜像中的公司资料；未匹配的城市等字段保留为空。',
                     'empty' => '尚未读取到公司基础资料。请检查共享镜像或上游同步状态。',
                     'fields' => [
                         ['name' => 'unified_social_credit_code', 'label' => '统一社会信用代码'],
@@ -112,7 +112,7 @@ return [
                 'directory' => [
                     'icon' => 'verified',
                     'status' => '既有只读上游',
-                    'description' => '沿用现有商标资料只读链路；当前已匹配名称、状态、注册时间和有效期，其余 Excel 字段待接入。',
+                    'description' => '优先读取共享业务镜像中的商标权属、有效期和保管资料。',
                     'empty' => '尚未读取到商标基础资料。请检查共享镜像或上游同步状态。',
                     'fields' => [
                         ['name' => 'trademark_name', 'label' => '商标名称'],
@@ -159,9 +159,9 @@ return [
                 'title' => '店铺维度报表',
                 'directory' => [
                     'icon' => 'query_stats',
-                    'status' => '已接入店铺/公司资料',
-                    'description' => '已接入店铺、公司主体和店铺状态资料；期间销量及 2026 年月度销量待对应销量镜像接入。',
-                    'empty' => '尚未读取到店铺资料。请检查共享镜像或上游同步状态。',
+                    'status' => '共享镜像',
+                    'description' => '店铺资料、主体生效区间和平台账单统一读取团队共享业务镜像；销量按账单收入汇总。',
+                    'empty' => '店铺维度报表尚未完成共享数据导入。',
                     'fields' => [
                         ['name' => 'erp_store_name', 'label' => 'ERP系统店铺名称'],
                         ['name' => 'store_id', 'label' => '店铺ID（唯一值）'],
@@ -190,7 +190,7 @@ return [
                 'directory' => [
                     'icon' => 'storefront',
                     'status' => '既有只读上游',
-                    'description' => '沿用现有店铺资料只读链路；Excel 中的店铺 ID、续签时间和提现账户待字段映射后补充。',
+                    'description' => '优先读取共享业务镜像中的店铺资料、店铺 ID 和续签时间；提现账户仅显示配置状态。',
                     'empty' => '尚未读取到店铺基础资料。请检查共享镜像或上游同步状态。',
                     'fields' => [
                         ['name' => 'platform', 'label' => '平台'],
@@ -209,30 +209,6 @@ return [
                     ],
                 ],
             ],
-            [
-                'slug' => 'store-accounts',
-                'title' => '店铺账号密码',
-                'directory' => [
-                    'icon' => 'key',
-                    'status' => '尚未同步',
-                    'description' => '按账号系统字段展示店铺账号、绑定信息和维护时间；账号密码等敏感字段仅按安全规则展示。',
-                    'empty' => '店铺账号数据尚未同步。接入账号系统只读数据后，这里会显示账号记录。',
-                    'fields' => [
-                        ['name' => 'store_name', 'label' => '店铺名称'],
-                        ['name' => 'store_operator', 'label' => '店铺运营负责人'],
-                        ['name' => 'operation_department_manager', 'label' => '店铺运营部门负责人'],
-                        ['name' => 'operation_director', 'label' => '店铺运营总监'],
-                        ['name' => 'profit_center', 'label' => '店铺所属利润中心'],
-                        ['name' => 'account_type', 'label' => '账号类型'],
-                        ['name' => 'account', 'label' => '账号'],
-                        ['name' => 'bound_mobile', 'label' => '绑定手机号', 'kind' => 'secret'],
-                        ['name' => 'mobile_code_recipient', 'label' => '手机号验证码接收人'],
-                        ['name' => 'account_group_name', 'label' => '账号分组名称'],
-                        ['name' => 'created_at', 'label' => '店铺创建时间', 'kind' => 'date'],
-                        ['name' => 'updated_at', 'label' => '店铺修改时间', 'kind' => 'date'],
-                    ],
-                ],
-            ],
             [
                 'slug' => 'change-progress',
                 'title' => '店铺变更进度表',

config/upstream_mirrors.php

@@ -157,6 +157,24 @@ return [
         'jiansun.dbo.alibaba_bill' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'alibaba_bill', 'target' => 'js_alibaba_bill', 'keys' => ['id']],
         'jiansun.dbo.jd_spreadBills' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'jd_spreadBills', 'target' => 'js_jd_spread_bills', 'keys' => ['id'], 'watermark' => 'updateTime'],
         'jiansun.dbo.jd_costBills' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'jd_costBills', 'target' => 'js_jd_cost_bills', 'keys' => ['id'], 'watermark' => 'creatTime'],
+        // 安装明细页面使用已整理的只读视图，避免在 HTTP 请求中临时 JOIN
+        // 安装主表和明细表；视图中的安装字段与 Excel 模板字段保持稳定别名。
+        'jiansun.dbo.fys_Ticketing_install_view' => [
+            'source_key' => 'jiansun',
+            'schema' => 'dbo',
+            'object' => 'fys_Ticketing_install_view',
+            'target' => 'js_fys_ticketing_install_view',
+            'keys' => ['Id'],
+            'watermark' => null,
+            'indexes' => [
+                ['SubmitTime', 'Id'],
+            ],
+        ],
+        'jiansun.dbo.fys_Ticketing_install_item' => [
+            'source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'fys_Ticketing_install_item',
+            'target' => 'js_fys_ticketing_install_item', 'keys' => ['Id'], 'watermark' => 'modifyTime',
+            'indexes' => [['guid', 'Id']],
+        ],
         'jiansun.dbo.finance_purchaseReturn' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'finance_purchaseReturn', 'target' => 'js_finance_purchase_return', 'keys' => ['id']],
         'jiansun.dbo.finance_invoiceDeduction' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'finance_invoiceDeduction', 'target' => 'js_finance_invoice_deduction', 'keys' => ['id'], 'watermark' => 'createTime'],
         'jiansun.dbo.fys_supplierPaymentSummary' => ['source_key' => 'jiansun', 'schema' => 'dbo', 'object' => 'fys_supplierPaymentSummary', 'target' => 'js_supplier_payment_summary', 'keys' => ['id'], 'watermark' => 'modifiedTime'],

config/upstream_pipeline.php

@@ -0,0 +1,12 @@
+<?php
+
+return [
+    // Connection records supply addresses and credentials, never these defaults.
+    'defaults' => ['enabled' => false, 'connection' => ['connect_timeout' => 5, 'query_timeout' => 15]],
+    'sync' => [
+        'max_datasets' => (int) env('BUSINESS_MIRROR_MAX_DATASETS', 8),
+        'cycle_seconds' => (int) env('BUSINESS_MIRROR_CYCLE_SECONDS', 30),
+        'dataset_seconds' => (int) env('BUSINESS_MIRROR_DATASET_SECONDS', 8),
+        'catchup_batches' => (int) env('BUSINESS_MIRROR_CATCHUP_BATCHES', 6),
+    ],
+];

database/migrations/2026_08_31_000000_create_business_installation_details_table.php

@@ -0,0 +1,87 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('business_installation_details', function (Blueprint $table): void {
+            $table->id();
+            $table->unsignedInteger('company_id')->index();
+            $table->text('installation_no')->nullable();
+            $table->text('delete_status')->nullable();
+            $table->text('quote_status')->nullable();
+            $table->text('quote_deadline')->nullable();
+            $table->text('installation_company')->nullable();
+            $table->text('submitted_at')->nullable();
+            $table->text('shipped_at')->nullable();
+            $table->text('buyer_nickname')->nullable();
+            $table->text('store_name')->nullable();
+            $table->text('installation_type')->nullable();
+            $table->text('pre_push_verification')->nullable();
+            $table->text('push_status')->nullable();
+            $table->text('push_result')->nullable();
+            $table->text('arranged_status')->nullable();
+            $table->text('order_no')->nullable();
+            $table->integer('item_quantity')->nullable();
+            $table->text('buyer_name')->nullable();
+            $table->text('buyer_phone')->nullable();
+            $table->text('notes')->nullable();
+            $table->text('province')->nullable();
+            $table->text('city')->nullable();
+            $table->text('district')->nullable();
+            $table->text('address')->nullable();
+            $table->decimal('requested_amount', 18, 2)->nullable();
+            $table->decimal('settled_amount', 18, 2)->nullable();
+            $table->text('image_urls')->nullable();
+            $table->text('completed_status')->nullable();
+            $table->text('customer_service_review')->nullable();
+            $table->text('customer_service_reviewed_at')->nullable();
+            $table->text('finance_review')->nullable();
+            $table->text('finance_reviewed_at')->nullable();
+            $table->integer('actual_install_quantity')->nullable();
+            $table->decimal('actual_install_fee', 18, 2)->nullable();
+            $table->text('actual_install_product_name')->nullable();
+            $table->text('installer_phone')->nullable();
+            $table->text('installation_company_notes')->nullable();
+            $table->text('installation_fee_payer')->nullable();
+            $table->text('payment_channel')->nullable();
+            $table->text('payment_transaction_no')->nullable();
+            $table->text('payment_voucher')->nullable();
+            $table->decimal('payment_amount', 18, 2)->nullable();
+            $table->text('creator')->nullable();
+            $table->text('related_guid')->nullable();
+            $table->text('product_id')->nullable();
+            $table->text('id_owner')->nullable();
+            $table->text('department_owner')->nullable();
+            $table->text('auxiliary_spu')->nullable();
+            $table->text('product_store_code')->nullable();
+            $table->text('item_no')->nullable();
+            $table->text('barcode')->nullable();
+            $table->text('product_name')->nullable();
+            $table->text('supplier_name')->nullable();
+            $table->decimal('detail_requested_amount', 18, 2)->nullable();
+            $table->integer('detail_requested_quantity')->nullable();
+            $table->decimal('detail_settled_amount', 18, 2)->nullable();
+            $table->decimal('detail_received_amount', 18, 2)->nullable();
+            $table->text('change_reason')->nullable();
+            $table->text('source_created_at')->nullable();
+            $table->text('source_modified_at')->nullable();
+            $table->text('product_name_1')->nullable();
+            $table->text('installation_company_1')->nullable();
+            $table->timestamps();
+            $table->softDeletes();
+            // installation_no is a TEXT field and cannot be included in a full
+            // composite index under MySQL's 3072-byte key limit; company_id
+            // already provides the tenant filter index above.
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('business_installation_details');
+    }
+};

database/migrations/2026_08_31_180000_create_business_mirror_datasets_table.php

@@ -0,0 +1,24 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::create('business_mirror_datasets', function (Blueprint $table): void {
+            $table->string('dataset_key', 191)->primary();
+            $table->string('source_key', 64)->index();
+            $table->json('definition');
+            $table->boolean('sync_enabled')->default(false);
+            $table->boolean('initial_sync_approved')->default(false);
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('business_mirror_datasets');
+    }
+};

database/migrations/2026_09_01_000000_create_store_report_mirror_tables.php

@@ -0,0 +1,79 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    private function connection(): string
+    {
+        return (string) config('upstream_mirrors.connection', 'business_mirror');
+    }
+
+    public function up(): void
+    {
+        $schema = Schema::connection($this->connection());
+
+        if (! $schema->hasTable('store_report_import_states')) {
+            $schema->create('store_report_import_states', function (Blueprint $table): void {
+                $table->string('dataset_key', 100)->primary();
+                $table->string('status', 32)->default('pending');
+                $table->uuid('active_generation')->nullable();
+                $table->uuid('pending_generation')->nullable();
+                $table->unsignedBigInteger('row_count')->default(0);
+                $table->string('source_sha256', 64)->nullable();
+                $table->longText('source_files_json')->nullable();
+                $table->dateTime('last_attempted_at')->nullable();
+                $table->dateTime('last_succeeded_at')->nullable();
+                $table->string('last_error_code', 191)->nullable();
+                $table->timestamps();
+            });
+        }
+
+        if (! $schema->hasTable('store_report_bill_rows')) {
+            $schema->create('store_report_bill_rows', function (Blueprint $table): void {
+                $table->bigIncrements('id');
+                $table->uuid('generation');
+                $table->string('platform', 32);
+                $table->string('platform_label', 64);
+                $table->string('store_name', 191);
+                $table->dateTime('occurred_at')->nullable();
+                $table->decimal('income', 20, 4)->default(0);
+                $table->decimal('expense', 20, 4)->default(0);
+                $table->string('bill_item', 255)->nullable();
+                $table->string('record_code', 191);
+                $table->string('source_file', 255);
+                $table->string('row_hash', 64);
+                $table->dateTime('imported_at');
+                $table->unique(['generation', 'platform', 'record_code'], 'store_report_bills_generation_record_unique');
+                $table->index(['generation', 'store_name', 'occurred_at'], 'store_report_bills_store_time_index');
+            });
+        }
+
+        if (! $schema->hasTable('store_report_lifecycle_rows')) {
+            $schema->create('store_report_lifecycle_rows', function (Blueprint $table): void {
+                $table->bigIncrements('id');
+                $table->uuid('generation');
+                $table->string('business_key', 64);
+                $table->string('erp_store_name', 191);
+                $table->string('company_name', 191)->nullable();
+                $table->dateTime('effective_at')->nullable();
+                $table->dateTime('expires_at')->nullable();
+                $table->string('source_file', 255);
+                $table->string('row_hash', 64);
+                $table->dateTime('imported_at');
+                $table->unique(['generation', 'business_key'], 'store_report_lifecycle_generation_key_unique');
+                $table->index(['generation', 'erp_store_name', 'effective_at'], 'store_report_lifecycle_store_time_index');
+            });
+        }
+    }
+
+    public function down(): void
+    {
+        $schema = Schema::connection($this->connection());
+        $schema->dropIfExists('store_report_lifecycle_rows');
+        $schema->dropIfExists('store_report_bill_rows');
+        $schema->dropIfExists('store_report_import_states');
+    }
+};

deploy/Dockerfile

@@ -72,6 +72,12 @@ RUN --mount=type=cache,target=/tmp/composer-cache \
 
 FROM php-base AS runtime
 
+# Keep the existing PHP/Composer cache layers when adding PostgreSQL support.
+RUN apt-get -o Acquire::Retries=3 update \
+    && apt-get -o Acquire::Retries=3 install -y --no-install-recommends libpq-dev \
+    && docker-php-ext-install -j2 pdo_pgsql \
+    && rm -rf /var/lib/apt/lists/*
+
 ARG VCS_REF=unknown
 ARG BUILD_DATE=unknown
 

deploy/Dockerfile.local

@@ -83,6 +83,11 @@ RUN --mount=type=cache,target=/root/.npm \
     npm ci --no-audit --no-fund --legacy-peer-deps
 
 # ---------------- 复制源码 ----------------
+RUN apt-get -o Acquire::Retries=3 update \
+    && apt-get -o Acquire::Retries=3 install -y --no-install-recommends libpq-dev \
+    && docker-php-ext-install -j2 pdo_pgsql \
+    && rm -rf /var/lib/apt/lists/*
+
 COPY . /var/www/html
 COPY deploy/apache-vhost.conf /etc/apache2/sites-available/000-default.conf
 COPY deploy/php.ini /usr/local/etc/php/conf.d/jiangling.ini

deploy/local-init.sh

@@ -316,6 +316,23 @@ if [ "$db_host" = "mysql" ]; then
 fi
 
 
+# 已保存的团队密码可解锁最新端点；服务器迁移不应要求每台开发机手改 .env。
+# 无有效团队密码的首次引导保持原状，仍通过网页完成一次接入。
+echo "==> 自动对齐本机团队共享连接..."
+if docker compose -f "$compose_file" run --rm --no-deps -T --entrypoint sh app -c \
+    'jiangling-entrypoint true && exec runuser -u www-data -- php artisan system-database:connect-team --no-interaction --no-ansi'; then
+    team_connect_status=0
+else
+    team_connect_status=$?
+fi
+if [ "$team_connect_status" -ne 0 ] && [ "$team_connect_status" -ne 13 ]; then
+    echo "错误：本机未完成自动接入；请先按上方提示核对连接和私有配置备份。" >&2
+    exit "$team_connect_status"
+fi
+
+db_host="$(read_env_value DB_HOST)"
+app_installed="$(read_env_value APP_INSTALLED | tr '[:upper:]' '[:lower:]')"
+
 docker compose -f "$compose_file" up -d --no-build app
 
 # 容器可能已经存在而没有重新执行 entrypoint。显式复用同一权限初始化逻辑，
@@ -397,16 +414,30 @@ fi
 
 echo ""
 echo "====================================================="
-echo "本地测试环境已就绪：http://127.0.0.1:18088"
+echo "本地网页可访问：http://127.0.0.1:18088"
 
-db_host="$(read_env_value DB_HOST)"
-if [ "$db_host" = "mysql" ]; then
-    echo "临时登录凭据保存在本机私有文件：$credential_file"
-    echo "请自行打开该文件，不要把内容提交到 Git、聊天或日志。"
-    echo ""
-    echo "下一步：登录后打开“系统设置 → 数据库管理 → 系统数据库”，"
-    echo "点击“连接”，只填写负责人提供的系统数据库密码。"
+# Docker healthy 只表示当前连接可用；共享接入必须由新 Laravel 进程实测，
+# 不能根据 DB_HOST 不是 mysql 就宣称团队数据已连接。
+if docker compose -f "$compose_file" exec -T -u www-data app \
+    php artisan system-database:verify --no-ansi; then
+    shared_status=0
 else
-    echo "已连接团队共享系统数据库，请使用其中属于自己的正式账号登录。"
+    shared_status=$?
 fi
+
+case "$shared_status" in
+    0)
+        echo "团队共享系统数据库验证通过，请使用其中属于自己的正式账号登录。"
+        ;;
+    13)
+        echo "团队数据接入尚未完成；后台 worker 启动不代表数据已经同步。"
+        echo "临时登录凭据保存在本机私有文件：$credential_file"
+        echo "请登录后输入一次系统数据库密码，连接成功后改用团队正式账号登录。"
+        ;;
+    *)
+        echo "团队共享系统数据库未通过验证；不要将 Docker healthy 当作接入成功。" >&2
+        echo "请让 Codex 根据上方失败阶段检查本机配置，保留现有配置和未提交代码。" >&2
+        exit "$shared_status"
+        ;;
+esac
 echo "====================================================="

docs/上游业务镜像清单.md

@@ -20,6 +20,14 @@
 
 ## 经营分析副本库（operations_replica）
 
+店铺维度报表不使用订单件数代替销量。五个平台原始账单和店铺生命周期
+以完整导入代次写入 `caiwu_business_mirror` 的 `store_report_bill_rows`、
+`store_report_lifecycle_rows`，成功后原子切换，失败时继续读取上一代。
+店铺资料仍以 `rpt.fys_shopInfo` 镜像为主；两份导入数据按 ERP 店铺名称
+关联。每个生命周期行使用 `[effective_at, expires_at)`，销量固定为账单
+`income` 汇总；结算时间存在时优先使用结算时间，否则使用平台发生时间。
+所有开发机与生产页面读取同一份共享镜像，不依赖开发者本机文件。
+
 | 业务范围 | 上游对象 | 镜像目标 |
 | --- | --- | --- |
 | 公司资料 | `rpt.fys_companyInfo` | `ops_fys_company_info` |
@@ -30,6 +38,7 @@
 | 推广费用 | `rpt.ads_itemid_sales_cost_ratio_v2_di` | `ops_item_sales_cost_ratio` |
 | 退款退货 | `rpt.jst_returnAndRefundInfo`、`rpt.jst_returnAndRefundItem` | `ops_jst_return_refund_*` |
 | 聚水潭店铺 | `rpt.jst_shopInfo` | `ops_jst_shop_info` |
+| 店铺维度报表 | 五个平台原始账单导出、店铺生命周期导出 | `store_report_bill_rows`、`store_report_lifecycle_rows` |
 
 商品价格 `rpt.Bulk_Price_Limit` 继续使用已经上线的类型化同步器，不在通用原表任务中重复同步。
 
@@ -39,6 +48,7 @@
 | --- | --- |
 | 营销账户 | `dbo.tmall_spread_bills`、`dbo.pdd_spread_bills`、`dbo.alibaba_bill`、`dbo.jd_spreadBills`、`dbo.jd_costBills` |
 | 供应商应付 | `dbo.finance_purchaseReturn`、`dbo.finance_invoiceDeduction`、`dbo.fys_supplierPaymentSummary`、`dbo.finance_advanceLoans`、`dbo.pm_unOrderDetails`、`dbo.finance_sampleDeduction`、`dbo.fys_express_courier_settlement` |
+| 安装明细 | `dbo.fys_Ticketing_install_view`、`dbo.fys_Ticketing_install_item` |
 | 板材 | `dbo.finance_boardDeduction`、`dbo.pm_plainPlateData`、`dbo.pm_boardPurchasePrice`、`dbo.pm_boardPriceChangeImport`、`dbo.pm_boardApplyDetail` |
 | 封边条 | `dbo.pm_edgeBandData`、`dbo.pm_edgeBandApplyDetail`、`dbo.pm_edgeBandProfitInfo`、`dbo.finance_edgeBandDeductio`、`dbo.pm_averageUnitPrice` |
 | 库存与货款对账 | `dbo.pm_boardInventoryDetail_snapshot`、`dbo.fys_supplierGoods_sttlement_purchase`、`dbo.fys_supplierGoods_sttlement_sale`、`dbo.pm_purchaseIn` |

docs/开发与部署SOP.md

@@ -163,6 +163,8 @@ git pull --ff-only
 
 ## 8. 多上游财务数据库同步
 
+新数据库和新数据集优先使用 [通用上游数据接入](通用上游数据接入.md)：来源由连接记录自动登记，已批准的声明式数据集由调度自动首次同步和增量同步。下面的固定来源、逐项 `--full` 和旧快照说明适用于既有兼容路径，不应当作为新增普通开发任务的重复审批要求。
+
 ### 8.1 统一接入边界
 
 本系统按 3 个以上上游数据库设计。生产系统数据库的启动连接只存在于服务器私有 `runtime/.env`；本地新人只填写系统数据库密码，即可自动解锁两套上游的固定主机、端口、库名、账号和密码，不需要复制生产 `APP_KEY`、填写上游环境变量或等待负责人开放范围。

docs/通用上游数据接入.md

@@ -0,0 +1,59 @@
+# 通用上游数据接入
+
+## 使用边界
+
+财务主库仍为团队 MariaDB/MySQL。SQL Server、PostgreSQL、MySQL/MariaDB 上游共用来源发现、字典、有限样本查询和表级镜像入口。添加同类型的第二个数据库不需要修改来源枚举、工厂或刷新器。
+
+数据库连接记录未设置历史 `source_key` 时，系统使用稳定标识 `database_<记录ID>`。已有 `jiansun`、`operations_replica`、`js_data_middle_platform` 等映射保留。普通连接表单不再要求手工绑定来源或填写旧快照 scope；编辑旧连接仍保留这些历史字段。
+
+原生 PostgreSQL/MySQL 连接统一要求 TLS、只读会话、非持久连接及最长 15 秒查询。SQL Server 继续复用已验证的 ODBC/DBLIB 入口。应用限制不替代上游只读账号；不提供接受用户原始 SQL 的网页接口。
+
+## 开发流程（由 Codex 执行）
+
+1. 新人通过标准初始化启动本地环境，首次输入一次团队系统数据库密码。Docker healthy 只证明当前程序可用，`system-database:verify` 成功才表示共享接入通过。普通页面、计算逻辑和自动测试可先使用明确的隔离 fixture；不得把模拟数据当作真实财务数据。
+2. 在数据库管理页面添加并启用连接；“测试”与实际读取共用同一驱动。生产及现有字典刷新任务会发现新来源，不再要求逐库添加专用刷新器。
+3. `php artisan upstream:inspect` 列出来源标识，不输出凭据。`upstream:inspect <source>` 列出已有字典对象；`upstream:inspect <source> <schema> <object>` 查看字段。
+4. 缺少目录时运行 `upstream:schema:sync <source>`。此命令只读上游元数据、写入系统库目录，失败保留原目录。
+5. 需要样本时明确指定 `--columns=id,updated_at,label --limit=5`，最多返回20行。只选本任务有权读取的非敏感字段；真实样本不得进入 Git、PR 或公开日志。样本不能证明全量完整性。
+6. 确认业务键、需要的字段、增量依据和业务含义后，登记数据集。以下仅为示例，表名必须来自实际目录：
+
+```sh
+php artisan business-mirror:register database_17 public example_orders \
+  --keys=id --columns=id,updated_at,label --watermark=updated_at
+```
+
+登记默认不启动同步。生产首次同步涉及系统库登记和业务镜像表创建/写入，应先说明精确字段、批次、影响及备份，再取得负责人授权。授权后对同一声明追加 `--enable-sync`，生产调度即可自动完成或续传首次全量，完成后转为增量；不再为每次部署、分页、筛选重新审批或生成快照。`--disable-sync` 停止后续自动执行，保留已有镜像。
+
+声明式登记不能覆盖代码维护的数据集，也不能悄悄修改已有声明的稳定键、字段和增量口径；此类变化需评估历史数据/游标兼容性。来源表没有可靠更新时间时只按主键追加，不能承诺自动发现历史修改或删除，需另行声明校准策略。
+
+## 页面读取与同步状态
+
+### 已有公司、店铺、商标页在新人电脑没有数据
+
+`deploy/local-init.sh` 会先使用本机已经保存的团队密码，按当前代码的加密团队资料验证最新端点；验证成功后自动备份并对齐系统库和业务镜像库的私有配置。这样服务器迁移后不必每台开发机手动修改主机、端口或上游开关。当前连接已正确时不会重复改写配置；验证失败保留原配置。此自动修复只在本地开发运行，不修改生产端点，不执行迁移或业务同步。
+
+已有本地容器可由 Codex 直接执行 `docker compose -f docker-compose.local.yml exec -T -u www-data app php artisan system-database:connect-team`。从未保存团队密码的机器返回“首次接入”状态，仍只需在网页输入一次系统数据库密码；自动化接入可用 `--password-stdin` 安全传入，不提供明文密码命令行参数。不能把普通测试管理员的网页登录密码当成系统数据库密码。
+
+这些页面优先读取 `caiwu_business_mirror`。本机 Docker 正常、临时引导库有用户，并不代表已经连接团队共享库。Codex 应先在最新主线执行 `deploy/local-init.sh`，通过系统数据库入口完成一次共享接入和重新登录，再运行 `system-database:verify` 并检查相应 `business-mirror:status`。镜像连接默认复用系统数据库主机、端口、账号和 TLS，不要求新人另填 SQL Server 密码，也不要把 `furniture3d_prod` 填成 `operations_replica`。
+
+已有镜像可读时，上游开关关闭或网络暂不可达不应阻断页面。读取失败不能解释为真实记录数为 0。只有探索尚未接入的新表时，才需要使用对应上游的只读连接；不要为了让已有资料页出数据，在每个开发者的引导库重复登记生产来源。
+
+新页面在原有公司、角色和数据权限校验之后调用 `BusinessMirrorDataReader::paginate($datasetKey, $filters, $page, $perPage)`。它只读业务镜像，返回完整总数、稳定分页、实际同步状态和最近完成时间。来源暂时关闭或不可达时，已完成镜像仍可读取；无首次镜像时明确报“尚未完成首次同步”，不登记逐页快照、不从页面直接访问上游。
+
+通用筛选只接受已声明字段的等值条件；复杂业务联表、金额口径、公司行级过滤继续由固定 Repository 实现。不能把此内部读取器当作绕过业务权限的公开接口。
+
+`php artisan business-mirror:status [dataset] --json` 只读输出启用、首次完成、最近尝试、最近完成及错误类型。`running` 表示一个同步窗口尚未完成，不保证此刻正有进程运行。最后尝试时间不是最后数据完成时间。
+
+通用调度默认每轮最多8个数据集、30秒周期预算；未完成窗口与常规数据集交替处理，单数据集默认8秒软预算，积压任务默认最多6批。预算在批次之间检查，单条查询仍受驱动超时限制；不提高上游并发。失败任务至少冷却5分钟。专用商品/价格/钉钉调度保持既有路径。
+
+只对明确批准的登记数据集自动首次同步；既有代码数据集仍保留原首次授权流程。未完成的旧页面切换不等于已经上线，必须逐页验收并与正在开发的 PR 协调。
+
+## 类型及验收
+
+- PostgreSQL 带时区时间戳在镜像中保存为 UTC；业务展示按自己的明确时区换算。无时区日期时间保留原值。`bytea` 使用十六进制文本表示；不自动解释 JSON、数组、枚举中的业务语义。
+- 验收包含：没有修改来源枚举也能发现新库；TLS/只读保护；字段目录；只复制明确字段；首次同步、第二页、末页、总数和筛选；增量插入与更新；源不可达时读旧镜像；失败和未授权状态。
+- SQL Server 既有 Repository 与专用同步器需回归。不得把“新连接测试成功”当作全项目页面已迁移或所有业务表已同步。
+
+## 系统连接保存后回滚的排查
+
+截图中的“新配置未通过应用级验证”表示已尝试保存并复核，不等于未输入密码。保存系统连接必须同时统一 `DB_HOST`、读写地址，清除旧 `DATABASE_URL` 和 socket 覆盖，并处理重复赋值；验证失败时恢复完整旧配置。不要只改 `SYSTEM_DATABASE_MODE` 标志，也不要关闭失败回滚来制造“连接成功”。

modules/EcommerceFinance/Repositories/BusinessInformationMirrorRepository.php

@@ -48,6 +48,20 @@ class BusinessInformationMirrorRepository
         };
     }
 
+    /** @return array<int,array<string,mixed>> */
+    public function allStores(): array
+    {
+        if (! $this->ready('store-information.read')) {
+            throw new RuntimeException('business_mirror_dataset_not_ready');
+        }
+
+        return $this->storeQuery()
+            ->orderByDesc('s.Id')
+            ->get()
+            ->map(static fn (object $row): array => (array) $row)
+            ->all();
+    }
+
     /** @return array{data: array<int,array<string,mixed>>, total: int} */
     private function companies(int $page, int $perPage): array
     {
@@ -63,6 +77,7 @@ legalRepresentative AS legal_representative,
 registeredAddress AS registered_address,
 businessScope AS business_scope,
 accountSerialNumber AS basic_deposit_account_number,
+registeredCapitalVaildTime AS subscribed_at,
 companyStatus AS company_status,
 financialManager AS financial_officer,
 supervisor AS supervisor,
@@ -75,6 +90,11 @@ SQL);
 
     /** @return array{data: array<int,array<string,mixed>>, total: int} */
     private function stores(int $page, int $perPage): array
+    {
+        return $this->page($this->storeQuery(), $page, $perPage, 's.Id');
+    }
+
+    private function storeQuery()
     {
         $latestCompanies = $this->connection->table('ops_fys_company_info')
             ->selectRaw('unifiedSocialCreditCode, MAX(Id) AS latest_id')
@@ -89,21 +109,26 @@ SQL);
             ->leftJoin('ops_fys_company_info AS c', 'c.Id', '=', 'company_keys.latest_id')
             ->selectRaw(<<<'SQL'
 s.Id AS id,
+s.sotreId AS store_id,
 s.openTime AS opened_at,
+s.renewalTime AS renewed_at,
 s.erpShopName AS erp_store_name,
 s.unifiedSocialCreditCode AS unified_social_credit_code,
 c.businessLicenseName AS company_name,
+c.businessLicenseType AS company_type,
 s.trademarkNumber AS trademark_number,
 NULL AS trademark_name,
 s.platform AS platform,
 s.responsibleDepartment AS profit_center,
 s.shopHead AS store_manager,
+s.customerDeptManager AS department_manager,
 s.shopState AS store_status,
+s.shopBankAccount AS withdrawal_account,
 s.shopType AS store_type,
 s.channelType AS channel_mode
 SQL);
 
-        return $this->page($query, $page, $perPage, 's.Id');
+        return $query;
     }
 
     /** @return array{data: array<int,array<string,mixed>>, total: int} */
@@ -113,11 +138,16 @@ SQL);
             ->where('isDelete', 0)
             ->selectRaw(<<<'SQL'
 Id AS id,
+trademarkNumber AS trademark_number,
 trademarkName AS trademark_name,
 internationalClassification AS trademark_type,
 trademarkStatus AS trademark_status,
 registrationDate AS registration_date,
 termOfValidity AS expiry_date,
+approvedCommodities AS approved_goods,
+transferenceUser AS final_holder,
+registrationAddress AS registered_address,
+custodyDepartment AS custody_department,
 remark AS notes
 SQL);
 

modules/EcommerceFinance/Repositories/InstallationDetailMirrorRepository.php

@@ -0,0 +1,232 @@
+<?php
+
+namespace Modules\EcommerceFinance\Repositories;
+
+use Illuminate\Support\Facades\Schema;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
+
+/** 只读安装明细镜像；页面不得回退直连 JianSun。 */
+class InstallationDetailMirrorRepository
+{
+    public const DATASET = 'jiansun.dbo.fys_Ticketing_install_view';
+    public const ITEM_DATASET = 'jiansun.dbo.fys_Ticketing_install_item';
+
+    public function __construct(
+        private readonly GenericBusinessMirrorRepository $mirror,
+        private readonly BusinessMirrorDatasetRegistry $datasets,
+    )
+    {
+    }
+
+    /** @return array{data:list<array<string,mixed>>,total:int,ready:bool} */
+    public function paginate(int $page, int $perPage, array $filters = []): array
+    {
+        $connection = $this->mirror->connection();
+        $dataset = $this->datasets->get(self::DATASET);
+        $items = $this->datasets->get(self::ITEM_DATASET);
+        if (! $this->ready($dataset, $items, $connection->getName())) {
+            return ['data' => [], 'total' => 0, 'ready' => false];
+        }
+
+        $perPage = min(max($perPage, 1), 100);
+        // 主视图按商品行展开，同一安装单会出现多行；主表只保留每个
+        // SourceGuid 的最新 Id，商品行通过 details() 单独展开。
+        $latest = $connection->table($dataset->targetTable())
+            ->selectRaw('MAX(Id) AS id')
+            ->groupBy('SourceGuid');
+        $query = $connection->table($dataset->targetTable() . ' AS v')
+            ->joinSub($latest, 'latest', static fn ($join) => $join->on('latest.id', '=', 'v.Id'))
+            ->select('v.*');
+        $this->applyFilters($query, $filters, $items->targetTable());
+        $total = (clone $query)->count();
+        $rows = $query->orderByDesc('v.Id')->forPage(max($page, 1), $perPage)->get();
+
+        return ['data' => $rows->map(fn (object $row): array => $this->map((array) $row))->all(), 'total' => $total, 'ready' => true];
+    }
+
+    /** @return array{data:list<array<string,mixed>>,ready:bool} */
+    public function details(string $guid): array
+    {
+        $dataset = $this->datasets->get(self::DATASET);
+        $items = $this->datasets->get(self::ITEM_DATASET);
+        $connection = $this->mirror->connection();
+        if (! $this->ready($dataset, $items, $connection->getName())) {
+            return ['data' => [], 'ready' => false];
+        }
+
+        $mainExists = $connection->table($dataset->targetTable())
+            ->where('SourceGuid', $guid)
+            ->exists();
+        if (! $mainExists) {
+            return ['data' => [], 'ready' => true];
+        }
+
+        $transactionNo = $connection->table($dataset->targetTable())
+            ->where('SourceGuid', $guid)
+            ->orderByDesc('Id')->value('OrderNum');
+        $rows = $connection->table($items->targetTable())
+            ->where('guid', $guid)
+            ->orderBy('Id')
+            ->limit(101)
+            ->get();
+
+        return ['data' => $rows->take(100)->map(fn (object $row): array => $this->mapItem((array) $row, $transactionNo))->all(), 'ready' => true, 'has_more' => $rows->count() > 100];
+    }
+
+    private function ready($dataset, $items, string $connection): bool
+    {
+        return $this->mirror->ready($dataset) && $this->mirror->ready($items)
+            && Schema::connection($connection)->hasTable($dataset->targetTable())
+            && Schema::connection($connection)->hasTable($items->targetTable());
+    }
+
+    /** @return array{rows:int,requested:float,settled:float,paid:float} */
+    public function summary(array $filters = []): array
+    {
+        $dataset = $this->datasets->get(self::DATASET);
+        $connection = $this->mirror->connection();
+        if (! $this->mirror->ready($dataset) || ! Schema::connection($connection->getName())->hasTable($dataset->targetTable())) {
+            return ['rows' => 0, 'requested' => 0.0, 'settled' => 0.0, 'paid' => 0.0];
+        }
+        $latest = $connection->table($dataset->targetTable())
+            ->selectRaw('MAX(Id) AS id')
+            ->groupBy('SourceGuid');
+        $query = $connection->table($dataset->targetTable() . ' AS v')
+            ->joinSub($latest, 'latest', static fn ($join) => $join->on('latest.id', '=', 'v.Id'));
+        $this->applyFilters($query, $filters, $this->datasets->get(self::ITEM_DATASET)->targetTable());
+        $row = $query
+            ->selectRaw('COUNT(*) AS row_count, COALESCE(SUM(v.installcost),0) AS requested, COALESCE(SUM(v.settleAmount),0) AS settled, COALESCE(SUM(v.acceptAmount),0) AS paid')
+            ->first();
+        return ['rows' => (int) $row->row_count, 'requested' => (float) $row->requested, 'settled' => (float) $row->settled, 'paid' => (float) $row->paid];
+    }
+
+    public static function requestFilters(): array
+    {
+        $rules = [];
+        foreach (['created', 'customer_review', 'finance_review'] as $prefix) {
+            $rules[$prefix . '_from'] = ['nullable', 'date_format:Y-m-d'];
+            $rules[$prefix . '_to'] = ['nullable', 'date_format:Y-m-d'];
+            if (request()->filled($prefix . '_from')) $rules[$prefix . '_to'][] = 'after_or_equal:' . $prefix . '_from';
+        }
+        foreach (['push_status','order_no','customer_review','finance_review','quote_status','arranged_status','fee_payer','completed_status','shop_name','delete_status','installation_company','installation_no','order_type','product_id'] as $key) {
+            $rules[$key] = ['nullable', 'string', 'max:191'];
+        }
+        foreach (['customer_review', 'finance_review', 'arranged_status', 'completed_status', 'delete_status'] as $key) $rules[$key][] = 'in:0,1';
+        return validator(request()->only(array_keys($rules)), $rules)->validate();
+    }
+
+    private function applyFilters($query, array $filters, string $itemTable): void
+    {
+        foreach (['created'=>'SubmitTime', 'customer_review'=>'kfshTime', 'finance_review'=>'cwshTime'] as $prefix=>$column) {
+            if (!empty($filters[$prefix.'_from'])) $query->where('v.'.$column, '>=', $filters[$prefix.'_from']);
+            if (!empty($filters[$prefix.'_to'])) $query->where('v.'.$column, '<', \Illuminate\Support\Carbon::parse($filters[$prefix.'_to'])->addDay()->toDateString());
+        }
+        foreach (['push_status'=>'apistatus','order_no'=>'OrderNum','customer_review'=>'kfsh','finance_review'=>'cwsh','quote_status'=>'BidStatus','fee_payer'=>'costtaker','completed_status'=>'installComplete','shop_name'=>'shop_name','delete_status'=>'Delete','installation_company'=>'installCompanyName','installation_no'=>'ordernum_id','order_type'=>'TypeDto'] as $key=>$column) {
+            if (isset($filters[$key]) && $filters[$key] !== '') $query->where('v.'.$column, $filters[$key]);
+        }
+        if (isset($filters['arranged_status']) && $filters['arranged_status'] !== '') {
+            $query->where('v.StatusId', $filters['arranged_status'] === '1' ? '>' : '<=', 0);
+        }
+        if (!empty($filters['product_id'])) {
+            $query->whereExists(function ($sub) use ($itemTable, $filters) {
+                $sub->selectRaw('1')->from($itemTable.' AS filter_item')
+                    ->whereColumn('filter_item.guid', 'v.SourceGuid')->where('filter_item.shopproid', $filters['product_id']);
+            });
+        }
+    }
+
+    /** @param array<string,mixed> $row */
+    private function map(array $row): array
+    {
+        $value = static function (array $row, string ...$names): mixed {
+            foreach ($names as $name) {
+                foreach ($row as $key => $value) if (strcasecmp((string) $key, $name) === 0) return $value;
+            }
+            return null;
+        };
+
+        $mapped = [
+            'id' => $value($row, 'detail_id', 'Id'), 'installation_no' => $value($row, 'ordernum_id', 'OrderNum'),
+            'delete_status' => $value($row, 'Delete'), 'quote_status' => $value($row, 'BidStatus'), 'quote_deadline' => $value($row, 'BidEndTime'),
+            'installation_company' => $value($row, 'installCompanyName'), 'submitted_at' => $value($row, 'SubmitTime'),
+            'shipped_at' => $value($row, 'ShipTIme'), 'buyer_nickname' => $value($row, 'BuyersNick'),
+            'store_name' => $value($row, 'shop_name', 'shopname'), 'installation_type' => $value($row, 'TypeDto'),
+            'pre_push_verification' => $value($row, 'checkMsg'), 'push_status' => $value($row, 'apistatus'),
+            'push_result' => $value($row, 'apiresult'), 'arranged_status' => $this->arranged($value($row, 'StatusId')),
+            'order_no' => $value($row, 'OrderNum'),
+            'item_quantity' => $value($row, 'Num'), 'buyer_name' => $value($row, 'BuyersName'), 'buyer_phone' => $value($row, 'Mobile'),
+            'notes' => $value($row, 'Nots'), 'province' => $value($row, 'Province'), 'city' => $value($row, 'City'),
+            'district' => $value($row, 'Area'), 'address' => $value($row, 'Address'), 'requested_amount' => $value($row, 'installcost'),
+            'settled_amount' => $value($row, 'settleAmount'), 'image_urls' => $value($row, 'Picture'),
+            'completed_status' => $this->yesNo($value($row, 'installComplete')),
+            'customer_service_review' => $this->review($value($row, 'kfsh')), 'customer_service_reviewed_at' => $value($row, 'kfshTime'),
+            'finance_review' => $this->review($value($row, 'cwsh')), 'finance_reviewed_at' => $value($row, 'cwshTime'),
+            'actual_install_quantity' => $value($row, 'installNum'), 'actual_install_fee' => $value($row, 'install_Cost'),
+            'actual_install_product_name' => $value($row, 'installGoodsName'), 'installer_phone' => $value($row, 'installTel'),
+            'installation_company_notes' => $value($row, 'installNote'), 'installation_fee_payer' => $value($row, 'costtaker'),
+            'payment_channel' => $value($row, 'costWay'), 'payment_transaction_no' => $value($row, 'actporderNum'),
+            'payment_voucher' => $value($row, 'costWayVoucher'), 'payment_amount' => $value($row, 'acceptAmount'),
+            'creator' => $value($row, 'Operation'), 'related_guid' => $value($row, 'detail_guid', 'SourceGuid'),
+            'product_id' => $value($row, 'shopproid'), 'auxiliary_spu' => $value($row, 'Spu'),
+            'product_store_code' => $value($row, 'shopskucode'), 'item_no' => $value($row, 'proCode'),
+            'barcode' => $value($row, 'barCode'), 'product_name' => $value($row, 'skuName'), 'supplier_name' => $value($row, 'scmname'),
+            'detail_requested_amount' => $value($row, 'applyItemAmount'), 'detail_requested_quantity' => $value($row, 'installcount'),
+            'detail_settled_amount' => $value($row, 'settleItemAmount'), 'detail_received_amount' => $value($row, 'acceptItemAmount'),
+            'change_reason' => $value($row, 'remark'), 'source_created_at' => $value($row, 'item_created_at'),
+            'source_modified_at' => $value($row, 'item_modified_at'),
+        ];
+        // 页面按模板的完整 61 列渲染；视图暂未提供的字段必须显式为 null，
+        // 不能让 Blade 读取未定义属性。
+        return array_replace(array_fill_keys(array_keys(\App\Models\Business\InstallationDetail::columnLabels()), null), $mapped);
+    }
+
+    /** @param array<string,mixed> $row */
+    private function mapItem(array $row, mixed $transactionNo = null): array
+    {
+        $value = static function (array $row, string ...$names): mixed {
+            foreach ($names as $name) {
+                foreach ($row as $key => $value) {
+                    if (strcasecmp((string) $key, $name) === 0) {
+                        return $value;
+                    }
+                }
+            }
+            return null;
+        };
+
+        return [
+            'transaction_no' => $value($row, 'Sourceno', 'source_no', 'orderNum', 'ordernum') ?? $transactionNo,
+            'product_id' => $value($row, 'shopproid'),
+            'id_owner' => $value($row, 'id_owner', 'idOwner'),
+            'department_owner' => $value($row, 'department_owner', 'departmentOwner'),
+            'auxiliary_spu' => $value($row, 'Spu'),
+            'product_store_code' => $value($row, 'shopskucode'),
+            'item_no' => $value($row, 'proCode'),
+            'barcode' => $value($row, 'barCode'),
+            'product_name' => $value($row, 'skuName'),
+            'supplier_name' => $value($row, 'scmname'),
+            'detail_requested_amount' => $value($row, 'applyItemAmount'),
+            'detail_requested_quantity' => $value($row, 'installcount'),
+            'detail_settled_amount' => $value($row, 'settleItemAmount'),
+            'detail_received_amount' => $value($row, 'acceptItemAmount'),
+            'change_reason' => $value($row, 'remark'),
+            'source_created_at' => $value($row, 'createTime'),
+            'source_modified_at' => $value($row, 'modifyTime'),
+        ];
+    }
+
+    private function yesNo(mixed $value): ?string
+    {
+        return $value === null ? null : ((int) $value === 1 ? '是' : '否');
+    }
+
+    private function review(mixed $value): ?string
+    {
+        return $value === null ? null : ((int) $value === 1 ? '已审核' : '未审核');
+    }
+
+    private function arranged(mixed $value): ?string
+    {
+        return $value === null ? null : ((int) $value > 0 ? '已安排' : '未安排');
+    }
+}

modules/EcommerceFinance/Repositories/StoreReportRepository.php

@@ -0,0 +1,222 @@
+<?php
+
+namespace Modules\EcommerceFinance\Repositories;
+
+use Illuminate\Database\ConnectionInterface;
+use Illuminate\Database\DatabaseManager;
+use Illuminate\Support\Facades\Schema;
+use RuntimeException;
+
+/** 店铺维度报表只读取团队共享业务镜像。 */
+class StoreReportRepository
+{
+    public const BILLS_DATASET = 'store-report.platform-bills';
+    public const LIFECYCLES_DATASET = 'store-report.store-lifecycles';
+
+    private const DEFAULT_EXPIRES_AT = '2999-01-01';
+
+    private readonly ConnectionInterface $connection;
+
+    public function __construct(DatabaseManager $databases)
+    {
+        $this->connection = $databases->connection(
+            (string) config('upstream_mirrors.connection', 'business_mirror'),
+        );
+    }
+
+    /**
+     * @param array<int,array<string,mixed>> $stores
+     * @return array<int,array<string,mixed>>
+     */
+    public function rows(array $stores, ?int $reportYear = null): array
+    {
+        if ($stores === []) {
+            return [];
+        }
+
+        [$billGeneration, $lifecycleGeneration] = $this->activeGenerations();
+        $reportYear ??= (int) now()->format('Y');
+        if ($reportYear < 2000 || $reportYear > 2999) {
+            throw new RuntimeException('店铺维度报表年份无效。');
+        }
+
+        $names = array_values(array_unique(array_filter(array_map(
+            static fn (array $row): string => trim((string) ($row['erp_store_name'] ?? '')),
+            $stores,
+        ))));
+        $lifecycles = $this->lifecycles($names, $lifecycleGeneration);
+        $lifecycleSales = $this->lifecycleSales($names, $billGeneration, $lifecycleGeneration);
+        $fallbackSales = $this->fallbackSales(array_values(array_diff($names, array_keys($lifecycles))), $billGeneration);
+        $rows = [];
+
+        foreach ($stores as $store) {
+            $storeName = trim((string) ($store['erp_store_name'] ?? ''));
+            if ($storeName === '') {
+                continue;
+            }
+
+            $periods = $lifecycles[$storeName] ?? [[
+                'company_name' => $store['company_name'] ?? null,
+                'effective_at' => $store['opened_at'] ?? sprintf('%d-01-01', $reportYear),
+                'expires_at' => self::DEFAULT_EXPIRES_AT,
+                'lifecycle_id' => null,
+            ]];
+
+            foreach ($periods as $period) {
+                $saleData = $period['lifecycle_id'] === null
+                    ? ($fallbackSales[$storeName] ?? ['period' => 0.0, 'months' => []])
+                    : ($lifecycleSales[(string) $period['lifecycle_id']] ?? ['period' => 0.0, 'months' => []]);
+                $monthly = [];
+                for ($month = 1; $month <= 12; $month++) {
+                    $monthly[sprintf('sales_%02d', $month)] = (float) (
+                        $saleData['months'][sprintf('%d-%02d', $reportYear, $month)] ?? 0
+                    );
+                }
+
+                $rows[] = [
+                    ...$store,
+                    'store_id' => $store['store_id'] ?? $storeName,
+                    'status' => $this->status($store['store_status'] ?? null),
+                    'entity' => $period['company_name'] ?: ($store['company_name'] ?? null),
+                    'effective_at' => $this->date($period['effective_at'] ?? null, sprintf('%d-01-01', $reportYear)),
+                    'invalid_at' => $this->date($period['expires_at'] ?? null, self::DEFAULT_EXPIRES_AT),
+                    'period_sales' => (float) $saleData['period'],
+                    ...$monthly,
+                ];
+            }
+        }
+
+        return $rows;
+    }
+
+    /** @return array{0:string,1:string} */
+    private function activeGenerations(): array
+    {
+        $schema = Schema::connection($this->connection->getName());
+        foreach (['store_report_import_states', 'store_report_bill_rows', 'store_report_lifecycle_rows'] as $table) {
+            if (! $schema->hasTable($table)) {
+                throw new RuntimeException('店铺维度报表共享镜像尚未完成迁移。');
+            }
+        }
+
+        $states = $this->connection->table('store_report_import_states')
+            ->whereIn('dataset_key', [self::BILLS_DATASET, self::LIFECYCLES_DATASET])
+            ->get(['dataset_key', 'status', 'active_generation'])
+            ->keyBy('dataset_key');
+
+        foreach ([self::BILLS_DATASET, self::LIFECYCLES_DATASET] as $dataset) {
+            $state = $states->get($dataset);
+            if ($state === null || empty($state->active_generation)) {
+                throw new RuntimeException('店铺维度报表共享数据尚未完成首次导入。');
+            }
+        }
+
+        return [
+            (string) $states->get(self::BILLS_DATASET)->active_generation,
+            (string) $states->get(self::LIFECYCLES_DATASET)->active_generation,
+        ];
+    }
+
+    /** @return array<string,array<int,array<string,mixed>>> */
+    private function lifecycles(array $names, string $generation): array
+    {
+        $result = [];
+        foreach (array_chunk($names, 500) as $chunk) {
+            $rows = $this->connection->table('store_report_lifecycle_rows')
+                ->where('generation', $generation)
+                ->whereIn('erp_store_name', $chunk)
+                ->orderBy('erp_store_name')->orderBy('effective_at')->orderBy('id')
+                ->get(['id', 'erp_store_name', 'company_name', 'effective_at', 'expires_at']);
+
+            foreach ($rows as $row) {
+                $result[(string) $row->erp_store_name][] = [
+                    'lifecycle_id' => (int) $row->id,
+                    'company_name' => $row->company_name,
+                    'effective_at' => $row->effective_at,
+                    'expires_at' => $row->expires_at,
+                ];
+            }
+        }
+
+        return $result;
+    }
+
+    /** @return array<string,array{period:float,months:array<string,float>}> */
+    private function lifecycleSales(array $names, string $billGeneration, string $lifecycleGeneration): array
+    {
+        $result = [];
+        $month = $this->monthExpression('b.occurred_at');
+        foreach (array_chunk($names, 500) as $chunk) {
+            $placeholders = implode(',', array_fill(0, count($chunk), '?'));
+            $rows = $this->connection->select(
+                "SELECT l.id AS lifecycle_id, {$month} AS bill_month,
+                        SUM(COALESCE(b.income, 0)) AS income_total
+                 FROM store_report_lifecycle_rows AS l
+                 INNER JOIN store_report_bill_rows AS b
+                   ON b.generation = ? AND b.store_name = l.erp_store_name AND b.occurred_at IS NOT NULL
+                  AND b.occurred_at >= COALESCE(l.effective_at, '1000-01-01 00:00:00')
+                  AND b.occurred_at < COALESCE(l.expires_at, '2999-01-01 00:00:00')
+                 WHERE l.generation = ? AND l.erp_store_name IN ($placeholders)
+                 GROUP BY l.id, {$month}",
+                [$billGeneration, $lifecycleGeneration, ...$chunk],
+            );
+            $this->collectSales($result, $rows, 'lifecycle_id');
+        }
+
+        return $result;
+    }
+
+    /** @return array<string,array{period:float,months:array<string,float>}> */
+    private function fallbackSales(array $names, string $generation): array
+    {
+        $result = [];
+        $month = $this->monthExpression('occurred_at');
+        foreach (array_chunk($names, 500) as $chunk) {
+            $placeholders = implode(',', array_fill(0, count($chunk), '?'));
+            $rows = $this->connection->select(
+                "SELECT store_name, {$month} AS bill_month,
+                        SUM(COALESCE(income, 0)) AS income_total
+                 FROM store_report_bill_rows
+                 WHERE generation = ? AND store_name IN ($placeholders) AND occurred_at IS NOT NULL
+                 GROUP BY store_name, {$month}",
+                [$generation, ...$chunk],
+            );
+            $this->collectSales($result, $rows, 'store_name');
+        }
+
+        return $result;
+    }
+
+    /** @param array<string,array{period:float,months:array<string,float>}> $result */
+    private function collectSales(array &$result, array $rows, string $keyColumn): void
+    {
+        foreach ($rows as $row) {
+            $key = (string) $row->{$keyColumn};
+            $result[$key]['period'] = ($result[$key]['period'] ?? 0.0) + (float) $row->income_total;
+            $result[$key]['months'][(string) $row->bill_month] = (float) $row->income_total;
+        }
+    }
+
+    private function monthExpression(string $column): string
+    {
+        return $this->connection->getDriverName() === 'sqlite'
+            ? "strftime('%Y-%m', {$column})"
+            : "DATE_FORMAT({$column}, '%Y-%m')";
+    }
+
+    private function date(mixed $value, string $fallback): string
+    {
+        $value = trim((string) ($value ?? ''));
+        return $value === '' ? $fallback : substr($value, 0, 10);
+    }
+
+    private function status(mixed $value): ?string
+    {
+        return match ((string) $value) {
+            '0', '正常' => '开店中',
+            '3', '关闭中' => '关店中',
+            '6', '已关闭' => '关店',
+            default => $value === null || $value === '' ? null : (string) $value,
+        };
+    }
+}

modules/EcommerceFinance/Services/BusinessMirrorDataReader.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Modules\EcommerceFinance\Services;
+
+use InvalidArgumentException;
+use Modules\EcommerceFinance\Repositories\GenericBusinessMirrorRepository;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+
+/** Backend primitive: callers must retain their existing company/permission checks. */
+class BusinessMirrorDataReader
+{
+    public function __construct(
+        private readonly BusinessMirrorDatasetRegistry $datasets,
+        private readonly BusinessMirrorSchemaManager $schemas,
+        private readonly GenericBusinessMirrorRepository $mirror,
+    ) {}
+
+    public function paginate(string $key, array $filters = [], int $page = 1, int $perPage = 25): array
+    {
+        $dataset = $this->datasets->get($key);
+        if (! $this->mirror->ready($dataset)) {
+            throw new ServiceUnavailableHttpException(30, '该数据集尚未完成首次同步，请查看同步状态；页面不会临时访问上游。');
+        }
+        $columns = array_column($this->schemas->columns($dataset), 'column_name');
+        $query = $this->mirror->connection()->table($dataset->targetTable());
+        foreach ($filters as $column => $value) {
+            if (! in_array($column, $columns, true) || (! is_scalar($value) && $value !== null)) {
+                throw new InvalidArgumentException('镜像筛选字段或值无效。');
+            }
+            $query->where($column, $value);
+        }
+        $total = (clone $query)->count();
+        foreach ($dataset->keyColumns() as $column) $query->orderBy($column);
+        $page = max($page, 1);
+        $perPage = min(max($perPage, 1), 100);
+        $state = $this->mirror->state($dataset);
+        return [
+            'rows' => $query->select($columns)->offset(($page - 1) * $perPage)->limit($perPage)->get()
+                ->map(fn ($row) => (array) $row)->all(),
+            'total' => $total, 'page' => $page, 'per_page' => $perPage,
+            'last_page' => max((int) ceil($total / $perPage), 1),
+            'sync_status' => $state['status'] ?? 'unknown',
+            'last_succeeded_at' => $state['last_succeeded_at'] ?? null,
+        ];
+    }
+}

modules/EcommerceFinance/Services/BusinessMirrorDatasetRegistry.php

@@ -3,6 +3,8 @@
 namespace Modules\EcommerceFinance\Services;
 
 use InvalidArgumentException;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
 use Modules\EcommerceFinance\Contracts\BusinessMirrorDataset;
 
 class BusinessMirrorDatasetRegistry
@@ -12,7 +14,7 @@ class BusinessMirrorDatasetRegistry
     {
         $datasets = [];
 
-        foreach ((array) config('upstream_mirrors.datasets', []) as $key => $definition) {
+        foreach ($this->definitions() as $key => $definition) {
             $datasets[(string) $key] = $this->make((string) $key, (array) $definition);
         }
 
@@ -21,7 +23,7 @@ class BusinessMirrorDatasetRegistry
 
     public function get(string $key): BusinessMirrorDataset
     {
-        $definitions = (array) config('upstream_mirrors.datasets', []);
+        $definitions = $this->definitions();
         $definition = (array) ($definitions[$key] ?? []);
 
         if ($definition === []) {
@@ -31,6 +33,43 @@ class BusinessMirrorDatasetRegistry
         return $this->make($key, $definition);
     }
 
+    private function definitions(): array
+    {
+        $definitions = (array) config('upstream_mirrors.datasets', []);
+        if (Schema::hasTable('business_mirror_datasets')) {
+            foreach (DB::table('business_mirror_datasets')->get() as $row) {
+                // Existing code-owned datasets cannot be redirected by a new registration.
+                $definitions[$row->dataset_key] ??= json_decode($row->definition, true, 32, JSON_THROW_ON_ERROR);
+            }
+        }
+        return $definitions;
+    }
+
+    public function automaticInitialSyncAllowed(string $key): bool
+    {
+        return Schema::hasTable('business_mirror_datasets') && DB::table('business_mirror_datasets')
+            ->where('dataset_key', $key)->where('sync_enabled', true)->where('initial_sync_approved', true)->exists();
+    }
+
+    public function scheduled(string $key): bool
+    {
+        $definition = $this->definitions()[$key] ?? null;
+        if (! $definition || ! app(UpstreamSourceRegistry::class)->enabled($definition['source_key'])) return false;
+        if (array_key_exists($key, (array) config('upstream_mirrors.datasets', []))) return true;
+        return Schema::hasTable('business_mirror_datasets') && DB::table('business_mirror_datasets')
+            ->where('dataset_key', $key)->where('sync_enabled', true)->exists();
+    }
+
+    public function validate(string $key, array $definition): BusinessMirrorDataset
+    {
+        return $this->make($key, $definition);
+    }
+
+    public function columnSelection(string $key): ?array
+    {
+        return $this->definitions()[$key]['columns'] ?? null;
+    }
+
     private function make(string $key, array $definition): BusinessMirrorDataset
     {
         $source = trim((string) ($definition['source_key'] ?? ''));
@@ -45,17 +84,23 @@ class BusinessMirrorDatasetRegistry
         ));
         $indexColumns = array_merge(...($indexes ?: [[]]));
 
-        foreach ([$source, $schema, $object, $target, ...$keys, ...$indexColumns] as $identifier) {
+        foreach ([$source, $target] as $identifier) {
             if (preg_match('/^[A-Za-z_][A-Za-z0-9_]*$/', $identifier) !== 1) {
                 throw new InvalidArgumentException('业务镜像数据集包含不安全的标识符：' . $key);
             }
         }
 
+        foreach ([$schema, $object, ...$keys, ...$indexColumns] as $identifier) {
+            if ($identifier === '' || mb_strlen($identifier) > 128 || str_contains($identifier, "\0")) {
+                throw new InvalidArgumentException('业务镜像数据集包含无效的标识符：' . $key);
+            }
+        }
+
         if ($keys === [] || in_array([], $indexes, true) || strlen($target) > 64) {
             throw new InvalidArgumentException('业务镜像数据集缺少稳定键或目标表名过长：' . $key);
         }
 
-        if ($watermark !== '' && preg_match('/^[A-Za-z_][A-Za-z0-9_]*$/', $watermark) !== 1) {
+        if ($watermark !== '' && (mb_strlen($watermark) > 128 || str_contains($watermark, "\0"))) {
             throw new InvalidArgumentException('业务镜像数据集的增量字段不安全：' . $key);
         }
 

modules/EcommerceFinance/Services/BusinessMirrorSchemaManager.php

@@ -6,6 +6,7 @@ use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
 use Modules\EcommerceFinance\Contracts\BusinessMirrorDataset;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
 use RuntimeException;
 
 class BusinessMirrorSchemaManager
@@ -87,6 +88,13 @@ class BusinessMirrorSchemaManager
             ->map(fn (object $row): array => (array) $row)
             ->all();
 
+        $selected = app(BusinessMirrorDatasetRegistry::class)->columnSelection($dataset->key());
+        if ($selected !== null) {
+            $selected = array_map('strtolower', $selected);
+            $rows = array_values(array_filter($rows, fn (array $row): bool => in_array(strtolower($row['column_name']), $selected, true)));
+            if (count($rows) !== count($selected)) throw new RuntimeException('business_mirror_selected_column_missing:' . $dataset->key());
+        }
+
         if ($rows === []) {
             throw new RuntimeException('business_mirror_schema_catalog_missing:' . $dataset->key());
         }
@@ -121,24 +129,24 @@ class BusinessMirrorSchemaManager
         $scale = min(max((int) ($column['numeric_scale'] ?? 0), 0), min($precision, 30));
 
         $definition = match ($type) {
-            'bit' => $table->boolean($name),
+            'bit', 'boolean' => $table->boolean($name),
             'tinyint' => $table->unsignedTinyInteger($name),
             'smallint' => $table->smallInteger($name),
-            'int' => $table->integer($name),
+            'int', 'integer' => $table->integer($name),
             'bigint' => $table->bigInteger($name),
             'decimal', 'numeric', 'money', 'smallmoney' => $table->decimal($name, $precision, $scale),
-            'float', 'real' => $table->double($name),
+            'float', 'real', 'double', 'double precision' => $table->double($name),
             'date' => $table->date($name),
-            'datetime', 'datetime2', 'smalldatetime' => $table->dateTime($name, 6),
+            'datetime', 'datetime2', 'smalldatetime', 'timestamp without time zone', 'timestamp with time zone' => $table->dateTime($name, 6),
             'time' => $table->time($name, 6),
-            'uniqueidentifier' => $table->char($name, 36),
+            'uniqueidentifier', 'uuid' => $table->char($name, 36),
             'binary', 'varbinary', 'image', 'timestamp', 'rowversion' => $table->binary($name),
             // MariaDB counts every inline varchar column towards the 65,535-byte
             // row limit. Wide legacy SQL Server tables can contain dozens of
             // nvarchar columns even though each individual column looks small.
             // Keep only genuinely short values inline; TEXT is stored off-page
             // and lets the mirror preserve the complete source schema.
-            'char', 'nchar', 'varchar', 'nvarchar' => $length > 0 && $length <= 64
+            'char', 'nchar', 'varchar', 'nvarchar', 'character', 'character varying' => $length > 0 && $length <= 64
                 ? $table->string($name, $length)
                 : $table->longText($name),
             default => $table->longText($name),
@@ -157,8 +165,8 @@ class BusinessMirrorSchemaManager
             $type = strtolower((string) $column['data_type']);
             $length = (int) ($column['max_length'] ?? 0);
 
-            return ! in_array($type, ['text', 'ntext', 'xml', 'image', 'binary', 'varbinary'], true)
-                && (! in_array($type, ['char', 'nchar', 'varchar', 'nvarchar'], true) || ($length > 0 && $length <= 64));
+            return ! in_array($type, ['text', 'ntext', 'xml', 'image', 'binary', 'varbinary', 'bytea', 'json', 'jsonb', 'array', 'user-defined'], true)
+                && (! in_array($type, ['char', 'nchar', 'varchar', 'nvarchar', 'character', 'character varying'], true) || ($length > 0 && $length <= 64));
         }
 
         return false;

modules/EcommerceFinance/Services/BusinessMirrorSynchronizer.php

@@ -11,6 +11,7 @@ use Throwable;
 
 class BusinessMirrorSynchronizer
 {
+    private string $driver = 'sqlsrv';
     public function __construct(
         private readonly BusinessMirrorDatasetRegistry $datasets,
         private readonly BusinessMirrorSchemaManager $schemas,
@@ -23,10 +24,11 @@ class BusinessMirrorSynchronizer
     public function sync(string $datasetKey, bool $full = false, ?int $batchSize = null, ?int $maxBatches = null): array
     {
         $dataset = $this->datasets->get($datasetKey);
+        $this->driver = app(UpstreamSourceRegistry::class)->driver($dataset->sourceKey());
         // A long-running scheduler may have retained a timed-out PDO instance
         // from the previous dataset. Each dataset starts with a fresh upstream
         // connection so one source failure cannot poison subsequent mirrors.
-        UpstreamOdbcConnection::reset($dataset->sourceKey());
+        UpstreamConnection::reset($dataset->sourceKey());
         $state = $this->mirror->state($dataset);
 
         if (! $full && ($state['initial_completed_at'] ?? null) === null) {
@@ -60,6 +62,7 @@ class BusinessMirrorSynchronizer
         $batchSize = min(max($batchSize ?? (int) config('upstream_mirrors.table_sync.batch_size', 500), 1), 5000);
         $maxBatches = max($maxBatches ?? (int) config('upstream_mirrors.table_sync.max_batches_per_run', 2), 0);
         $batches = 0;
+        $deadline = microtime(true) + max((int) config('upstream_pipeline.sync.dataset_seconds', 8), 1);
         $rows = (int) ($state['last_upserted_rows'] ?? 0);
 
         try {
@@ -92,7 +95,7 @@ class BusinessMirrorSynchronizer
                     return $this->result($dataset, 'succeeded', $mode, $batches, $rows);
                 }
 
-                if ($maxBatches > 0 && $batches >= $maxBatches) {
+                if ($maxBatches > 0 && ($batches >= $maxBatches || microtime(true) >= $deadline)) {
                     return $this->result($dataset, 'running', $mode, $batches, $rows);
                 }
             }
@@ -120,8 +123,11 @@ class BusinessMirrorSynchronizer
         if ($mode === 'incremental' && $dataset->watermarkColumn() !== null) {
             $watermark = $this->quote($dataset->watermarkColumn());
             $where[] = $watermark . ' >= ? AND ' . $watermark . ' < ?';
-            $bindings[] = $this->sqlServerDateTime($windowStart);
-            $bindings[] = $this->sqlServerDateTime($windowEnd);
+            $timezoneAware = $this->driver === 'pgsql' && collect($columns)->contains(fn ($c) =>
+                $c['column_name'] === $dataset->watermarkColumn() && $c['data_type'] === 'timestamp with time zone'
+            );
+            $bindings[] = $timezoneAware ? $windowStart?->format('Y-m-d\TH:i:s.uP') : $this->sqlServerDateTime($windowStart);
+            $bindings[] = $timezoneAware ? $windowEnd?->format('Y-m-d\TH:i:s.uP') : $this->sqlServerDateTime($windowEnd);
         } elseif ($mode === 'incremental' && $cursor === null && $highWatermark !== []) {
             [$predicate, $values] = $this->keyset($dataset->keyColumns(), $highWatermark);
             $where[] = $predicate;
@@ -134,11 +140,12 @@ class BusinessMirrorSynchronizer
             array_push($bindings, ...$values);
         }
 
-        $sql = 'SELECT TOP (' . $limit . ') '
-            . implode(', ', array_map(fn (array $column): string => $this->selectExpression($column), $columns))
-            . ' FROM ' . $this->quote($dataset->sourceSchema()) . '.' . $this->quote($dataset->sourceObject())
+        $tail = 'FROM ' . $this->quote($dataset->sourceSchema()) . '.' . $this->quote($dataset->sourceObject())
             . ($where === [] ? '' : ' WHERE (' . implode(') AND (', $where) . ')')
             . ' ORDER BY ' . implode(', ', array_map(fn (string $name): string => $this->quote($name), $order));
+        $sql = (new UpstreamSqlDialect($this->driver))->select(
+            implode(', ', array_map(fn (array $column): string => $this->selectExpression($column), $columns)), $tail, $limit,
+        );
 
         return $this->queries->forSource($dataset->sourceKey())->select($sql, $bindings);
     }
@@ -149,6 +156,17 @@ class BusinessMirrorSynchronizer
         $name = (string) $column['column_name'];
         $quoted = $this->quote($name);
 
+        if ($this->driver !== 'sqlsrv') {
+            if ($this->driver === 'pgsql' && ($column['data_type'] ?? '') === 'timestamp with time zone') {
+                // Store timezone-aware PostgreSQL instants as UTC in the shared mirror.
+                return "to_char({$quoted} AT TIME ZONE 'UTC', 'YYYY-MM-DD\"T\"HH24:MI:SS.US') AS {$quoted}";
+            }
+            if ($this->driver === 'pgsql' && ($column['data_type'] ?? '') === 'bytea') {
+                return "encode({$quoted}, 'hex') AS {$quoted}";
+            }
+            return $quoted;
+        }
+
         // FreeTDS may return SQL Server date values using the connection locale
         // (for example "Jan 1 2026"). Convert temporal columns at the source so
         // every mirror receives deterministic ISO values that MariaDB accepts.
@@ -244,7 +262,7 @@ class BusinessMirrorSynchronizer
                 $type = $types[strtolower((string) $name)] ?? '';
                 if ($type === 'date') {
                     $row[$name] = substr($value, 0, 10);
-                } elseif (in_array($type, ['datetime', 'datetime2', 'smalldatetime'], true)) {
+                } elseif (in_array($type, ['datetime', 'datetime2', 'smalldatetime', 'timestamp without time zone', 'timestamp with time zone'], true)) {
                     $row[$name] = preg_replace('/(\.\d{6})\d+/', '$1', str_replace('T', ' ', $value));
                 } elseif (in_array($type, ['char', 'nchar', 'varchar', 'nvarchar', 'text', 'ntext', 'xml'], true)) {
                     $row[$name] = $this->normalizeText($value);
@@ -271,11 +289,7 @@ class BusinessMirrorSynchronizer
 
     private function quote(string $identifier): string
     {
-        if (preg_match('/^[A-Za-z_][A-Za-z0-9_]*$/', $identifier) !== 1) {
-            throw new RuntimeException('business_mirror_invalid_identifier');
-        }
-
-        return '[' . $identifier . ']';
+        return (new UpstreamSqlDialect($this->driver))->quote($identifier);
     }
 
     private function cursorValue(array $cursor, string $column): mixed

modules/EcommerceFinance/Services/StoreReportDataImporter.php

@@ -0,0 +1,344 @@
+<?php
+
+namespace Modules\EcommerceFinance\Services;
+
+use DateTimeInterface;
+use Illuminate\Database\ConnectionInterface;
+use Illuminate\Database\DatabaseManager;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Str;
+use Modules\EcommerceFinance\Repositories\StoreReportRepository;
+use PhpOffice\PhpSpreadsheet\IOFactory;
+use PhpOffice\PhpSpreadsheet\Shared\Date as ExcelDate;
+use RuntimeException;
+use Throwable;
+
+class StoreReportDataImporter
+{
+    private const PLATFORMS = [
+        'dewu' => ['label' => '得物', 'markers' => ['得物']],
+        'douyin' => ['label' => '抖音', 'markers' => ['头条放心购', '抖音']],
+        'taobao' => ['label' => '淘系', 'markers' => ['淘系']],
+        'jd' => ['label' => '京东', 'markers' => ['京东商城', '京东']],
+        'pinduoduo' => ['label' => '拼多多', 'markers' => ['拼多多']],
+    ];
+
+    private const TIME_HEADERS = [
+        'dewu' => ['结算时间', '支付/退款时间', '发生时间'],
+        'douyin' => ['结算时间', '发生时间'],
+        'taobao' => ['结算时间', '入账时间', '发生时间'],
+        'jd' => ['结算时间', '费用结算时间', '发生时间'],
+        'pinduoduo' => ['结算时间', '发生时间'],
+    ];
+
+    private readonly ConnectionInterface $connection;
+
+    public function __construct(DatabaseManager $databases)
+    {
+        $this->connection = $databases->connection(
+            (string) config('upstream_mirrors.connection', 'business_mirror'),
+        );
+    }
+
+    /** @return array{dataset_key:string,row_count:int,generation:string} */
+    public function importBills(string $path, int $batchSize = 500): array
+    {
+        $files = $this->xlsxFiles($path);
+        $generation = (string) Str::uuid();
+        $dataset = StoreReportRepository::BILLS_DATASET;
+        $this->begin($dataset, $generation);
+        $batchSize = min(max($batchSize, 100), 2000);
+        $batch = [];
+        $count = 0;
+
+        try {
+            foreach ($files as $file) {
+                [$platform, $label] = $this->platform($file);
+                foreach ($this->spreadsheetRows($file) as [$headers, $values]) {
+                    $storeName = $this->text($this->value($headers, $values, ['店铺', '店铺名称']));
+                    $recordCode = $this->text($this->value($headers, $values, ['记录编码', '账单流水号', '业务单号']));
+                    if ($storeName === null || $recordCode === null) {
+                        continue;
+                    }
+
+                    $occurredAt = $this->dateTime($this->value($headers, $values, self::TIME_HEADERS[$platform]));
+                    $income = $this->money($this->value($headers, $values, ['收入金额', '收入']));
+                    $expense = $this->money($this->value($headers, $values, ['支出金额', '支出']));
+                    $billItem = $this->text($this->value($headers, $values, ['账单项目', '摘要']));
+                    $business = [$platform, $recordCode, $storeName, $occurredAt, $income, $expense, $billItem];
+                    $batch[] = [
+                        'generation' => $generation,
+                        'platform' => $platform,
+                        'platform_label' => $label,
+                        'store_name' => $storeName,
+                        'occurred_at' => $occurredAt,
+                        'income' => $income,
+                        'expense' => $expense,
+                        'bill_item' => $billItem,
+                        'record_code' => $recordCode,
+                        'source_file' => basename($file),
+                        'row_hash' => hash('sha256', json_encode($business, JSON_UNESCAPED_UNICODE)),
+                        'imported_at' => now(),
+                    ];
+                    if (count($batch) >= $batchSize) {
+                        $count += $this->storeBills($batch);
+                        $batch = [];
+                    }
+                }
+            }
+            if ($batch !== []) {
+                $count += $this->storeBills($batch);
+            }
+            $count = (int) $this->connection->table('store_report_bill_rows')
+                ->where('generation', $generation)->count();
+            if ($count === 0) {
+                throw new RuntimeException('平台账单文件中没有可导入的数据。');
+            }
+
+            $this->activate($dataset, $generation, $count, $files);
+        } catch (Throwable $exception) {
+            $this->fail($dataset, $generation, 'store_report_bill_rows', $exception);
+            throw $exception;
+        }
+
+        return ['dataset_key' => $dataset, 'row_count' => $count, 'generation' => $generation];
+    }
+
+    /** @return array{dataset_key:string,row_count:int,generation:string} */
+    public function importLifecycles(string $path, int $batchSize = 500): array
+    {
+        $files = $this->xlsxFiles($path);
+        if (count($files) !== 1) {
+            throw new RuntimeException('店铺生命周期导入只接受一个 XLSX 文件。');
+        }
+        $file = $files[0];
+        $generation = (string) Str::uuid();
+        $dataset = StoreReportRepository::LIFECYCLES_DATASET;
+        $this->begin($dataset, $generation);
+        $batchSize = min(max($batchSize, 100), 2000);
+        $batch = [];
+        $count = 0;
+
+        try {
+            foreach ($this->spreadsheetRows($file) as [$headers, $values]) {
+                $storeName = $this->text($this->value($headers, $values, ['ERP系统店铺名称']));
+                if ($storeName === null) {
+                    continue;
+                }
+                $companyName = $this->text($this->value($headers, $values, ['公司名称']));
+                $effectiveAt = $this->dateTime($this->value($headers, $values, ['生效时间']));
+                $expiresAt = $this->dateTime($this->value($headers, $values, ['失效时间']), true);
+                $business = [$storeName, $companyName, $effectiveAt, $expiresAt];
+                $batch[] = [
+                    'generation' => $generation,
+                    'business_key' => hash('sha256', implode('|', [$storeName, $effectiveAt ?? '', $expiresAt ?? ''])),
+                    'erp_store_name' => $storeName,
+                    'company_name' => $companyName,
+                    'effective_at' => $effectiveAt,
+                    'expires_at' => $expiresAt,
+                    'source_file' => basename($file),
+                    'row_hash' => hash('sha256', json_encode($business, JSON_UNESCAPED_UNICODE)),
+                    'imported_at' => now(),
+                ];
+                if (count($batch) >= $batchSize) {
+                    $count += $this->storeLifecycles($batch);
+                    $batch = [];
+                }
+            }
+            if ($batch !== []) {
+                $count += $this->storeLifecycles($batch);
+            }
+            $count = (int) $this->connection->table('store_report_lifecycle_rows')
+                ->where('generation', $generation)->count();
+            if ($count === 0) {
+                throw new RuntimeException('店铺生命周期文件中没有可导入的数据。');
+            }
+
+            $this->activate($dataset, $generation, $count, [$file]);
+        } catch (Throwable $exception) {
+            $this->fail($dataset, $generation, 'store_report_lifecycle_rows', $exception);
+            throw $exception;
+        }
+
+        return ['dataset_key' => $dataset, 'row_count' => $count, 'generation' => $generation];
+    }
+
+    /** @return array<int,string> */
+    private function xlsxFiles(string $path): array
+    {
+        $real = realpath($path);
+        if ($real === false) {
+            throw new RuntimeException('导入路径不存在。');
+        }
+        $files = is_dir($real) ? glob($real . DIRECTORY_SEPARATOR . '*.xlsx') : [$real];
+        $files = array_values(array_filter($files ?: [], static fn (string $file): bool =>
+            is_file($file) && is_readable($file) && ! str_starts_with(basename($file), '~$')
+        ));
+        sort($files);
+        if ($files === []) {
+            throw new RuntimeException('导入路径中没有可读的 XLSX 文件。');
+        }
+        return $files;
+    }
+
+    /** @return array{0:string,1:string} */
+    private function platform(string $file): array
+    {
+        foreach (self::PLATFORMS as $key => $definition) {
+            foreach ($definition['markers'] as $marker) {
+                if (str_contains(basename($file), $marker)) {
+                    return [$key, $definition['label']];
+                }
+            }
+        }
+        throw new RuntimeException('无法从文件名识别账单平台：' . basename($file));
+    }
+
+    /** @return iterable<array{0:array<string,int>,1:array<int,mixed>}> */
+    private function spreadsheetRows(string $file): iterable
+    {
+        $reader = IOFactory::createReaderForFile($file);
+        $reader->setReadDataOnly(true);
+        $spreadsheet = $reader->load($file);
+        try {
+            foreach ($spreadsheet->getWorksheetIterator() as $worksheet) {
+                $rows = $worksheet->toArray(null, true, true, false);
+                $headerRow = array_shift($rows);
+                if (! is_array($headerRow)) {
+                    continue;
+                }
+                $headers = [];
+                foreach ($headerRow as $index => $header) {
+                    $name = $this->text($header);
+                    if ($name !== null) {
+                        $headers[$name] = $index;
+                    }
+                }
+                foreach ($rows as $values) {
+                    if (array_filter($values, static fn (mixed $value): bool => $value !== null && $value !== '') === []) {
+                        continue;
+                    }
+                    yield [$headers, $values];
+                }
+            }
+        } finally {
+            $spreadsheet->disconnectWorksheets();
+            unset($spreadsheet);
+        }
+    }
+
+    private function value(array $headers, array $values, array $candidates): mixed
+    {
+        foreach ($candidates as $candidate) {
+            if (array_key_exists($candidate, $headers)) {
+                $value = $values[$headers[$candidate]] ?? null;
+                if ($value !== null && $value !== '') {
+                    return $value;
+                }
+            }
+        }
+        return null;
+    }
+
+    private function text(mixed $value): ?string
+    {
+        $value = trim((string) ($value ?? ''));
+        return $value === '' ? null : mb_substr($value, 0, 255);
+    }
+
+    private function money(mixed $value): float
+    {
+        $normalized = str_replace([',', '￥', '¥', ' '], '', (string) ($value ?? '0'));
+        if (! is_numeric($normalized)) {
+            throw new RuntimeException('账单金额无法解析。');
+        }
+        return round((float) $normalized, 4);
+    }
+
+    private function dateTime(mixed $value, bool $allowOpenEnded = false): ?string
+    {
+        if ($value === null || $value === '') {
+            return null;
+        }
+        if ($allowOpenEnded && in_array(trim((string) $value), ['存续中', '至今', '长期', '无'], true)) {
+            return null;
+        }
+        if ($value instanceof DateTimeInterface) {
+            return $value->format('Y-m-d H:i:s');
+        }
+        if (is_numeric($value)) {
+            return ExcelDate::excelToDateTimeObject((float) $value)->format('Y-m-d H:i:s');
+        }
+        try {
+            return Carbon::parse(str_replace('/', '-', trim((string) $value)))->format('Y-m-d H:i:s');
+        } catch (Throwable) {
+            throw new RuntimeException('账单或生命周期时间无法解析。');
+        }
+    }
+
+    private function begin(string $dataset, string $generation): void
+    {
+        $this->assertSchemaReady();
+        $now = now();
+        $this->connection->table('store_report_import_states')->insertOrIgnore([
+            'dataset_key' => $dataset, 'status' => 'pending', 'row_count' => 0,
+            'created_at' => $now, 'updated_at' => $now,
+        ]);
+        $this->connection->table('store_report_import_states')->where('dataset_key', $dataset)->update([
+            'status' => 'running', 'pending_generation' => $generation,
+            'last_attempted_at' => $now, 'last_error_code' => null, 'updated_at' => $now,
+        ]);
+    }
+
+    private function assertSchemaReady(): void
+    {
+        $schema = Schema::connection($this->connection->getName());
+        foreach (['store_report_import_states', 'store_report_bill_rows', 'store_report_lifecycle_rows'] as $table) {
+            if (! $schema->hasTable($table)) {
+                throw new RuntimeException('店铺维度报表共享镜像尚未完成迁移：' . $table);
+            }
+        }
+    }
+
+    private function storeBills(array $rows): int
+    {
+        $this->connection->table('store_report_bill_rows')->upsert(
+            $rows, ['generation', 'platform', 'record_code'],
+            ['platform_label', 'store_name', 'occurred_at', 'income', 'expense', 'bill_item', 'source_file', 'row_hash', 'imported_at'],
+        );
+        return count($rows);
+    }
+
+    private function storeLifecycles(array $rows): int
+    {
+        $this->connection->table('store_report_lifecycle_rows')->upsert(
+            $rows, ['generation', 'business_key'],
+            ['erp_store_name', 'company_name', 'effective_at', 'expires_at', 'source_file', 'row_hash', 'imported_at'],
+        );
+        return count($rows);
+    }
+
+    private function activate(string $dataset, string $generation, int $count, array $files): void
+    {
+        $hashes = array_map(static fn (string $file): string => hash_file('sha256', $file) ?: '', $files);
+        $now = now();
+        $this->connection->transaction(function () use ($dataset, $generation, $count, $files, $hashes, $now): void {
+            $this->connection->table('store_report_import_states')->where('dataset_key', $dataset)->update([
+                'status' => 'succeeded', 'active_generation' => $generation, 'pending_generation' => null,
+                'row_count' => $count, 'source_sha256' => hash('sha256', implode('|', $hashes)),
+                'source_files_json' => json_encode(array_map('basename', $files), JSON_UNESCAPED_UNICODE),
+                'last_succeeded_at' => $now, 'last_error_code' => null, 'updated_at' => $now,
+            ]);
+        });
+    }
+
+    private function fail(string $dataset, string $generation, string $table, Throwable $exception): void
+    {
+        $this->connection->table($table)->where('generation', $generation)->delete();
+        $this->connection->table('store_report_import_states')->where('dataset_key', $dataset)->update([
+            'status' => 'failed', 'pending_generation' => null,
+            'last_error_code' => class_basename($exception), 'updated_at' => now(),
+        ]);
+    }
+}

modules/EcommerceFinance/Services/UpstreamConnection.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace Modules\EcommerceFinance\Services;
+
+use PDO;
+use PDOException;
+use SensitiveParameter;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+
+class UpstreamConnection
+{
+    /** @var array<string,PDO> */
+    private static array $native = [];
+
+    public static function get(string $source): PDO
+    {
+        $registry = app(UpstreamSourceRegistry::class);
+        if ($registry->driver($source) === 'sqlsrv') {
+            return UpstreamOdbcConnection::get($source);
+        }
+        if (! $registry->enabled($source)) {
+            throw new ServiceUnavailableHttpException(30, '该数据源尚未启用。');
+        }
+        return self::$native[$source] ??= self::openNative($registry->driver($source), $registry->value($source, 'connection', []));
+    }
+
+    public static function reset(?string $source = null): void
+    {
+        if ($source === null) self::$native = [];
+        else unset(self::$native[$source]);
+        UpstreamOdbcConnection::reset($source);
+    }
+
+    public static function openNative(string $driver, #[SensitiveParameter] array $config): PDO
+    {
+        if (! in_array($driver, ['pgsql', 'mysql'], true) || ! in_array($driver, PDO::getAvailableDrivers(), true)) {
+            throw new ServiceUnavailableHttpException(30, '应用缺少该数据库类型的驱动，请更新应用镜像。');
+        }
+        $timeout = min(max((int) ($config['connect_timeout'] ?? 5), 1), 30);
+        $seconds = min(max((int) ($config['query_timeout'] ?? 15), 1), 15);
+        $options = [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_PERSISTENT => false, PDO::ATTR_TIMEOUT => $timeout];
+        $host = (string) $config['host'];
+        $database = (string) $config['database'];
+        if (preg_match('/[;\x00-\x1F]/', $host . $database)) {
+            throw new ServiceUnavailableHttpException(30, '主机或数据库名称包含不支持的字符。');
+        }
+        $port = min(max((int) $config['port'], 1), 65535);
+        if ($driver === 'pgsql') {
+            $quote = static fn (string $s): string => "'" . str_replace(['\\', "'"], ['\\\\', "\\'"], $s) . "'";
+            $dsn = 'pgsql:host=' . $quote($host) . ';port=' . $port . ';dbname=' . $quote($database)
+                . ';sslmode=require;connect_timeout=' . $timeout
+                . ";options='-c default_transaction_read_only=on -c statement_timeout=" . ($seconds * 1000) . "'";
+        } else {
+            $dsn = "mysql:host={$host};port={$port};dbname={$database};charset=utf8mb4";
+            $options[PDO::MYSQL_ATTR_SSL_CIPHER] = 'DEFAULT';
+            $options[PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = false;
+        }
+        try {
+            $pdo = new PDO($dsn, (string) $config['username'], (string) $config['password'], $options);
+            if ($driver === 'mysql') {
+                $tls = $pdo->query("SHOW SESSION STATUS LIKE 'Ssl_cipher'")->fetch(PDO::FETCH_NUM);
+                if (empty($tls[1])) throw new ServiceUnavailableHttpException(30, '上游数据库未建立 TLS 加密连接。');
+                $pdo->exec('SET SESSION TRANSACTION READ ONLY');
+                $pdo->exec(str_contains($pdo->getAttribute(PDO::ATTR_SERVER_VERSION), 'MariaDB')
+                    ? 'SET SESSION max_statement_time=' . $seconds
+                    : 'SET SESSION MAX_EXECUTION_TIME=' . ($seconds * 1000));
+            }
+            return $pdo;
+        } catch (PDOException) {
+            throw new ServiceUnavailableHttpException(30, '上游只读连接失败，请检查账号、权限、网络和 TLS 配置。');
+        }
+    }
+}

modules/EcommerceFinance/Services/UpstreamDatabaseProbe.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Modules\EcommerceFinance\Services;
+
+use PDO;
+use PDOException;
+use SensitiveParameter;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+
+/** The test button and business readers share one driver implementation. */
+class UpstreamDatabaseProbe
+{
+    public function probe(string $driver, #[SensitiveParameter] array $connection, string $label): void
+    {
+        if ($driver === 'sqlsrv') {
+            UpstreamOdbcConnection::probeConfiguration($connection, $label);
+            return;
+        }
+        if (! in_array($driver, ['pgsql', 'mysql'], true)) {
+            throw new ServiceUnavailableHttpException(30, '不支持此数据库类型。');
+        }
+        try {
+            $pdo = $this->connect($driver, $connection);
+            $statement = $pdo->query('SELECT 1');
+            if ($statement === false || (int) $statement->fetchColumn() !== 1) {
+                throw new ServiceUnavailableHttpException(30, '只读测试未返回预期结果。');
+            }
+            $statement->closeCursor();
+        } catch (PDOException) {
+            throw new ServiceUnavailableHttpException(30, '上游只读连接失败，请检查账号、权限、网络和 TLS 配置。');
+        }
+    }
+
+    protected function connect(string $driver, #[SensitiveParameter] array $connection): PDO
+    {
+        return UpstreamConnection::openNative($driver, $connection);
+    }
+}

modules/EcommerceFinance/Services/UpstreamReadOnlyQuery.php

@@ -27,7 +27,7 @@ class UpstreamReadOnlyQuery
     {
         self::assertReadOnlySql($sql);
 
-        $statement = UpstreamOdbcConnection::get($this->source)->prepare($sql);
+        $statement = UpstreamConnection::get($this->source)->prepare($sql);
         $statement->execute($bindings);
 
         return $statement->fetchAll(PDO::FETCH_ASSOC);
@@ -45,7 +45,7 @@ class UpstreamReadOnlyQuery
     {
         self::assertReadOnlySql($sql);
 
-        $statement = UpstreamOdbcConnection::get($this->source)->prepare($sql);
+        $statement = UpstreamConnection::get($this->source)->prepare($sql);
         $statement->execute($bindings);
 
         return $statement->fetchColumn();
@@ -68,6 +68,7 @@ class UpstreamReadOnlyQuery
         $inspect = preg_replace("/'(?:''|[^'])*'/s", "''", $sql) ?? $sql;
         $inspect = preg_replace('/\[(?:\]\]|[^\]])*\]/s', '[]', $inspect) ?? $inspect;
         $inspect = preg_replace('/"(?:""|[^"])*"/s', '""', $inspect) ?? $inspect;
+        $inspect = preg_replace('/`(?:``|[^`])*`/s', '``', $inspect) ?? $inspect;
         $inspect = strtoupper(ltrim($inspect));
 
         if (preg_match('/^(SELECT|WITH)\b/', $inspect) !== 1) {
@@ -76,7 +77,7 @@ class UpstreamReadOnlyQuery
 
         $forbidden = '/\b(?:INSERT|UPDATE|DELETE|MERGE|DROP|ALTER|CREATE|TRUNCATE|EXEC|EXECUTE|'
             . 'GRANT|REVOKE|DENY|BACKUP|RESTORE|DBCC|BULK|OPENROWSET|OPENDATASOURCE|INTO|'
-            . 'WAITFOR|KILL|SHUTDOWN)\b|\bNEXT\s+VALUE\s+FOR\b/i';
+            . 'WAITFOR|KILL|SHUTDOWN|SET_CONFIG|NEXTVAL|SETVAL|SLEEP|BENCHMARK|GET_LOCK|RELEASE_LOCK|LOAD_FILE|PG_SLEEP)\b|\bNEXT\s+VALUE\s+FOR\b/i';
 
         if (preg_match($forbidden, $inspect) === 1) {
             throw new InvalidArgumentException('上游查询包含禁止的写入或高风险语法。');

modules/EcommerceFinance/Services/UpstreamSchemaCatalogSynchronizer.php

@@ -7,7 +7,7 @@ use Illuminate\Support\Facades\Schema;
 use RuntimeException;
 
 /**
- * 将上游 SQL Server 的表、视图和字段结构同步到共享系统数据库。
+ * 将已支持类型的上游表、视图和字段结构同步到共享系统数据库。
  *
  * 这里只读取 INFORMATION_SCHEMA 元数据，不读取业务行，也不保存连接资料。
  * 获取完整结果成功后才替换单个来源的旧目录，避免网络故障清空现有字典。
@@ -28,25 +28,15 @@ class UpstreamSchemaCatalogSynchronizer
             throw new RuntimeException('该上游数据库尚未启用。');
         }
 
-        $rows = $this->queries->forSource($source)->select(
-            "SELECT
-                c.TABLE_SCHEMA AS schema_name,
-                c.TABLE_NAME AS object_name,
-                CASE WHEN t.TABLE_TYPE = 'VIEW' THEN 'view' ELSE 'table' END AS object_type,
-                c.COLUMN_NAME AS column_name,
-                c.ORDINAL_POSITION AS ordinal_position,
-                c.DATA_TYPE AS data_type,
-                c.CHARACTER_MAXIMUM_LENGTH AS max_length,
-                c.NUMERIC_PRECISION AS numeric_precision,
-                c.NUMERIC_SCALE AS numeric_scale,
-                c.IS_NULLABLE AS is_nullable
-            FROM INFORMATION_SCHEMA.COLUMNS c
-            INNER JOIN INFORMATION_SCHEMA.TABLES t
-                ON t.TABLE_SCHEMA = c.TABLE_SCHEMA
-                AND t.TABLE_NAME = c.TABLE_NAME
-            WHERE c.TABLE_SCHEMA NOT IN ('sys', 'INFORMATION_SCHEMA')
-            ORDER BY c.TABLE_SCHEMA, c.TABLE_NAME, c.ORDINAL_POSITION"
-        );
+        $driver = $this->sources->driver($source);
+        $rows = $this->queries->forSource($source)->select((new UpstreamSqlDialect($driver))->catalogSql());
+        if ($driver === 'mysql') {
+            foreach ($rows as &$row) {
+                // SQL Server timestamp is binary; MySQL timestamp is temporal.
+                if (strtolower($row['data_type'] ?? '') === 'timestamp') $row['data_type'] = 'datetime';
+            }
+            unset($row);
+        }
 
         if ($rows === []) {
             throw new RuntimeException('上游数据库没有返回可用的表字段目录。');

modules/EcommerceFinance/Services/UpstreamSourceRegistry.php

@@ -28,7 +28,11 @@ class UpstreamSourceRegistry
         $definition = config('upstreams.sources.' . $source);
 
         if (! is_array($definition)) {
-            throw new InvalidArgumentException('未登记的上游数据源：' . $source);
+            $connection = $this->storedConfiguration->find($source);
+            if ($connection === null) {
+                throw new InvalidArgumentException('未登记的上游数据源：' . $source);
+            }
+            $definition = ['label' => $connection->name, 'config' => 'upstream_pipeline.defaults'];
         }
 
         $configKey = trim((string) ($definition['config'] ?? ''));
@@ -77,6 +81,25 @@ class UpstreamSourceRegistry
         return (bool) $this->value($source, 'enabled', false);
     }
 
+    public function driver(string $source): string
+    {
+        $definition = $this->definition($source);
+        $default = config($definition['config'] . '.connection.driver', 'sqlsrv');
+        return (string) (($this->usesLocalConfiguration()
+            ? $default : $this->storedConfiguration->value($source, 'connection.driver', $default)) ?: 'sqlsrv');
+    }
+
+    /** @return array<string,array> */
+    public function all(): array
+    {
+        $keys = array_unique(array_merge(array_keys((array) config('upstreams.sources', [])), array_keys($this->storedConfiguration->all())));
+        $definitions = [];
+        foreach ($keys as $key) {
+            $definitions[$key] = $this->definition($key);
+        }
+        return $definitions;
+    }
+
     private function usesLocalConfiguration(): bool
     {
         return (bool) config('upstreams.local_configuration.enabled', false);
@@ -85,6 +108,7 @@ class UpstreamSourceRegistry
     private function connection(string $source, array $configured): array
     {
         $fields = array_values(array_unique(array_merge(array_keys($configured), [
+            'driver',
             'host',
             'port',
             'database',

modules/EcommerceFinance/Services/UpstreamSqlDialect.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Modules\EcommerceFinance\Services;
+
+use InvalidArgumentException;
+
+class UpstreamSqlDialect
+{
+    public function __construct(public readonly string $driver)
+    {
+        if (! in_array($driver, ['sqlsrv', 'pgsql', 'mysql'], true)) {
+            throw new InvalidArgumentException('不支持的上游数据库类型。');
+        }
+    }
+
+    public function quote(string $identifier): string
+    {
+        if ($identifier === '' || str_contains($identifier, "\0")) throw new InvalidArgumentException('无效的数据库标识符。');
+        return match ($this->driver) {
+            'pgsql' => '"' . str_replace('"', '""', $identifier) . '"',
+            'mysql' => '`' . str_replace('`', '``', $identifier) . '`',
+            default => '[' . str_replace(']', ']]', $identifier) . ']',
+        };
+    }
+
+    public function select(string $columns, string $tail, int $limit): string
+    {
+        $limit = min(max($limit, 1), 5000);
+        return $this->driver === 'sqlsrv'
+            ? 'SELECT TOP (' . $limit . ') ' . $columns . ' ' . $tail
+            : 'SELECT ' . $columns . ' ' . $tail . ' LIMIT ' . $limit;
+    }
+
+    public function catalogSql(): string
+    {
+        // Same normalized catalog shape for all engines; MySQL never enumerates other databases.
+        $schema = $this->driver === 'sqlsrv' ? 'INFORMATION_SCHEMA' : 'information_schema';
+        $sql = "SELECT c.table_schema AS schema_name, c.table_name AS object_name,
+            CASE WHEN t.table_type = 'VIEW' THEN 'view' ELSE 'table' END AS object_type,
+            c.column_name AS column_name, c.ordinal_position AS ordinal_position,
+            c.data_type AS data_type, c.character_maximum_length AS max_length,
+            c.numeric_precision AS numeric_precision, c.numeric_scale AS numeric_scale,
+            c.is_nullable AS is_nullable
+            FROM {$schema}." . ($this->driver === 'sqlsrv' ? 'COLUMNS' : 'columns') . " c
+            INNER JOIN {$schema}." . ($this->driver === 'sqlsrv' ? 'TABLES' : 'tables') . " t
+              ON t.table_schema = c.table_schema AND t.table_name = c.table_name
+            WHERE c.table_schema NOT IN ('sys', 'INFORMATION_SCHEMA', 'information_schema', 'pg_catalog', 'mysql', 'performance_schema')";
+        if ($this->driver === 'mysql') $sql .= ' AND c.table_schema = DATABASE()';
+        $sql .= ' ORDER BY c.table_schema, c.table_name, c.ordinal_position';
+        if ($this->driver === 'sqlsrv') {
+            $sql = preg_replace_callback('/\b([ct])\.([a-z_]+)\b/', fn ($m) => $m[1] . '.' . strtoupper($m[2]), $sql);
+        }
+        return $sql;
+    }
+}

modules/EcommerceFinance/Services/UpstreamStoredConfiguration.php

@@ -42,10 +42,13 @@ class UpstreamStoredConfiguration
             return $this->connections[$source] = null;
         }
 
-        $this->connections[$source] = DatabaseConnection::query()
-            ->where('company_id', self::SYSTEM_COMPANY_ID)
-            ->where('source_key', $source)
-            ->first();
+        $query = DatabaseConnection::query()->where('company_id', self::SYSTEM_COMPANY_ID);
+        if (preg_match('/^database_([1-9][0-9]*)$/', $source, $matches)) {
+            $query->where('id', $matches[1])->whereNull('source_key');
+        } else {
+            $query->where('source_key', $source);
+        }
+        $this->connections[$source] = $query->first();
 
         return $this->connections[$source];
     }
@@ -55,6 +58,16 @@ class UpstreamStoredConfiguration
         unset($this->connections[$source]);
     }
 
+    /** @return array<string,DatabaseConnection> */
+    public function all(): array
+    {
+        if (! $this->enabled() || ! Schema::hasTable('system_database_connections')) {
+            return [];
+        }
+        return DatabaseConnection::query()->where('company_id', self::SYSTEM_COMPANY_ID)
+            ->get()->keyBy(fn (DatabaseConnection $row) => $row->sourceIdentifier())->all();
+    }
+
     public function value(string $source, string $path, mixed $default = null): mixed
     {
         $connection = $this->find($source);
@@ -68,6 +81,7 @@ class UpstreamStoredConfiguration
             'allowed_scopes' => $connection->allowed_scopes ?? [],
             'connection' => $this->connection($connection, $default),
             'connection.host' => $connection->host,
+            'connection.driver' => $connection->driver,
             'connection.port' => $connection->port,
             'connection.database' => $connection->database_name,
             'connection.username' => $connection->username,
@@ -85,6 +99,7 @@ class UpstreamStoredConfiguration
         $configured = is_array($default) ? $default : [];
 
         return array_replace($configured, [
+            'driver' => $connection->driver,
             'host' => $connection->host,
             'port' => $connection->port,
             'database' => $connection->database_name,

resources/views/business/pages/partials/directory-table.blade.php

@@ -1,6 +1,15 @@
 @php
     $directoryRows = $rows ?? collect();
     $directoryFields = $directory['fields'] ?? [];
+    $directoryFields = collect($directoryFields)->flatMap(function (array $field): array {
+        if ($field['name'] !== 'recent_three_month_sales') {
+            return [$field];
+        }
+        return array_map(static function (int $monthsAgo): array {
+            $month = now()->startOfMonth()->subMonthsNoOverflow($monthsAgo);
+            return ['name' => $month->format('sales_Y_m'), 'label' => $month->format('n月销量'), 'kind' => 'number'];
+        }, range(3, 1));
+    })->all();
     $directoryIsPaginated = is_object($directoryRows) && method_exists($directoryRows, 'total');
     $directoryTotal = $directoryIsPaginated ? $directoryRows->total() : (is_countable($directoryRows) ? count($directoryRows) : 0);
     $directoryCurrentPage = $directoryIsPaginated ? $directoryRows->currentPage() : 1;
@@ -279,7 +288,7 @@
                             <td colspan="{{ count($directoryFields) + 1 }}">
                                 <div class="directory-table-empty">
                                     <span class="material-icons-outlined" aria-hidden="true">inbox</span>
-                                    <span>{{ $directory['empty'] ?? '尚未同步数据。' }}</span>
+                                    <span>{{ !empty($upstreamError) ? '资料暂时无法读取，请按上方提示检查连接；这不代表业务数据为 0。' : ($directory['empty'] ?? '尚未同步数据。') }}</span>
                                 </div>
                             </td>
                         </tr>
@@ -288,7 +297,7 @@
             </table>
         </div>
 
-        @if ($directoryIsPaginated)
+        @if ($directoryIsPaginated && empty($upstreamError))
             <footer class="directory-table-pagination">
                 <span>共 {{ $directoryTotal }} 条 · 第 {{ $directoryCurrentPage }} / {{ $directoryLastPage }} 页</span>
                 <span>

resources/views/business/pages/partials/prototype-page.blade.php

@@ -9,96 +9,63 @@
     $definitions = [
         'overview' => [
             'title' => '经营总览', 'description' => '跨主体经营、风险与任务的当日视图',
-            'summary' => [['正常经营店铺', '127'], ['活跃公司主体', '36'], ['待处理预警', '12'], ['今日待办', '8']],
             'columns' => ['指标', '当前值', '变化', '状态'],
-            'rows' => [['正常经营店铺', '127', '+6.2%', '正常'], ['活跃公司主体', '36', '+2', '正常'], ['待处理预警', '12', '-3', '关注']],
         ],
         'warnings' => [
             'title' => '预警页面', 'description' => '集中查看经营、税务、人员与资质风险',
             'columns' => ['预警编号', '风险等级', '类型', '关联对象', '影响金额', '当前状态'],
-            'rows' => [['WARN-202608-0012', 'P0', '主体归属', '抖音-源木家居专营店', '¥96,225', '未处理'], ['WARN-202608-0010', 'P1', '经营风险', '青岛哲晖义商贸有限公司', '¥3,420,800', '处理中'], ['WARN-202608-0009', 'P2', '店铺续签', '天猫-沐森家居旗舰店', '-', '未处理']],
         ],
         'tasks' => [
             'title' => '待办事项', 'description' => '跟进任务节点、责任人与处理时限',
             'columns' => ['待办编号', '业务类型', '关联对象', '任务内容', '优先级', '截止日期', '状态'],
-            'rows' => [['TASK-260826-032', '主体变更', '抖音-源木家居专营店', '补录店铺有效主体并复核销量', '紧急', '2026-08-31', '待处理'], ['TASK-260826-029', '店铺变更', '京东-柯诺苏家具旗舰店', '提交京东店铺主体变更材料', '高', '2026-09-01', '进行中']],
         ],
         'profit-report' => [
             'title' => '公司利润报表', 'description' => '查看公司主体利润数据',
             'columns' => ['公司主体', '关联店铺', '本月收入', '本月成本', '本月利润', '利润率'],
-            'rows' => [],
         ],
         'asset-report' => [
             'title' => '公司资产报表', 'description' => '查看公司主体资产数据',
             'columns' => ['公司主体', '银行账户', '店铺资产', '保证金', '资产合计', '数据状态'],
-            'rows' => [],
         ],
         'people-inventory' => [
             'title' => '人员盘点表',
             'description' => '盘点法人、股东、监事及开票员任职',
             'columns' => ['人员名称', '花名', '职位', '标签', '税务局账号', '税务局密码', '部门', '部门负责人', '身份证号码', '实名手机号', '电话卡保管人', '身份证地址', '公司类型', '合计担任公司数量', '保留担任公司数量', '可担任公司数量'],
-            'summary' => [['人员总数', '48'], ['担任法人', '17'], ['担任开票员', '12'], ['任职容量不足', '3']],
-            'rows' => [
-                ['王敏 · 小满', '法人', '在职', '财务中心 / 刘景刚', '138****0621', '9 / 1', '3 / 0', '0'],
-                ['陈宇 · 远山', '法人', '在职', '经营管理部 / 刘景刚', '156****3372', '1 / 0', '1 / 1', '若干'],
-                ['赵宁 · 晴川', '开票员', '外部', '财务中心 / 秦薇', '186****9518', '4 / 3', '2 / 2', '3'],
-                ['林晚 · 青禾', '股东', '在职', '山东项目组 / 秦薇', '177****1506', '3 / 3', '1 / 1', '6'],
-            ],
         ],
         'company-progress' => [
             'title' => '公司进度表', 'description' => '跟踪公司注册、变更和注销办理进度',
             'columns' => ['公司名称', '公司类型', '当前进度', '是否完成', '完成时间', '办理人'],
-            'rows' => [['株洲市晞飏盛商贸有限公司', '主体变更', '资料准备', '否', '2026-09-02', '常仪'], ['合肥致远商贸有限公司', '注销', '税务清算', '否', '2026-09-10', '赵宁']],
         ],
         'company-information' => [
             'title' => '公司基础信息', 'description' => '维护公司主体资料与存续状态',
             'columns' => ['统一社会信用代码', '公司名称', '纳税人类型', '公司状态', '认缴注册资本（万元）', '注册时间', '法人', '股东', '监事', '开票员', '城市', '注册地址', '经营范围', '基本存款账户信息', '认缴时间'],
-            'rows' => [['91370214MA3R6H8A2Q', '青岛哲晖义商贸有限公司', '一般纳税人', '保留（正常）', '100 万', '青岛', '2021-08-12'], ['91430102MA4T7N2P5C', '株洲市晞飏盛商贸有限公司', '小规模', '待注销', '50 万', '株洲', '2022-01-19']],
         ],
         'entity-report' => [
             'title' => '主体维度经营报表', 'description' => '按公司主体汇总店铺经营表现',
             'columns' => ['市', '主体', '公司类型', 'ERP系统店铺名称', '店铺所属利润中心', '店铺负责人', '部门负责人', '开店时间', '状态', ...$recentCompletedMonthSalesColumns, '连续12个月店铺累计销量', '连续12个月主体累计销量', '能否变更主体', '规划', '新主体（变更流程同步新主体）'],
-            'rows' => [['青岛 / 青岛哲晖义商贸有限公司', '小规模纳税人', '6 家', '华北项目组', '¥962,408', '+8.3%', '关注', '变更'], ['济南 / 济南弈辰电子商务有限公司', '一般纳税人', '3 家', '山东项目组', '¥815,220', '-3.7%', '正常', '保留']],
         ],
         'trademark-progress' => [
             'title' => '商标进度表', 'description' => '跟踪商标续展与变更业务',
             'columns' => ['商标名称', '商标号', '业务', '进度', '是否完成', '完成时间', '办理人'],
-            'rows' => [['简序', '67215904', '持有人变更', '商标局审核', '否', '-', '常仪']],
         ],
         'trademark-information' => [
             'title' => '商标基础信息', 'description' => '维护商标权属、有效期与保管信息',
             'columns' => ['商标名称', '商标号', '商标状态', '注册时间', '有效期', '国际分类', '核定使用商品', '最终持有人', '注册地址', '保管部门'],
-            'rows' => [['柯诺苏', '59382147', '有效', '2022-03-21', '2032-03-20', '20 类', '株洲市晞飏盛商贸有限公司', '财务中心'], ['沐森', '48120633', '有效', '2021-01-07', '2031-01-06', '20 类', '杭州盈禾家居有限公司', '华东项目组']],
         ],
         'store-information' => [
             'title' => '店铺基础信息', 'description' => '维护店铺资料、经营状态与续签信息',
             'columns' => ['平台', '店铺ID', '店铺名称', '店铺主体', '店铺状态', '商标', '商标号', '业务部门', '店铺负责人', '部门负责人', '开店时间', '续签时间', '提现账户'],
-            'rows' => [['京东-柯诺苏家具旗舰店', '京东 / 515156', '株洲市晞飏盛商贸有限公司', '正常', '山东项目组', '2026-11-26', '¥284,300'], ['天猫-沐森家居旗舰店', '天猫 / 682041', '杭州盈禾家居有限公司', '关店中', '华东项目组', '2026-09-18', '¥239,842']],
         ],
         'store-change-progress' => [
             'title' => '店铺变更进度表', 'description' => '跟踪店铺主体变更办理进度',
             'columns' => ['公司名称', 'ERP系统店铺名称', '部门', '店铺负责人', '部门负责人', '账号', '密码', '接替公司', '进度', '是否完成', '完成时间', '办理人'],
-            'rows' => [['京东-柯诺苏家具旗舰店', '店铺主体变更', '株洲市晞飏盛商贸有限公司', '青岛哲晖义商贸有限公司', '平台审核', '2026-08-28', '进行中'], ['拼多多-简序生活馆', '店铺主体变更', '杭州盈禾家居有限公司', '青岛哲晖义商贸有限公司', '财务核对', '2026-09-02', '进行中']],
         ],
         'store-report' => [
             'title' => '店铺维度报表', 'description' => '查看店铺销量及历史主体归属',
             'columns' => ['ERP系统店铺名称', '店铺ID（唯一值）', '店铺所属利润中心', '店铺负责人', '部门负责人', '开店时间', '状态', '能否变更', '主体', '公司类型', '生效时间', '失效时间', '期间销量', '1月销量', '2月销量', '3月销量', '4月销量', '5月销量', '6月销量', '7月销量', '8月销量', '9月销量', '10月销量', '11月销量', '12月销量'],
-            'rows' => [['京东-柯诺苏家具旗舰店', '京东', '山东项目组', '正常', '株洲市晞飏盛商贸有限公司', '¥241,320', '¥268,140', '¥284,300', '2026-11-26'], ['天猫-沐森家居旗舰店', '天猫', '华东项目组', '正常', '杭州盈禾家居有限公司', '¥189,220', '¥217,650', '¥239,842', '2026-09-18']],
         ],
     ];
     $definition = $definitions[$slug] ?? ['title' => $page['title'] ?? '业务页面', 'description' => '', 'columns' => [], 'rows' => []];
 @endphp
 
-<div class="page-content business-prototype-page">
-    <div class="page-toolbar">
-        <div><strong>{{ $definition['description'] }}</strong><div class="text-muted mt-1">原型页面已集成；当前数据源为测试适配层</div></div>
-        <div class="toolbar-actions"><input class="biz-field-input" type="search" placeholder="搜索{{ $definition['title'] }}" aria-label="搜索{{ $definition['title'] }}"><button type="button" class="biz-btn biz-btn-primary"><span class="material-icons-outlined">add</span>新增</button></div>
-    </div>
-    @if (!empty($definition['summary']))
-        <div class="summary-strip">@foreach ($definition['summary'] as $item)<span><small>{{ $item[0] }}</small><strong>{{ $item[1] }}</strong></span>@endforeach</div>
-    @endif
-    <div class="biz-card mt-6">
-        <div class="biz-card-head"><div class="biz-card-title"><span class="material-icons-outlined">table_view</span><span>{{ $definition['title'] }}</span></div><span class="biz-badge biz-badge-info">测试适配层</span></div>
-        <div class="biz-table-wrap"><table class="biz-table"><thead><tr><th>#</th>@foreach ($definition['columns'] as $column)<th>{{ $column }}</th>@endforeach</tr></thead><tbody>@forelse ($definition['rows'] as $index => $row) @php($cells = array_pad(array_values($row), count($definition['columns']), null))<tr><td>{{ $index + 1 }}</td>@foreach ($cells as $value)<td>{{ $value ?: '-' }}</td>@endforeach</tr>@empty<tr><td colspan="{{ count($definition['columns']) + 1 }}"><div class="biz-empty"><span class="material-icons-outlined">inbox</span><div>暂无数据</div></div></td></tr>@endforelse</tbody></table></div>
-    </div>
-</div>
+@include('business.pages.partials.prototype-table', ['prototypeColumns' => $definition['columns']])

resources/views/business/pages/show.blade.php

@@ -143,6 +143,55 @@
                 margin-top: 1.25rem;
             }
 
+            .installation-filter-bar {
+                display: grid;
+                grid-template-columns: repeat(4, minmax(12rem, 1fr));
+                gap: 0.65rem 1rem;
+                padding: 1rem 1.5rem;
+                border-bottom: 1px solid #f3f4f6;
+                background: #fcfbf8;
+            }
+
+            .installation-filter-field {
+                display: flex;
+                align-items: center;
+                gap: 0.4rem;
+                min-width: 0;
+                color: #595959;
+                font-size: 0.75rem;
+                white-space: nowrap;
+            }
+
+            .installation-filter-field span {
+                flex: 0 0 auto;
+            }
+
+            .installation-filter-field input,
+            .installation-filter-field select {
+                min-width: 0;
+                width: 100%;
+                height: 2.1rem;
+                padding: 0 0.5rem;
+                border: 1px solid #d8d2c7;
+                border-radius: 0.375rem;
+                background: #ffffff;
+                color: #171717;
+                font-size: 0.75rem;
+            }
+
+            .installation-filter-actions {
+                display: flex;
+                align-items: center;
+                gap: 0.5rem;
+            }
+
+            @media (max-width: 1100px) {
+                .installation-filter-bar { grid-template-columns: repeat(2, minmax(14rem, 1fr)); }
+            }
+            @media (max-width: 650px) {
+                .installation-filter-bar { grid-template-columns: minmax(0, 1fr); padding: 1rem; }
+            }
+
             .biz-card-head {
                 display: flex;
                 align-items: center;
@@ -200,6 +249,56 @@
                 background: #f9fafb;
             }
 
+            .installation-main-row {
+                cursor: pointer;
+            }
+
+            .installation-expand {
+                width: 2rem;
+                height: 2rem;
+                padding: 0;
+                border: 1px solid #d8d2c7;
+                border-radius: 0.375rem;
+                background: #ffffff;
+                color: #856632;
+                cursor: pointer;
+            }
+
+            .installation-detail-row td {
+                padding: 0.75rem 1rem 1rem 3rem;
+                background: #fbfaf7;
+            }
+
+            .installation-detail-table {
+                width: 100%;
+                border-collapse: collapse;
+                font-size: 0.75rem;
+            }
+
+            .installation-detail-table th,
+            .installation-detail-table td {
+                padding: 0.45rem 0.65rem;
+                border: 1px solid #e5e0d7;
+                white-space: nowrap;
+                text-align: left;
+            }
+
+            .installation-detail-table th {
+                background: #f3efe6;
+                color: #595959;
+                font-weight: 600;
+            }
+
+            .installation-detail-empty,
+            .installation-detail-error {
+                color: #595959;
+                padding: 0.5rem 0;
+            }
+
+            .installation-detail-error {
+                color: #b80000;
+            }
+
             .biz-table .num {
                 text-align: right;
                 font-variant-numeric: tabular-nums;
@@ -486,6 +585,38 @@
                 @include($pageView)
             @elseif ($descriptor)
                 <div class="biz-card mt-6">
+                    @if ($page['slug'] === 'installation-details')
+                        <form method="GET" action="{{ request()->url() }}" class="installation-filter-bar" aria-label="安装明细筛选查询栏">
+                            @php
+                                $filterFields = [
+                                    ['name' => 'created_from', 'label' => '提交日期：', 'type' => 'date'], ['name' => 'created_to', 'label' => '至：', 'type' => 'date'],
+                                    ['name' => 'customer_review_from', 'label' => '客服审核时间：', 'type' => 'date'], ['name' => 'customer_review_to', 'label' => '至：', 'type' => 'date'],
+                                    ['name' => 'finance_review_from', 'label' => '财务审核时间：', 'type' => 'date'], ['name' => 'finance_review_to', 'label' => '至：', 'type' => 'date'],
+                                    ['name' => 'push_status', 'label' => '推送状态：'], ['name' => 'order_no', 'label' => '订单编号：'],
+                                    ['name' => 'customer_review', 'label' => '客服审核：', 'options' => ['0'=>'未审核','1'=>'已审核']], ['name' => 'finance_review', 'label' => '财务审核：', 'options' => ['0'=>'未审核','1'=>'已审核']],
+                                    ['name' => 'quote_status', 'label' => '报价状态：'], ['name' => 'arranged_status', 'label' => '是否安排：', 'options' => ['0'=>'未安排','1'=>'已安排']],
+                                    ['name' => 'fee_payer', 'label' => '安装费承担方：'], ['name' => 'completed_status', 'label' => '是否完工：', 'options' => ['0'=>'未完工','1'=>'已完工']],
+                                    ['name' => 'shop_name', 'label' => '选择店铺：'], ['name' => 'delete_status', 'label' => '选择删除：', 'options' => ['0'=>'未删除','1'=>'已删除']],
+                                    ['name' => 'installation_company', 'label' => '安装公司：'], ['name' => 'installation_no', 'label' => '安装单号：'],
+                                    ['name' => 'order_type', 'label' => '订单类型：'], ['name' => 'product_id', 'label' => '商品ID：'],
+                                ];
+                            @endphp
+                            @foreach ($filterFields as $filter)
+                                <label class="installation-filter-field">
+                                    <span>{{ $filter['label'] }}</span>
+                                    @if (isset($filter['options']))
+                                        <select name="{{ $filter['name'] }}"><option value="">全部</option>@foreach ($filter['options'] as $value => $label)<option value="{{ $value }}" @selected((string) request($filter['name']) === (string) $value)>{{ $label }}</option>@endforeach</select>
+                                    @else
+                                        <input type="{{ $filter['type'] ?? 'text' }}" name="{{ $filter['name'] }}" value="{{ request($filter['name']) }}" @if (($filter['type'] ?? '') !== 'date') placeholder="按原值精确查询" @endif>
+                                    @endif
+                                </label>
+                            @endforeach
+                            <div class="installation-filter-actions">
+                                <button type="submit" class="biz-btn biz-btn-primary">查询</button>
+                                <a href="{{ request()->url() }}" class="biz-btn biz-btn-ghost">清除</a>
+                            </div>
+                        </form>
+                    @endif
                     <div class="biz-card-head">
                         <div class="biz-card-title">
                             <span class="material-icons-outlined" aria-hidden="true">table_view</span>
@@ -525,7 +656,7 @@
                         <table class="biz-table">
                             <thead>
                                 <tr>
-                                    <th>#</th>
+                                    @if ($page['slug'] !== 'installation-details')<th>#</th>@endif
                                     @foreach ($descriptor->fields as $field)
                                         <th class="@if ($field['currency']) num @endif">{{ $field['label'] }}</th>
                                     @endforeach
@@ -536,8 +667,8 @@
                             </thead>
                             <tbody>
                                 @forelse ($rows as $row)
-                                    <tr>
-                                        <td>{{ $row->id }}</td>
+                                    <tr @if ($page['slug'] === 'installation-details') class="installation-main-row" data-installation-row data-guid="{{ $row->related_guid ?? '' }}" tabindex="0" aria-label="查看安装商品明细" @endif>
+                                        @if ($page['slug'] !== 'installation-details')<td>{{ $row->id }}</td>@endif
                                         @foreach ($descriptor->fields as $field)
                                             @php
                                                 $val = $row->{$field['name']};
@@ -580,7 +711,7 @@
                                     </tr>
                                 @empty
                                     <tr>
-                                        <td colspan="{{ count($descriptor->fields) + ($descriptor->readOnly ? 1 : 2) }}">
+                                        <td colspan="{{ count($descriptor->fields) + ($page['slug'] === 'installation-details' ? 0 : 1) + ($descriptor->readOnly ? 0 : 1) }}">
                                             <div class="biz-empty">
                                                 <span class="material-icons-outlined" aria-hidden="true">inbox</span>
                                                 <div>{{ $descriptor->readOnly ? '暂无工作平台数据' : '暂无数据，点击右上角"新增"开始录入' }}</div>
@@ -607,6 +738,63 @@
                             @endif
                         </span>
                     </div>
+
+                    @if ($page['slug'] === 'installation-details')
+                        <section class="installation-detail-panel" data-installation-detail-panel aria-label="明细子表">
+                            <div class="biz-card-head"><div class="biz-card-title">明细子表</div></div>
+                            <div class="biz-table-wrap" data-installation-detail-content>
+                                <div class="installation-detail-empty">请点击上方主表记录查看商品明细</div>
+                            </div>
+                        </section>
+                    @endif
+
+                    @if ($page['slug'] === 'installation-details')
+                        <script>
+                            (() => {
+                                const detailUrl = @json(route('business.installation-details.details', ['guid' => '__GUID__']));
+                                const columns = [
+                                    ['transaction_no', '交易单号'], ['product_id', '商品id'], ['id_owner', 'ID负责人'],
+                                    ['department_owner', '部门负责人'], ['auxiliary_spu', '辅助码Spu'], ['product_store_code', '商品店铺编码'],
+                                    ['item_no', '货号'], ['barcode', '条形码'], ['product_name', '商品名称'], ['supplier_name', '供应商名称'],
+                                    ['detail_requested_amount', '申请明细金额'], ['detail_requested_quantity', '申请明细数量'],
+                                    ['detail_settled_amount', '结算明细金额'], ['detail_received_amount', '收款明细金额'],
+                                    ['change_reason', '变更原因'], ['source_created_at', '创建时间'], ['source_modified_at', '修改时间'],
+                                ];
+                                const escapeHtml = (value) => String(value ?? '').replace(/[&<>"']/g, (char) => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#039;'}[char]));
+                                const renderDetails = (items) => {
+                                    if (!items.length) return '<div class="installation-detail-empty">暂无商品明细</div>';
+                                    const head = columns.map(([, label]) => `<th>${escapeHtml(label)}</th>`).join('');
+                                    const body = items.map((item) => `<tr>${columns.map(([key]) => `<td>${escapeHtml(item[key])}</td>`).join('')}</tr>`).join('');
+                                    return `<table class="installation-detail-table"><thead><tr>${head}</tr></thead><tbody>${body}</tbody></table>`;
+                                };
+                                const detailPanel = document.querySelector('[data-installation-detail-panel]');
+                                const detailContent = detailPanel?.querySelector('[data-installation-detail-content]');
+                                let detailRequest = 0;
+                                document.querySelectorAll('[data-installation-row]').forEach((row) => {
+                                    row.addEventListener('keydown', (event) => {
+                                        if (event.target === row && (event.key === 'Enter' || event.key === ' ')) { event.preventDefault(); row.click(); }
+                                    });
+                                    row.addEventListener('click', async () => {
+                                        if (!detailContent) return;
+                                        const requestId = ++detailRequest;
+                                        detailContent.innerHTML = '<div>正在加载明细…</div>';
+                                        try {
+                                            const response = await fetch(detailUrl.replace('__GUID__', encodeURIComponent(row.dataset.guid)), {headers: {'Accept': 'application/json'}});
+                                            if (!response.ok) throw new Error('明细加载失败');
+                                            const payload = await response.json();
+                                            if (requestId !== detailRequest) return;
+                                            detailContent.innerHTML = renderDetails(payload.data || []);
+                                            if (payload.has_more) detailContent.insertAdjacentHTML('beforeend', '<div class="installation-detail-empty">当前仅展示前 100 条商品明细，不代表全部。</div>');
+                                        } catch (error) {
+                                            if (requestId !== detailRequest) return;
+                                            detailContent.innerHTML = '<div class="installation-detail-error">明细加载失败，请稍后重试</div>';
+                                        }
+                                    });
+                                });
+                            })();
+                        </script>
+                    @endif
+
                 </div>
 
                 @unless ($descriptor->readOnly)

resources/views/components/layouts/admin/menu.blade.php

@@ -154,11 +154,11 @@
                 ]],
                 ['title' => '基础资料', 'items' => [
                     ['store-management', 'basic-information', '店铺基础信息', 'shopping_bag'],
-                    ['store-management', 'store-accounts', '店铺账号密码', 'key'],
                     ['company-management', 'basic-information', '公司基础信息', 'badge'],
                     ['trademark-management', 'information', '商标基础信息', 'workspace_premium'],
                 ]],
                 ['title' => '业务进度', 'items' => [
+                    ['company-management', 'company-progress', '公司进度表', 'timeline'],
                     ['store-management', 'change-progress', '店铺变更进度表', 'swap_horiz'],
                     ['trademark-management', 'trademark-progress', '商标进度表', 'format_list_bulleted'],
                     ['workspace', 'tasks', '待办事项', 'assignment_turned_in'],
@@ -169,6 +169,20 @@
                     ['prototype-finance-reports', 'asset-report', '公司资产报表', 'account_balance'],
                 ]],
             ];
+            $visiblePages = [];
+            foreach (\App\Utilities\SidebarPermissions::navigationFor(user()) as $visibleSection) {
+                foreach ($visibleSection['pages'] ?? [] as $visiblePage) {
+                    $visiblePages[$visibleSection['slug'] . '/' . $visiblePage['slug']] = $visiblePage['title'];
+                }
+            }
+            $prototypeGroups = array_values(array_filter(array_map(function ($group) use ($visiblePages) {
+                $group['items'] = array_values(array_filter($group['items'], fn ($item) => isset($visiblePages[$item[0] . '/' . $item[1]])));
+                foreach ($group['items'] as &$item) {
+                    $item[2] = $visiblePages[$item[0] . '/' . $item[1]];
+                }
+                unset($item);
+                return $group;
+            }, $prototypeGroups), fn ($group) => $group['items'] !== []));
         @endphp
 
         <style>
@@ -177,10 +191,10 @@
             .prototype-tag-group-title { padding: 0 0.75rem 0.45rem; color: var(--vip-sidebar-gold-soft, #DDD0AA); font-size: 0.6875rem; line-height: 1rem; }
             .prototype-tag-link { position: relative; display: flex; min-height: 2.4rem; align-items: center; gap: 0.65rem; margin: 0.125rem 0; padding: 0.55rem 0.75rem; border-radius: 0.25rem; color: var(--vip-sidebar-gold-soft, #DDD0AA); font-size: 0.75rem; line-height: 1rem; }
             .prototype-tag-link:hover { color: var(--vip-sidebar-gold, #F0E4BF); background: rgba(240, 228, 191, 0.08); }
-            .prototype-tag-link.is-active { color: var(--vip-rail-gold, #F2E7C5); background: var(--vip-sidebar-active, #2A2927); box-shadow: inset 3px 0 var(--vip-content-accent, #B9954F); }
+            .prototype-tag-link.is-active { color: var(--vip-rail-gold, #F2E7C5); background: var(--vip-sidebar-active, #2A2927); }
+            .prototype-tag-link:focus-visible { outline: 2px solid var(--vip-sidebar-gold, #F0E4BF); outline-offset: 2px; }
             .prototype-tag-link .material-icons-outlined { width: 1.25rem; flex: 0 0 1.25rem; font-size: 1rem; text-align: center; }
             .prototype-tag-link > span:nth-child(2) { flex: 1; white-space: nowrap; }
-            .prototype-tag-link em { display: inline-grid; min-width: 1.4rem; height: 1.4rem; place-items: center; padding: 0 0.35rem; border-radius: 999px; background: #7D3D38; color: #F9E7E5; font-size: 0.6875rem; font-style: normal; }
         </style>
 
         <div class="prototype-tag-navigation" aria-label="税务功能导航">
@@ -191,11 +205,10 @@
                         <a
                             href="{{ route('business.pages.show', ['section' => $navSection, 'page' => $navPage]) }}"
                             @class(['prototype-tag-link', 'is-active' => request()->route('section') === $navSection && request()->route('page') === $navPage])
+                            @if (request()->route('section') === $navSection && request()->route('page') === $navPage) aria-current="page" @endif
                         >
                             <span class="material-icons-outlined" aria-hidden="true">{{ $navIcon }}</span>
                             <span>{{ $navTitle }}</span>
-                            @if ($navPage === 'tasks')<em>8</em>@endif
-                            @if ($navPage === 'warnings')<em>3</em>@endif
                         </a>
                     @endforeach
                 </section>

resources/views/system_settings/databases/form.blade.php

@@ -5,7 +5,9 @@
         <div class="my-6">
             @include('system_settings.partials.navigation')
 
-            <form method="POST" action="{{ $connection ? route('system-settings.databases.update', $connection->id) : route('system-settings.databases.store') }}" class="max-w-4xl rounded-xl border border-gray-200 bg-white p-6">
+            @php($selectedDriver = old('driver', $values['driver']))
+            @php($postgres = $selectedDriver !== 'sqlsrv')
+            <form id="cloud-database-form" method="POST" action="{{ $connection ? route('system-settings.databases.update', $connection->id) : route('system-settings.databases.store') }}" class="max-w-4xl rounded-xl border border-gray-200 bg-white p-6">
                 @csrf
                 @if ($connection) @method('PATCH') @endif
 
@@ -16,64 +18,88 @@
                 @endif
 
                 <div class="grid grid-cols-1 gap-5 sm:grid-cols-2">
+                    <label class="block sm:col-span-2">
+                        <span class="text-sm font-semibold text-gray-700">数据库类型 *</span>
+                        <select name="driver" required class="mt-1 w-full rounded-lg border border-[#D8D2C7] px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]">
+                            <option value="sqlsrv" @selected($selectedDriver === 'sqlsrv')>SQL Server</option>
+                            <option value="pgsql" @selected($selectedDriver === 'pgsql')>PostgreSQL</option>
+                            <option value="mysql" @selected($selectedDriver === 'mysql')>MySQL / MariaDB</option>
+                        </select>
+                    </label>
+                    <p data-postgres-help class="text-sm text-gray-600 sm:col-span-2" style="{{ $postgres ? '' : 'display:none' }}" role="status">通过 TLS 加密连接（PostgreSQL 使用 sslmode=require）；只读查询最长 15 秒。启用后自动发现字段目录，业务表按已批准的数据集同步。</p>
                     <label class="block sm:col-span-2">
                         <span class="text-sm font-semibold text-gray-700">配置名称 *</span>
-                        <input name="name" value="{{ old('name', $values['name']) }}" required maxlength="191" placeholder="例如：JianSun 测试库" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm placeholder-gray-500 focus:border-purple-700 focus:ring-purple-700">
+                        <input name="name" value="{{ old('name', $values['name']) }}" required maxlength="191" placeholder="例如：JianSun 测试库" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm placeholder-gray-500 focus:border-[#856632] focus:ring-[#856632]">
                     </label>
                     <label class="block sm:col-span-2">
                         <span class="text-sm font-semibold text-gray-700">主机地址 *</span>
-                        <input name="host" value="{{ old('host', $values['host']) }}" required maxlength="191" autocomplete="off" placeholder="数据库域名、IP 或本地隧道地址" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm placeholder-gray-500 focus:border-purple-700 focus:ring-purple-700">
+                        <input name="host" value="{{ old('host', $values['host']) }}" required maxlength="191" autocomplete="off" placeholder="只填写域名或 IP，不含端口" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm placeholder-gray-500 focus:border-[#856632] focus:ring-[#856632]">
                     </label>
                     <label class="block">
                         <span class="text-sm font-semibold text-gray-700">端口 *</span>
-                        <input type="number" name="port" value="{{ old('port', $values['port']) }}" required min="1" max="65535" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700">
+                        <input type="number" name="port" value="{{ old('port', $values['port']) }}" required min="1" max="65535" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]">
                     </label>
                     <label class="block">
                         <span class="text-sm font-semibold text-gray-700">数据库名称 *</span>
-                        <input name="database_name" value="{{ old('database_name', $values['database_name']) }}" required maxlength="191" autocomplete="off" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700">
+                        <input name="database_name" value="{{ old('database_name', $values['database_name']) }}" required maxlength="191" autocomplete="off" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]">
                     </label>
                     <label class="block">
                         <span class="text-sm font-semibold text-gray-700">只读账号 *</span>
-                        <input name="username" value="{{ old('username', $values['username']) }}" required maxlength="191" autocomplete="off" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700">
+                        <input name="username" value="{{ old('username', $values['username']) }}" required maxlength="191" autocomplete="off" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]">
                     </label>
                     <label class="block">
                         <span class="text-sm font-semibold text-gray-700">密码 {{ $connection ? '' : '*' }}</span>
-                        <input type="password" name="password" @required(! $connection) maxlength="1000" autocomplete="new-password" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700">
+                        <input type="password" name="password" @required(! $connection) maxlength="1000" autocomplete="new-password" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]">
                         <span class="mt-1 block text-xs text-gray-500">{{ $connection ? '留空表示保留原密码。' : '保存后不会回显。' }}</span>
                     </label>
-                    <label class="block sm:col-span-2">
-                        <span class="text-sm font-semibold text-gray-700">绑定业务来源</span>
-                        <select name="source_key" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700">
-                            <option value="">不绑定，仅保存和测试</option>
-                            @foreach ($sourceLabels as $key => $label)
-                                <option value="{{ $key }}" @selected(old('source_key', $values['source_key']) === $key)>{{ $label }}</option>
-                            @endforeach
-                        </select>
-                    </label>
                 </div>
 
                 <details class="mt-6 rounded-lg border border-gray-200 px-4 py-3">
                     <summary class="cursor-pointer text-sm font-semibold text-gray-700">高级设置</summary>
                     <div class="mt-4 grid grid-cols-1 gap-5 sm:grid-cols-2">
-                        <label class="block"><span class="text-sm font-semibold text-gray-700">ODBC 驱动</span><input name="odbc_driver" value="{{ old('odbc_driver', $values['odbc_driver']) }}" required maxlength="128" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700"></label>
-                        <label class="block"><span class="text-sm font-semibold text-gray-700">TDS 版本</span><input name="tds_version" value="{{ old('tds_version', $values['tds_version']) }}" required maxlength="16" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700"></label>
-                        <label class="block"><span class="text-sm font-semibold text-gray-700">连接超时（秒）</span><input type="number" name="connect_timeout" value="{{ old('connect_timeout', $values['connect_timeout']) }}" required min="1" max="30" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700"></label>
-                        <label class="block"><span class="text-sm font-semibold text-gray-700">查询超时（秒）</span><input type="number" name="query_timeout" value="{{ old('query_timeout', $values['query_timeout']) }}" required min="1" max="120" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-purple-700 focus:ring-purple-700"></label>
-                        <label class="block sm:col-span-2"><span class="text-sm font-semibold text-gray-700">允许的数据范围</span><textarea name="allowed_scopes" rows="2" maxlength="4000" placeholder="绑定业务来源时填写，每行或逗号分隔" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm placeholder-gray-500 focus:border-purple-700 focus:ring-purple-700">{{ old('allowed_scopes', $values['allowed_scopes']) }}</textarea></label>
+                        <label data-sqlserver-only class="block" style="{{ $postgres ? 'display:none' : '' }}"><span class="text-sm font-semibold text-gray-700">ODBC 驱动</span><input name="odbc_driver" value="{{ old('odbc_driver', $values['odbc_driver'] ?: 'FreeTDS') }}" required @disabled($postgres) maxlength="128" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]"></label>
+                        <label data-sqlserver-only class="block" style="{{ $postgres ? 'display:none' : '' }}"><span class="text-sm font-semibold text-gray-700">TDS 版本</span><input name="tds_version" value="{{ old('tds_version', $values['tds_version'] ?: '7.4') }}" required @disabled($postgres) maxlength="16" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]"></label>
+                        <label class="block"><span class="text-sm font-semibold text-gray-700">连接超时（秒）</span><input type="number" name="connect_timeout" value="{{ old('connect_timeout', $values['connect_timeout']) }}" required min="1" max="30" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]"></label>
+                        <label class="block"><span class="text-sm font-semibold text-gray-700">查询超时（秒）</span><input type="number" name="query_timeout" value="{{ old('query_timeout', $values['query_timeout']) }}" required min="1" max="120" class="mt-1 w-full rounded-lg border border-gray-300 px-3 py-2 text-sm focus:border-[#856632] focus:ring-[#856632]"></label>
                     </div>
                 </details>
 
                 <div class="mt-6 flex items-center justify-between border-t border-gray-100 pt-5">
                     <div>
                         <input type="hidden" name="enabled" value="0">
-                        <label class="inline-flex items-center gap-2 text-sm font-semibold text-gray-700"><input type="checkbox" name="enabled" value="1" @checked((bool) old('enabled', $values['enabled'])) class="rounded border-gray-300 text-purple-700 focus:ring-purple-700">启用</label>
+                        <label class="inline-flex items-center gap-2 text-sm font-semibold text-gray-700"><input type="checkbox" name="enabled" value="1" @checked((bool) old('enabled', $values['enabled'])) class="rounded border-gray-300 text-[#856632] focus:ring-[#856632]">启用</label>
                     </div>
                     <div class="flex gap-3">
                         <a href="{{ route('system-settings.databases.index') }}" class="rounded-lg px-5 py-2 text-sm font-semibold text-gray-600 hover:bg-gray-100">取消</a>
-                        <button type="submit" class="rounded-lg bg-purple-700 px-5 py-2 text-sm font-semibold text-white hover:bg-purple-800">保存</button>
+                        <button type="submit" class="rounded-lg bg-[#856632] px-5 py-2 text-sm font-semibold text-white hover:bg-[#6A5129]">保存</button>
                     </div>
                 </div>
             </form>
         </div>
+        @push('body_end')
+            <script>
+                (() => {
+                    const form = document.getElementById('cloud-database-form');
+                    const driver = form.elements.driver;
+                    const ports = {sqlsrv: '1433', pgsql: '5432', mysql: '3306'};
+                    let previous = driver.value;
+                    const update = (changePort) => {
+                        const postgres = driver.value !== 'sqlsrv';
+                        if (changePort && form.elements.port.value === ports[previous]) {
+                            form.elements.port.value = ports[driver.value];
+                        }
+                        form.querySelectorAll('[data-sqlserver-only]').forEach((group) => {
+                            group.style.display = postgres ? 'none' : '';
+                            group.querySelectorAll('input, select').forEach((field) => field.disabled = postgres);
+                        });
+                        form.querySelector('[data-postgres-help]').style.display = postgres ? '' : 'none';
+                        form.elements.query_timeout.max = postgres ? '15' : '120';
+                        previous = driver.value;
+                    };
+                    driver.addEventListener('change', () => update(true));
+                    update(false);
+                })();
+            </script>
+        @endpush
     </x-slot>
 </x-layouts.admin>

resources/views/system_settings/databases/index.blade.php

@@ -88,7 +88,6 @@
                                 <th class="px-5 py-3 font-semibold">名称</th>
                                 <th class="px-5 py-3 font-semibold">地址</th>
                                 <th class="px-5 py-3 font-semibold">数据库</th>
-                                <th class="px-5 py-3 font-semibold">业务绑定</th>
                                 <th class="px-5 py-3 font-semibold">状态</th>
                                 <th class="px-5 py-3 text-right font-semibold">操作</th>
                             </tr>
@@ -96,10 +95,9 @@
                         <tbody class="divide-y divide-gray-100">
                             @forelse ($connections as $connection)
                                 <tr>
-                                    <td class="px-5 py-4 font-semibold text-gray-900">{{ $connection->name }}</td>
+                                    <td class="px-5 py-4 font-semibold text-gray-900">{{ $connection->name }}<span class="mt-1 block text-xs font-normal text-gray-600">{{ match ($connection->driver) { 'pgsql' => 'PostgreSQL · SSL', 'mysql' => 'MySQL / MariaDB · TLS', default => 'SQL Server' } }}</span></td>
                                     <td class="px-5 py-4 text-gray-600">{{ $connection->host }}:{{ $connection->port }}</td>
                                     <td class="px-5 py-4 text-gray-600">{{ $connection->database_name }}</td>
-                                    <td class="px-5 py-4 text-gray-600">{{ $sourceLabels[$connection->source_key] ?? '未绑定' }}</td>
                                     <td class="px-5 py-4">
                                         <span @class([
                                             'inline-flex rounded-full px-2.5 py-1 text-xs font-semibold',
@@ -122,7 +120,7 @@
                                 </tr>
                             @empty
                                 <tr>
-                                    <td colspan="6" class="px-5 py-12 text-center text-gray-500">
+                                    <td colspan="5" class="px-5 py-12 text-center text-gray-500">
                                         {{ $systemDatabase['mode'] === 'bootstrap'
                                             ? '连接团队共享系统数据库后，两套云数据库配置会自动显示在这里。'
                                             : '共享系统数据库中还没有云数据库配置。' }}

routes/admin.php

@@ -117,6 +117,10 @@ Route::get('workspace/courier-payables/courier-information/export', 'Business\Pa
 Route::get('workspace/{section}/{page}/{tab}/export', 'Business\Pages@export')
     ->name('business.pages.export');
 
+Route::get('workspace/financial-operations/installation-details/details/{guid}', 'Business\Pages@installationDetails')
+    ->where('guid', '[A-Za-z0-9-]+')
+    ->name('business.installation-details.details');
+
 Route::get('workspace/{section}/{page?}/{tab?}', 'Business\Pages@show')
     ->name('business.pages.show');
 

scripts/deploy-from-workstation.ps1

@@ -346,6 +346,11 @@ try {
             .
     } '本机镜像构建失败。服务器未发生任何变更。'
 
+    # 在无网络、无生产配置的临时容器中引导 Laravel，拦截开发包缓存混入镜像。
+    Invoke-Native {
+        docker run --rm --network none --user www-data --entrypoint php $fullImage artisan --version
+    } '发布镜像无法引导 Laravel。服务器未发生任何变更。'
+
     $previousShaOutput = @(& ssh -i $keyFullPath -o BatchMode=yes -o StrictHostKeyChecking=accept-new $sshTarget "cat '$RemotePath/.deployed-sha' 2>/dev/null || true")
     $previousSha = ($previousShaOutput -join "`n").Trim()
     if ($LASTEXITCODE -ne 0) {

tests/Feature/Business/ManagementCrudTest.php

@@ -4,9 +4,11 @@ namespace Tests\Feature\Business;
 
 use App\Business\UpstreamBusinessInformation;
 use App\Models\Auth\Permission;
+use App\Models\Business\InstallationDetail;
 use App\Utilities\BusinessNavigation;
 use Illuminate\Pagination\LengthAwarePaginator;
 use Mockery;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
 use Tests\Feature\FeatureTestCase;
 
 class ManagementCrudTest extends FeatureTestCase
@@ -20,6 +22,74 @@ class ManagementCrudTest extends FeatureTestCase
         );
     }
 
+    public function testInstallationDetailsRendersWorkbookHeadersAndImportedRows(): void
+    {
+        $mirror = Mockery::mock(InstallationDetailMirrorRepository::class);
+        $mirror->shouldReceive('paginate')->once()->andReturn([
+            'ready' => true, 'total' => 1, 'data' => [array_replace(array_fill_keys(array_keys(InstallationDetail::columnLabels()), null), [
+                'id' => 1, 'installation_no' => 'INSTALL-TEST-001', 'installation_company' => '测试安装公司',
+                'store_name' => '测试店铺', 'requested_amount' => '120.50', 'settled_amount' => '100.00', 'item_quantity' => 2,
+                'related_guid' => 'guid-install-test',
+            ])],
+        ]);
+        $this->app->instance(InstallationDetailMirrorRepository::class, $mirror);
+
+        $this->loginAs()
+            ->get(route('business.pages.show', [
+                'section' => 'financial-operations',
+                'page' => 'installation-details',
+            ]))
+            ->assertOk()
+            ->assertSeeText('安装明细 · 数据列表')
+            ->assertSeeText('安装单号')
+            ->assertSeeText('申请总金额')
+            ->assertSeeText('商品名称(1)')
+            ->assertSeeText('提交日期：')
+            ->assertSeeText('客服审核时间：')
+            ->assertSeeText('财务审核时间：')
+            ->assertSeeText('推送状态：')
+            ->assertSeeText('选择店铺：')
+            ->assertSeeText('选择删除：')
+            ->assertSeeText('订单类型：')
+            ->assertSeeText('商品ID：')
+            ->assertSeeText('INSTALL-TEST-001')
+            ->assertSeeText('测试安装公司')
+            ->assertSeeText('120.50')
+            ->assertSeeText('共 1 条');
+    }
+
+    public function testInstallationDetailsEndpointReturnsChildItemsForMainRecord(): void
+    {
+        $mirror = Mockery::mock(InstallationDetailMirrorRepository::class);
+        $mirror->shouldReceive('details')->once()->with('guid-install-test')->andReturn([
+            'ready' => true,
+            'data' => [[
+                'transaction_no' => 'INSTALL-TEST-001',
+                'product_id' => '10035070813217',
+                'product_name' => '测试商品',
+                'detail_requested_amount' => '53.59',
+                'detail_requested_quantity' => 1,
+            ]],
+        ]);
+        $this->app->instance(InstallationDetailMirrorRepository::class, $mirror);
+
+        $this->loginAs()
+            ->get(route('business.installation-details.details', ['guid' => 'guid-install-test']))
+            ->assertOk()
+            ->assertJsonPath('data.0.transaction_no', 'INSTALL-TEST-001')
+            ->assertJsonPath('data.0.product_name', '测试商品');
+    }
+
+    public function testInstallationChildEndpointRequiresTheSameSidebarPermission(): void
+    {
+        $this->withExceptionHandling();
+        setting()->set('system.sidebar_permissions', ['configured'=>['user_'.$this->user->id], 'subjects'=>['user_'.$this->user->id=>['store-management/basic-information']]]);
+        $mirror=Mockery::mock(InstallationDetailMirrorRepository::class);
+        $mirror->shouldNotReceive('details');
+        $this->app->instance(InstallationDetailMirrorRepository::class,$mirror);
+        $this->loginAs()->getJson(route('business.installation-details.details',['guid'=>'guid-install-test']))->assertForbidden();
+    }
+
     public function testCompanyInformationUsesWorkbookHeadersAndReadOnlyUpstreamRows(): void
     {
         $this->mockUpstreamPage((object) [
@@ -95,6 +165,48 @@ class ManagementCrudTest extends FeatureTestCase
         $this->assertCount(14, $headers[0]);
     }
 
+    public function testStoreReportRendersExpandedLifecycleRowsAndClosedInProgressStatus(): void
+    {
+        $service = Mockery::mock(UpstreamBusinessInformation::class);
+        $service->shouldReceive('paginate')->once()->with('store-management', 'store-report', 50)->andReturn(
+            new LengthAwarePaginator([[
+                'erp_store_name' => '测试店铺',
+                'store_id' => '测试店铺',
+                'profit_center' => '运营中心A',
+                'store_manager' => '店铺负责人',
+                'department_manager' => '部门负责人',
+                'opened_at' => '2026-05-01',
+                'status' => '关店中',
+                'entity' => '测试主体',
+                'company_type' => '普通公司',
+                'effective_at' => '2026-07-01',
+                'invalid_at' => '2999-01-01',
+                'period_sales' => 25916.80,
+                'sales_07' => 25916.80,
+            ]], 1, 50, 1, ['path' => '/'])
+        );
+        $this->app->instance(UpstreamBusinessInformation::class, $service);
+
+        $response = $this->loginAs()->get(route('business.pages.show', [
+            'section' => 'store-management',
+            'page' => 'store-report',
+        ]));
+
+        $response
+            ->assertOk()
+            ->assertSeeText('店铺维度报表')
+            ->assertSeeText('测试店铺')
+            ->assertSeeText('测试主体')
+            ->assertSeeText('2026-07-01')
+            ->assertSeeText('2999-01-01')
+            ->assertSeeText('25,916.80')
+            ->assertSeeText('关店中')
+            ->assertSeeText('共享镜像');
+
+        preg_match_all('/<th(?:\s|>)/', $response->getContent(), $headers);
+        $this->assertCount(26, $headers[0]);
+    }
+
     public function testTrademarkInformationShowsReadOnlyUpstreamRows(): void
     {
         $this->mockUpstreamPage((object) [
@@ -234,7 +346,7 @@ class ManagementCrudTest extends FeatureTestCase
     {
         $paginator = new LengthAwarePaginator([$row], 1, 50, 1, ['path' => '/']);
         $service = Mockery::mock(UpstreamBusinessInformation::class);
-        $service->shouldReceive('paginate')->once()->andReturn($paginator);
+        $service->shouldReceive('paginate')->atLeast()->once()->andReturn($paginator);
         $this->app->instance(UpstreamBusinessInformation::class, $service);
     }
 }

tests/Feature/Business/PrototypePageTest.php

@@ -7,6 +7,32 @@ use Tests\Feature\FeatureTestCase;
 
 class PrototypePageTest extends FeatureTestCase
 {
+    public function testNavigationUsesConfiguredPermissionsAndTitles(): void
+    {
+        setting()->set('system.sidebar_permissions', [
+            'configured' => ['user_' . $this->user->id],
+            'subjects' => ['user_' . $this->user->id => ['company-management/subject-operating-report']],
+        ]);
+        setting()->set('navigation.titles', ['pages' => ['company-management' => ['subject-operating-report' => '主体经营测试']]]);
+        $response = $this->loginAs()->get(route('business.pages.show', ['section' => 'company-management', 'page' => 'subject-operating-report']));
+        $response->assertOk()->assertSeeText('主体经营测试');
+        $html = $response->getContent();
+        preg_match('/<div class="prototype-tag-navigation".*?<div class="main-menu/s', $html, $matches);
+        $this->assertNotEmpty($matches);
+        $this->assertStringContainsString('主体经营测试', $matches[0]);
+        $this->assertStringNotContainsString('/workspace/store-management/basic-information', $matches[0]);
+        $this->assertStringNotContainsString('/workspace/workspace/', $matches[0]);
+        $this->assertStringNotContainsString('<em>', $matches[0]);
+    }
+
+    public function testBootstrapConnectionFailureDoesNotDisplayZeroBusinessRecords(): void
+    {
+        $this->mock(\App\Business\UpstreamBusinessInformation::class)
+            ->shouldReceive('paginate')->once()->andThrow(new \Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException(null, '当前仍使用本机临时引导库，请连接团队共享数据库。'));
+        $this->loginAs()->get(route('business.pages.show', ['section' => 'store-management', 'page' => 'basic-information']))
+            ->assertOk()->assertSeeText('请连接团队共享数据库')->assertDontSeeText('共 0 条');
+    }
+
     protected function tearDown(): void
     {
         Carbon::setTestNow();
@@ -20,7 +46,7 @@ class PrototypePageTest extends FeatureTestCase
 
         $augustResponse = $this->loginAs()->get(route('business.pages.show', [
             'section' => 'company-management',
-            'page' => 'entity-report',
+            'page' => 'subject-operating-report',
         ]));
 
         $augustResponse
@@ -33,7 +59,7 @@ class PrototypePageTest extends FeatureTestCase
 
         $septemberResponse = $this->get(route('business.pages.show', [
             'section' => 'company-management',
-            'page' => 'entity-report',
+            'page' => 'subject-operating-report',
         ]));
 
         $septemberResponse
@@ -41,5 +67,9 @@ class PrototypePageTest extends FeatureTestCase
             ->assertSeeTextInOrder(['6月销量', '7月销量', '8月销量'])
             ->assertDontSeeText('5月销量')
             ->assertDontSeeText('9月销量');
+
+        Carbon::setTestNow('2027-01-01 00:00:00');
+        $this->get(route('business.pages.show', ['section' => 'company-management', 'page' => 'subject-operating-report']))
+            ->assertOk()->assertSeeTextInOrder(['10月销量', '11月销量', '12月销量']);
     }
 }

tests/Feature/Console/BusinessMirrorScheduleTest.php

@@ -12,6 +12,49 @@ use Tests\TestCase;
 
 class BusinessMirrorScheduleTest extends TestCase
 {
+    public function test_unapproved_first_sync_is_skipped(): void
+    {
+        config(['upstream_mirrors.refresh_enabled' => true]);
+        $dataset = Mockery::mock(BusinessMirrorDataset::class);
+        $registry = Mockery::mock(BusinessMirrorDatasetRegistry::class);
+        $registry->shouldReceive('all')->once()->andReturn(['pending' => $dataset]);
+        $registry->shouldReceive('scheduled')->with('pending')->andReturn(true);
+        $registry->shouldReceive('automaticInitialSyncAllowed')->with('pending')->andReturn(false);
+        $mirror = Mockery::mock(GenericBusinessMirrorRepository::class);
+        $mirror->shouldReceive('state')->with($dataset)->andReturn(null);
+        $sync = Mockery::mock(BusinessMirrorSynchronizer::class);
+        $sync->shouldNotReceive('sync');
+        $this->app->instance(BusinessMirrorDatasetRegistry::class, $registry);
+        $this->app->instance(GenericBusinessMirrorRepository::class, $mirror);
+        $this->app->instance(BusinessMirrorSynchronizer::class, $sync);
+        $this->artisan('business-mirror:sync-tables')->assertSuccessful();
+    }
+
+    public function test_catchup_and_routine_datasets_both_receive_a_turn(): void
+    {
+        config(['upstream_mirrors.refresh_enabled' => true, 'upstream_pipeline.sync.max_datasets' => 2]);
+        $registry = Mockery::mock(BusinessMirrorDatasetRegistry::class);
+        $mirror = Mockery::mock(GenericBusinessMirrorRepository::class);
+        $objects = [];
+        foreach (['routine-a', 'routine-b', 'catchup-z'] as $key) {
+            $objects[$key] = Mockery::mock(BusinessMirrorDataset::class);
+            $registry->shouldReceive('scheduled')->with($key)->andReturn(true);
+            $mirror->shouldReceive('state')->with($objects[$key])->andReturn([
+                'initial_completed_at' => '2026-08-01 00:00:00', 'last_attempted_at' => '2026-08-01 00:00:00',
+                'status' => $key === 'catchup-z' ? 'running' : 'succeeded',
+            ]);
+        }
+        $registry->shouldReceive('all')->andReturn($objects);
+        $sync = Mockery::mock(BusinessMirrorSynchronizer::class);
+        $result = ['status' => 'succeeded', 'batches' => 1, 'rows' => 1];
+        $sync->shouldReceive('sync')->once()->with('routine-a', false, null, null)->ordered()->andReturn($result);
+        $sync->shouldReceive('sync')->once()->with('catchup-z', false, null, 6)->ordered()->andReturn($result);
+        $this->app->instance(BusinessMirrorDatasetRegistry::class, $registry);
+        $this->app->instance(GenericBusinessMirrorRepository::class, $mirror);
+        $this->app->instance(BusinessMirrorSynchronizer::class, $sync);
+        $this->artisan('business-mirror:sync-tables')->assertSuccessful();
+    }
+
     public function test_generic_rotation_excludes_datasets_with_a_dedicated_scheduler(): void
     {
         config([
@@ -28,6 +71,7 @@ class BusinessMirrorScheduleTest extends TestCase
             ProductCatalogMirrorRepository::DATASET_KEY => $catalog,
             'test.dbo.other' => $other,
         ]);
+        $datasets->shouldReceive('scheduled')->once()->with('test.dbo.other')->andReturn(true);
         $mirror = Mockery::mock(GenericBusinessMirrorRepository::class);
         $mirror->shouldReceive('state')->once()->with($other)->andReturn([
             'initial_completed_at' => '2026-08-01 02:00:00',

tests/Feature/Console/StoreReportDataImportTest.php

@@ -0,0 +1,153 @@
+<?php
+
+namespace Tests\Feature\Console;
+
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Modules\EcommerceFinance\Repositories\StoreReportRepository;
+use Modules\EcommerceFinance\Services\StoreReportDataImporter;
+use PhpOffice\PhpSpreadsheet\Spreadsheet;
+use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
+use RuntimeException;
+use Tests\TestCase;
+
+class StoreReportDataImportTest extends TestCase
+{
+    /** @var string[] */
+    private array $temporaryFiles = [];
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        config([
+            'database.connections.business_mirror' => ['driver' => 'sqlite', 'database' => ':memory:', 'prefix' => ''],
+            'upstream_mirrors.connection' => 'business_mirror',
+        ]);
+        DB::purge('business_mirror');
+        $this->createTables();
+    }
+
+    protected function tearDown(): void
+    {
+        foreach ($this->temporaryFiles as $file) {
+            @unlink($file);
+        }
+        parent::tearDown();
+    }
+
+    public function test_it_imports_platform_income_and_lifecycles_into_shared_generations(): void
+    {
+        $bills = $this->xlsx('抖音平台原始账单', [
+            ['店铺', '记录编码', '结算时间', '发生时间', '收入', '支出', '账单项目'],
+            ['店铺A', 'BILL-1', '2026-08-02 10:00:00', '2026-08-01 09:00:00', '100.25', '2.5', '订单收入'],
+            ['店铺A', 'BILL-2', null, '2026-08-03 11:00:00', '50', '0', '订单收入'],
+        ]);
+        $lifecycles = $this->xlsx('店铺生命周期', [
+            ['ERP系统店铺名称', '公司名称', '生效时间', '失效时间'],
+            ['店铺A', '主体甲', '2026-01-01', '存续中'],
+        ]);
+        $importer = app(StoreReportDataImporter::class);
+
+        $billResult = $importer->importBills($bills, 100);
+        $lifecycleResult = $importer->importLifecycles($lifecycles, 100);
+
+        $this->assertSame(2, $billResult['row_count']);
+        $this->assertSame(1, $lifecycleResult['row_count']);
+        $this->assertDatabaseHas('store_report_bill_rows', [
+            'record_code' => 'BILL-1', 'occurred_at' => '2026-08-02 10:00:00', 'income' => 100.25,
+        ], 'business_mirror');
+        $this->assertDatabaseHas('store_report_bill_rows', [
+            'record_code' => 'BILL-2', 'occurred_at' => '2026-08-03 11:00:00', 'income' => 50,
+        ], 'business_mirror');
+        $this->assertDatabaseHas('store_report_import_states', [
+            'dataset_key' => StoreReportRepository::BILLS_DATASET, 'status' => 'succeeded', 'row_count' => 2,
+        ], 'business_mirror');
+        $this->assertDatabaseHas('store_report_lifecycle_rows', [
+            'erp_store_name' => '店铺A', 'company_name' => '主体甲', 'expires_at' => null,
+        ], 'business_mirror');
+    }
+
+    public function test_failed_reimport_keeps_the_previous_active_generation(): void
+    {
+        $valid = $this->xlsx('拼多多平台原始账单', [
+            ['店铺', '记录编码', '发生时间', '收入金额', '支出金额'],
+            ['店铺A', 'PDD-1', '2026-08-01', '10', '0'],
+        ]);
+        $importer = app(StoreReportDataImporter::class);
+        $first = $importer->importBills($valid, 100);
+        $invalid = $this->xlsx('拼多多错误账单', [
+            ['店铺', '记录编码', '发生时间', '收入金额'],
+            ['店铺A', 'PDD-2', '不是时间', '20'],
+        ]);
+
+        try {
+            $importer->importBills($invalid, 100);
+            $this->fail('无效时间应导致导入失败。');
+        } catch (RuntimeException) {
+            $state = DB::connection('business_mirror')->table('store_report_import_states')
+                ->where('dataset_key', StoreReportRepository::BILLS_DATASET)->first();
+            $this->assertSame('failed', $state->status);
+            $this->assertSame($first['generation'], $state->active_generation);
+            $this->assertSame(1, DB::connection('business_mirror')->table('store_report_bill_rows')->count());
+        }
+    }
+
+    private function createTables(): void
+    {
+        $schema = Schema::connection('business_mirror');
+        $schema->create('store_report_import_states', function (Blueprint $table): void {
+            $table->string('dataset_key')->primary();
+            $table->string('status')->default('pending');
+            $table->string('active_generation')->nullable();
+            $table->string('pending_generation')->nullable();
+            $table->unsignedBigInteger('row_count')->default(0);
+            $table->string('source_sha256')->nullable();
+            $table->text('source_files_json')->nullable();
+            $table->dateTime('last_attempted_at')->nullable();
+            $table->dateTime('last_succeeded_at')->nullable();
+            $table->string('last_error_code')->nullable();
+            $table->timestamps();
+        });
+        $schema->create('store_report_bill_rows', function (Blueprint $table): void {
+            $table->increments('id');
+            $table->string('generation');
+            $table->string('platform');
+            $table->string('platform_label');
+            $table->string('store_name');
+            $table->dateTime('occurred_at')->nullable();
+            $table->decimal('income', 20, 4);
+            $table->decimal('expense', 20, 4);
+            $table->string('bill_item')->nullable();
+            $table->string('record_code');
+            $table->string('source_file');
+            $table->string('row_hash');
+            $table->dateTime('imported_at');
+            $table->unique(['generation', 'platform', 'record_code']);
+        });
+        $schema->create('store_report_lifecycle_rows', function (Blueprint $table): void {
+            $table->increments('id');
+            $table->string('generation');
+            $table->string('business_key');
+            $table->string('erp_store_name');
+            $table->string('company_name')->nullable();
+            $table->dateTime('effective_at')->nullable();
+            $table->dateTime('expires_at')->nullable();
+            $table->string('source_file');
+            $table->string('row_hash');
+            $table->dateTime('imported_at');
+            $table->unique(['generation', 'business_key']);
+        });
+    }
+
+    private function xlsx(string $name, array $rows): string
+    {
+        $path = sys_get_temp_dir() . DIRECTORY_SEPARATOR . $name . '-' . uniqid() . '.xlsx';
+        $spreadsheet = new Spreadsheet();
+        $spreadsheet->getActiveSheet()->fromArray($rows);
+        (new Xlsx($spreadsheet))->save($path);
+        $spreadsheet->disconnectWorksheets();
+        $this->temporaryFiles[] = $path;
+        return $path;
+    }
+}

tests/Feature/Installation/ApplicationReadyTest.php

@@ -18,4 +18,20 @@ class ApplicationReadyTest extends TestCase
         $this->artisan('app:ready')
             ->assertExitCode(\App\Console\Commands\ApplicationReady::EXIT_NOT_INSTALLED);
     }
+
+    public function test_bootstrap_stays_healthy_without_claiming_shared_data_is_ready(): void
+    {
+        config(['app.installed' => true, 'system_database.mode' => 'bootstrap']);
+        $this->artisan('app:ready')
+            ->expectsOutputToContain('团队共享数据尚未接入')
+            ->assertSuccessful();
+    }
+
+    public function test_shared_application_health_does_not_claim_upstream_sync_success(): void
+    {
+        config(['app.installed' => true, 'system_database.mode' => 'shared']);
+        $this->artisan('app:ready')
+            ->expectsOutputToContain('团队数据接入状态请运行 system-database:verify')
+            ->assertSuccessful();
+    }
 }

tests/Feature/Installation/ConnectTeamSystemDatabaseTest.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace Tests\Feature\Installation;
+
+use App\Utilities\SystemDatabaseConfiguration;
+use App\Utilities\TeamSystemDatabaseProfile;
+use Mockery;
+use RuntimeException;
+use Tests\TestCase;
+
+class ConnectTeamSystemDatabaseTest extends TestCase
+{
+    private function settings(): array
+    {
+        return ['driver'=>'mysql','host'=>'new-team.test','port'=>8444,'database'=>'shared_system',
+            'mirror_database'=>'caiwu_business_mirror','username'=>'team_user','password'=>'fixture-secret',
+            'prefix'=>'ak_','tls_required'=>true,'tls_verify_server_cert'=>false,'tls_ca'=>''];
+    }
+
+    private function configureProfile(): void
+    {
+        $this->app->instance(TeamSystemDatabaseProfile::class, new TeamSystemDatabaseProfile(
+            TeamSystemDatabaseProfile::seal($this->settings(), 'fixture-secret')
+        ));
+    }
+
+    public function test_existing_password_repairs_old_endpoint_without_connecting_to_old_database(): void
+    {
+        $this->configureProfile();
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn(array_replace($this->settings(), ['host'=>'retired.test','mode'=>'shared']));
+        $configuration->shouldReceive('probe')->once()->with(Mockery::on(fn($s)=>$s['host']==='new-team.test'))->andReturn(['prefix'=>'ak_']);
+        $configuration->shouldReceive('persist')->once()->with($this->settings())->andReturn('private-backup');
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('已备份并更新本机')->assertSuccessful();
+    }
+
+    public function test_first_bootstrap_without_team_password_does_not_write_or_probe(): void
+    {
+        $this->configureProfile();
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn(['password'=>'bootstrap-only','mode'=>'bootstrap']);
+        $configuration->shouldNotReceive('probe');
+        $configuration->shouldNotReceive('persist');
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('输入一次密码')->assertExitCode(13);
+    }
+
+    public function test_current_team_connection_is_not_rewritten_on_every_initialization(): void
+    {
+        $this->configureProfile();
+        $s=$this->settings();
+        config(['upstreams.stored_configuration.enabled'=>true,'upstreams.local_configuration.enabled'=>false,
+            'database.connections.business_mirror'=>['read'=>['host'=>[$s['host']]],'write'=>['host'=>[$s['host']]],'port'=>$s['port'],
+                'database'=>$s['mirror_database'],'username'=>$s['username'],'password'=>$s['password'],'unix_socket'=>'']]);
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn($s+['mode'=>'shared']);
+        $configuration->shouldReceive('probe')->once()->andReturn(['prefix'=>'ak_']);
+        $configuration->shouldNotReceive('persist');
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('已连接最新团队')->assertSuccessful();
+    }
+
+    public function test_failed_new_endpoint_probe_keeps_original_configuration(): void
+    {
+        $this->configureProfile();
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn($this->settings()+['mode'=>'shared']);
+        $configuration->shouldReceive('probe')->once()->andThrow(new RuntimeException('private connection details'));
+        $configuration->shouldNotReceive('persist');
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('原配置已保留')->doesntExpectOutputToContain('private connection details')->assertFailed();
+    }
+
+    public function test_production_never_rewrites_its_internal_endpoint(): void
+    {
+        $this->app->detectEnvironment(fn()=>'production');
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldNotReceive('current');
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('不修改生产服务器连接')->assertFailed();
+    }
+
+    public function test_persistence_failure_does_not_claim_connection_success(): void
+    {
+        $this->configureProfile();
+        $configuration=Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn(array_replace($this->settings(), ['host'=>'retired.test','mode'=>'shared']));
+        $configuration->shouldReceive('probe')->once()->andReturn(['prefix'=>'ak_']);
+        $configuration->shouldReceive('persist')->once()->andThrow(new RuntimeException('private details'));
+        $this->app->instance(SystemDatabaseConfiguration::class,$configuration);
+        $this->artisan('system-database:connect-team')->expectsOutputToContain('请核对私有配置备份')->doesntExpectOutputToContain('已备份并更新')->assertFailed();
+    }
+}

tests/Feature/Installation/VerifySystemDatabaseTest.php

@@ -10,7 +10,7 @@ use Tests\TestCase;
 
 class VerifySystemDatabaseTest extends TestCase
 {
-    public function test_verify_command_reports_configuration_not_loaded(): void
+    public function test_bootstrap_is_not_reported_as_a_failed_remote_connection(): void
     {
         $configuration = Mockery::mock(SystemDatabaseConfiguration::class);
         $configuration->shouldReceive('current')->once()->andReturn([
@@ -19,9 +19,42 @@ class VerifySystemDatabaseTest extends TestCase
         $this->app->instance(SystemDatabaseConfiguration::class, $configuration);
 
         $this->artisan('system-database:verify')
+            ->expectsOutputToContain('尚未接入团队共享系统数据库；本次没有测试远程连接')
+            ->assertExitCode(VerifySystemDatabase::EXIT_SHARED_NOT_CONFIGURED);
+    }
+
+    public function test_shared_mode_with_disabled_stored_configuration_is_not_ready(): void
+    {
+        config(['upstreams.stored_configuration.enabled' => false]);
+        $configuration = Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn(['mode' => 'shared']);
+        $this->app->instance(SystemDatabaseConfiguration::class, $configuration);
+        $this->artisan('system-database:verify')
+            ->expectsOutputToContain('共享配置未完整启用')
             ->assertExitCode(VerifySystemDatabase::EXIT_CONFIG_NOT_LOADED);
     }
 
+    public function test_current_configuration_failure_remains_a_configuration_error(): void
+    {
+        $configuration = Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andThrow(new RuntimeException('private details'));
+        $this->app->instance(SystemDatabaseConfiguration::class, $configuration);
+        $this->artisan('system-database:verify')
+            ->expectsOutputToContain('新配置未被 Laravel 加载')
+            ->assertExitCode(VerifySystemDatabase::EXIT_CONFIG_NOT_LOADED);
+    }
+
+    public function test_shared_success_requires_connection_and_system_table_verification(): void
+    {
+        $this->enableSharedMode();
+        $settings = ['mode' => 'shared', 'connection' => config('database.default')];
+        $configuration = Mockery::mock(SystemDatabaseConfiguration::class);
+        $configuration->shouldReceive('current')->once()->andReturn($settings);
+        $configuration->shouldReceive('probe')->once()->with($settings)->andReturn([]);
+        $this->app->instance(SystemDatabaseConfiguration::class, $configuration);
+        $this->artisan('system-database:verify')->expectsOutputToContain('共享系统数据库已通过应用级验证')->assertSuccessful();
+    }
+
     public function test_verify_command_reports_database_connection_failure(): void
     {
         $this->enableSharedMode();

tests/Feature/SystemSettings/UpstreamDatabasesTest.php

@@ -14,6 +14,7 @@ use Illuminate\Support\Facades\DB;
 use Mockery;
 use Modules\EcommerceFinance\Services\UpstreamSourceRegistry;
 use Modules\EcommerceFinance\Services\UpstreamStoredConfiguration;
+use Modules\EcommerceFinance\Services\UpstreamDatabaseProbe;
 use Tests\Feature\FeatureTestCase;
 
 class UpstreamDatabasesTest extends FeatureTestCase
@@ -499,6 +500,65 @@ class UpstreamDatabasesTest extends FeatureTestCase
             ->assertSessionHasErrors('password');
     }
 
+    public function test_postgres_can_be_saved_without_sql_server_settings(): void
+    {
+        $payload = $this->payload(['driver' => 'pgsql', 'port' => 25432, 'password' => 'pg-secret']);
+        unset($payload['odbc_driver'], $payload['tds_version']);
+        $this->loginAs()->post(route('system-settings.databases.store'), $payload)
+            ->assertSessionHasNoErrors()->assertRedirect(route('system-settings.databases.index'));
+        $connection = DatabaseConnection::where('driver', 'pgsql')->firstOrFail();
+        $this->assertNull($connection->odbc_driver);
+        $this->assertNull($connection->source_key);
+        $this->assertSame('pg-secret', $connection->password);
+        $this->get(route('system-settings.databases.edit', $connection->id))
+            ->assertOk()->assertSee('sslmode=require')->assertSee('PostgreSQL')->assertDontSee('pg-secret');
+    }
+
+    public function test_changing_wrong_driver_preserves_password(): void
+    {
+        $connection = $this->connection('keep-secret');
+        $this->loginAs()->patch(route('system-settings.databases.update', $connection->id), $this->payload([
+            'driver' => 'pgsql', 'port' => 25432, 'password' => '',
+        ]))->assertSessionHasNoErrors();
+        $connection->refresh();
+        $this->assertSame('pgsql', $connection->driver);
+        $this->assertSame(25432, $connection->port);
+        $this->assertSame('keep-secret', $connection->password);
+    }
+
+    public function test_postgres_cannot_replace_existing_sql_server_business_source(): void
+    {
+        $this->withExceptionHandling();
+        $this->loginAs()->post(route('system-settings.databases.store'), $this->payload([
+            'driver' => 'pgsql', 'source_key' => 'operations_replica',
+        ]))->assertSessionHasErrors('source_key');
+        $this->assertSame(0, DatabaseConnection::where('company_id', 0)->count());
+    }
+
+    public function test_host_must_not_include_port(): void
+    {
+        $this->withExceptionHandling();
+        $this->loginAs()->post(route('system-settings.databases.store'), $this->payload([
+            'host' => '127.0.0.1:25432',
+        ]))->assertSessionHasErrors('host');
+    }
+
+    public function test_test_button_uses_saved_postgres_driver_and_password(): void
+    {
+        $connection = $this->connection('saved-pg-secret');
+        $connection->update(['driver' => 'pgsql', 'port' => 25432]);
+        $probe = Mockery::mock(UpstreamDatabaseProbe::class);
+        $probe->shouldReceive('probe')->once()->withArgs(fn ($driver, $config, $label) =>
+            $driver === 'pgsql' && $config['password'] === 'saved-pg-secret' && $config['port'] === 25432
+        );
+        $this->app->instance(UpstreamDatabaseProbe::class, $probe);
+        $this->loginAs()->post(route('system-settings.databases.test', $connection->id))
+            ->assertSessionHasNoErrors()->assertRedirect(route('system-settings.databases.index'));
+        $this->assertFlashLevel('success');
+        $this->assertStringContainsString('PostgreSQL SSL 连接成功', session('flash_notification')->first()->message);
+        $this->get(route('system-settings.databases.index'))->assertSeeText('PostgreSQL')->assertDontSee('saved-pg-secret');
+    }
+
     private function payload(array $overrides = []): array
     {
         return array_merge([
@@ -518,6 +578,30 @@ class UpstreamDatabasesTest extends FeatureTestCase
         ], $overrides);
     }
 
+    public function test_mysql_connection_appears_in_dictionary_sources_without_a_binding(): void
+    {
+        $payload = $this->payload(['driver' => 'mysql', 'port' => 3306]);
+        unset($payload['source_key'], $payload['allowed_scopes'], $payload['odbc_driver'], $payload['tds_version']);
+        $this->loginAs()->post(route('system-settings.databases.store'), $payload)->assertSessionHasNoErrors();
+        $row = DatabaseConnection::where('driver', 'mysql')->firstOrFail();
+        $this->assertArrayHasKey($row->sourceIdentifier(), app(UpstreamSourceRegistry::class)->all());
+        $this->get(route('system-settings.databases.create'))->assertOk()
+            ->assertSee('MySQL / MariaDB')->assertDontSee('name="source_key"', false)->assertDontSee('name="allowed_scopes"', false);
+    }
+
+    public function test_editing_simplified_form_preserves_legacy_binding_and_scopes(): void
+    {
+        $row = $this->connection('keep-secret');
+        $row->update(['source_key' => 'jiansun']);
+        $payload = $this->payload(['name' => $row->name, 'password' => '']);
+        unset($payload['source_key'], $payload['allowed_scopes']);
+        $this->loginAs()->patch(route('system-settings.databases.update', $row->id), $payload)->assertSessionHasNoErrors();
+        $row->refresh();
+        $this->assertSame('jiansun', $row->source_key);
+        $this->assertSame(['supplier.options'], $row->allowed_scopes);
+        $this->assertSame('keep-secret', $row->password);
+    }
+
     private function connection(string $password): DatabaseConnection
     {
         return DatabaseConnection::create([

tests/Unit/Deployment/LocalSharedDatabaseStatusTest.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Tests\Unit\Deployment;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Process\Process;
+
+class LocalSharedDatabaseStatusTest extends TestCase
+{
+    public function test_team_repair_runs_before_application_start_and_ready_check(): void
+    {
+        $script=file_get_contents(dirname(__DIR__,3).'/deploy/local-init.sh');
+        $repair=strpos($script,'php artisan system-database:connect-team');
+        $this->assertNotFalse($repair);
+        $this->assertLessThan(strpos($script,'up -d --no-build app'),$repair);
+        $this->assertStringContainsString('run --rm --no-deps -T --entrypoint sh app', $script);
+    }
+
+    /** @dataProvider verificationStates */
+    public function test_initializer_reports_the_verified_state(int $verificationExit, int $expectedExit, string $message): void
+    {
+        $script = file_get_contents(dirname(__DIR__, 3) . '/deploy/local-init.sh');
+        $start = strpos($script, 'echo "本地网页可访问：');
+        $this->assertNotFalse($start);
+        $process = new Process(['bash', '-c',
+            'set -eu; compose_file=fixture; credential_file=fixture; docker() { return ' . $verificationExit . '; }; '
+            . substr($script, $start),
+        ]);
+        $process->setTimeout(5);
+        $process->run();
+        $this->assertSame($expectedExit, $process->getExitCode());
+        $this->assertStringContainsString($message, $process->getOutput() . $process->getErrorOutput());
+        if ($verificationExit !== 0) {
+            $this->assertStringNotContainsString('团队共享系统数据库验证通过', $process->getOutput());
+        }
+    }
+
+    public static function verificationStates(): array
+    {
+        return [
+            'bootstrap' => [13, 0, '团队数据接入尚未完成'],
+            'shared success' => [0, 0, '团队共享系统数据库验证通过'],
+            'config failure' => [10, 10, '未通过验证'],
+            'network failure' => [11, 11, '未通过验证'],
+            'schema failure' => [12, 12, '未通过验证'],
+        ];
+    }
+}

tests/Unit/Deployment/ProductionBuildCachePolicyTest.php

@@ -6,6 +6,17 @@ use Tests\TestCase;
 
 class ProductionBuildCachePolicyTest extends TestCase
 {
+    public function testReleaseExcludesLocalBootstrapCachesAndBootsBeforeProductionAccess(): void
+    {
+        $ignore = file_get_contents(base_path('.dockerignore'));
+        $this->assertContains('bootstrap/cache/*', preg_split('/\R/', $ignore));
+        $script = file_get_contents(base_path('scripts/deploy-from-workstation.ps1'));
+        $smoke = strpos($script, 'docker run --rm --network none --user www-data --entrypoint php $fullImage artisan --version');
+        $remote = strpos($script, '$previousShaOutput =');
+        $this->assertNotFalse($smoke);
+        $this->assertLessThan($remote, $smoke);
+    }
+
     public function testProductionDockerfilePinsBaseImagesAndRetriesExternalDownloads(): void
     {
         $dockerfile = file_get_contents(base_path('deploy/Dockerfile'));

tests/Unit/EcommerceFinance/BusinessInformationMirrorRepositoryTest.php

@@ -57,6 +57,9 @@ class BusinessInformationMirrorRepositoryTest extends TestCase
             ['Id' => 6, 'trademarkName' => '已删除', 'internationalClassification' => '20', 'trademarkStatus' => '0', 'registrationDate' => null, 'termOfValidity' => null, 'remark' => null, 'isDelete' => 1],
         ]);
         $this->markReady();
+        $connection->table('ops_fys_company_info')->where('Id', 1)->update(['registeredCapitalVaildTime' => '2027-01-01']);
+        $connection->table('ops_fys_shop_info')->where('Id', 8)->update(['sotreId' => 'STORE-8', 'renewalTime' => '2027-08-14', 'shopBankAccount' => 'fixture-account']);
+        $connection->table('ops_fys_trademark_info')->where('Id', 5)->update(['trademarkNumber' => 'TM-5', 'approvedCommodities' => '家具', 'transferenceUser' => '测试持有人', 'registrationAddress' => '测试地址', 'custodyDepartment' => '资料部']);
 
         $companies = $this->repository->paginate('company-information.read', 2, 2);
         $store = $this->repository->paginate('store-information.read', 1, 20);
@@ -67,6 +70,14 @@ class BusinessInformationMirrorRepositoryTest extends TestCase
         $this->assertSame('新公司', $store['data'][0]['company_name']);
         $this->assertSame(1, $trademarks['total']);
         $this->assertSame('有效商标', $trademarks['data'][0]['trademark_name']);
+        $this->assertSame('2027-01-01', $companies['data'][0]['subscribed_at']);
+        $this->assertSame('STORE-8', $store['data'][0]['store_id']);
+        $this->assertSame('2027-08-14', $store['data'][0]['renewed_at']);
+        $this->assertSame('负责人', $store['data'][0]['store_manager']);
+        $this->assertSame('fixture-account', $store['data'][0]['withdrawal_account']);
+        $this->assertSame('TM-5', $trademarks['data'][0]['trademark_number']);
+        $this->assertSame('家具', $trademarks['data'][0]['approved_goods']);
+        $this->assertSame('测试持有人', $trademarks['data'][0]['final_holder']);
     }
 
     public function test_dataset_is_not_ready_until_initial_full_sync_is_marked_complete(): void
@@ -89,16 +100,19 @@ class BusinessInformationMirrorRepositoryTest extends TestCase
             $table->string('legalRepresentative')->nullable(); $table->string('registeredAddress')->nullable(); $table->text('businessScope')->nullable();
             $table->string('accountSerialNumber')->nullable(); $table->string('companyStatus')->nullable(); $table->string('financialManager')->nullable();
             $table->string('supervisor')->nullable(); $table->string('taxCategoryAndType')->nullable();
+            $table->dateTime('registeredCapitalVaildTime')->nullable();
         });
         $schema->create('ops_fys_shop_info', function (Blueprint $table): void {
             $table->integer('Id'); $table->dateTime('openTime')->nullable(); $table->string('erpShopName')->nullable(); $table->string('unifiedSocialCreditCode')->nullable();
             $table->string('trademarkNumber')->nullable(); $table->string('platform')->nullable(); $table->string('responsibleDepartment')->nullable();
-            $table->string('shopHead')->nullable(); $table->string('shopState')->nullable(); $table->string('shopType')->nullable(); $table->string('channelType')->nullable();
+            $table->string('shopHead')->nullable(); $table->string('customerDeptManager')->nullable(); $table->string('shopState')->nullable(); $table->string('shopType')->nullable(); $table->string('channelType')->nullable();
+            $table->string('sotreId')->nullable(); $table->dateTime('renewalTime')->nullable(); $table->string('shopBankAccount')->nullable();
         });
         $schema->create('ops_fys_trademark_info', function (Blueprint $table): void {
             $table->integer('Id'); $table->string('trademarkName')->nullable(); $table->string('internationalClassification')->nullable();
             $table->string('trademarkStatus')->nullable(); $table->dateTime('registrationDate')->nullable(); $table->dateTime('termOfValidity')->nullable();
             $table->text('remark')->nullable(); $table->integer('isDelete')->default(0);
+            foreach (['trademarkNumber', 'approvedCommodities', 'transferenceUser', 'registrationAddress', 'custodyDepartment'] as $column) $table->string($column)->nullable();
         });
     }
 

tests/Unit/EcommerceFinance/BusinessMirrorSynchronizerTest.php

@@ -277,11 +277,13 @@ class BusinessMirrorSynchronizerTest extends TestCase
         $datasets = (new BusinessMirrorDatasetRegistry())->all();
         $targets = array_map(fn ($dataset): string => $dataset->targetTable(), $datasets);
 
-        $this->assertCount(38, $datasets);
+        $this->assertGreaterThanOrEqual(38, count($datasets));
         $this->assertCount(count($targets), array_unique($targets));
         $this->assertContains('operations_replica', array_map(fn ($dataset): string => $dataset->sourceKey(), $datasets));
         $this->assertContains('jiansun', array_map(fn ($dataset): string => $dataset->sourceKey(), $datasets));
         $this->assertNotContains('Bulk_Price_Limit', array_map(fn ($dataset): string => $dataset->sourceObject(), $datasets));
+        $this->assertContains('fys_Ticketing_install_view', array_map(fn ($dataset): string => $dataset->sourceObject(), $datasets));
+        $this->assertContains('fys_Ticketing_install_item', array_map(fn ($dataset): string => $dataset->sourceObject(), $datasets));
     }
 
     /** @return array<string,mixed> */

tests/Unit/EcommerceFinance/GenericUpstreamPipelineTest.php

@@ -0,0 +1,184 @@
+<?php
+
+namespace Tests\Unit\EcommerceFinance;
+
+use App\Models\Settings\DatabaseConnection;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
+use Modules\EcommerceFinance\Services\BusinessMirrorDataReader;
+use Modules\EcommerceFinance\Services\UpstreamConnection;
+use Modules\EcommerceFinance\Services\UpstreamSourceRegistry;
+use Modules\EcommerceFinance\Services\UpstreamSchemaCatalogSynchronizer;
+use Modules\EcommerceFinance\Services\UpstreamSqlDialect;
+use PDO;
+use PDOException;
+use Tests\TestCase;
+
+class GenericUpstreamPipelineTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+        config([
+            'upstreams.stored_configuration.enabled' => true,
+            'upstreams.local_configuration.enabled' => false,
+            'database.connections.sqlite.password' => 'fixture-cipher-key',
+            'database.connections.business_mirror' => ['driver' => 'sqlite', 'database' => ':memory:', 'prefix' => ''],
+            'upstream_mirrors.connection' => 'business_mirror',
+            'upstream_mirrors.datasets' => [],
+            'upstream_mirrors.refresh_enabled' => true,
+        ]);
+        DB::purge('business_mirror');
+        Schema::connection('business_mirror')->create('business_mirror_table_states', function (Blueprint $t): void {
+            $t->string('dataset_key')->primary();
+            foreach (['source_key', 'source_object', 'target_table', 'status', 'run_mode', 'generation', 'last_error_code'] as $c) $t->string($c)->nullable();
+            foreach (['cursor', 'high_watermark'] as $c) $t->json($c)->nullable();
+            foreach (['window_started_at', 'window_ends_at', 'initial_completed_at', 'last_full_succeeded_at', 'last_attempted_at', 'last_succeeded_at'] as $c) $t->dateTime($c)->nullable();
+            $t->unsignedBigInteger('last_upserted_rows')->default(0);
+            $t->unsignedBigInteger('mirror_row_count')->default(0);
+            $t->timestamps();
+        });
+    }
+
+    protected function tearDown(): void
+    {
+        UpstreamConnection::reset();
+        parent::tearDown();
+    }
+
+    private function connection(string $driver = 'pgsql'): DatabaseConnection
+    {
+        return DatabaseConnection::create([
+            'company_id' => 0, 'name' => 'Isolated fixture', 'driver' => $driver, 'host' => 'fixture.invalid',
+            'port' => $driver === 'pgsql' ? 5432 : 3306, 'database_name' => 'fixture',
+            'username' => 'fixture', 'password' => 'fixture-password', 'enabled' => true,
+            'connect_timeout' => 5, 'query_timeout' => 15,
+        ]);
+    }
+
+    public function test_new_connection_is_immediately_a_source_without_changing_config(): void
+    {
+        $row = $this->connection();
+        $key = $row->sourceIdentifier();
+        $sources = app(UpstreamSourceRegistry::class);
+        $this->assertNull($row->source_key);
+        $this->assertNull(config('upstreams.sources.' . $key));
+        $this->assertSame('pgsql', $sources->driver($key));
+        $this->assertTrue($sources->enabled($key));
+        $this->assertSame('fixture-password', $sources->value($key, 'connection.password'));
+        $this->assertArrayHasKey($key, $sources->all());
+        $this->assertSame('jiansun', $sources->definition('jiansun')['key']);
+    }
+
+    public function test_dialects_use_engine_specific_limits_and_quotes(): void
+    {
+        $this->assertSame('SELECT TOP (5) [id] FROM [dbo].[records]', (new UpstreamSqlDialect('sqlsrv'))->select('[id]', 'FROM [dbo].[records]', 5));
+        $this->assertSame('SELECT "id" FROM "public"."records" LIMIT 5', (new UpstreamSqlDialect('pgsql'))->select('"id"', 'FROM "public"."records"', 5));
+        $this->assertSame('SELECT `id` FROM `records` LIMIT 5', (new UpstreamSqlDialect('mysql'))->select('`id`', 'FROM `records`', 5));
+        $this->assertStringContainsString('c.table_schema = DATABASE()', (new UpstreamSqlDialect('mysql'))->catalogSql());
+    }
+
+    public function test_source_discovery_does_not_decrypt_credentials(): void
+    {
+        $row = $this->connection();
+        DB::table('system_database_connections')->where('id', $row->id)->update(['shared_password' => 'invalid-fixture-envelope']);
+        $sources = app(UpstreamSourceRegistry::class);
+        $this->assertArrayHasKey($row->sourceIdentifier(), $sources->all());
+        $this->assertSame('pgsql', $sources->driver($row->sourceIdentifier()));
+    }
+
+    public function test_declarations_require_fields_and_explicit_initial_sync_approval(): void
+    {
+        $row = $this->connection();
+        $source = $row->sourceIdentifier();
+        DB::table('upstream_schema_columns')->insert([
+            'source_key' => $source, 'schema_name' => 'public', 'object_name' => 'records',
+            'object_type' => 'table', 'column_name' => 'id', 'ordinal_position' => 1, 'data_type' => 'bigint',
+            'is_nullable' => false, 'synchronized_at' => now(), 'created_at' => now(), 'updated_at' => now(),
+        ]);
+        $args = ['source' => $source, 'schema' => 'public', 'object' => 'records', '--keys' => 'id', '--columns' => 'id'];
+        $this->artisan('business-mirror:register', $args)->assertSuccessful();
+        $key = $source . '.public.records';
+        $registry = app(BusinessMirrorDatasetRegistry::class);
+        $this->assertFalse($registry->automaticInitialSyncAllowed($key));
+        $this->artisan('business-mirror:sync-tables')->assertSuccessful();
+        $this->assertSame(0, DB::connection('business_mirror')->table('business_mirror_table_states')->count());
+        $this->artisan('business-mirror:register', $args + ['--enable-sync' => true])->assertSuccessful();
+        $this->assertTrue($registry->automaticInitialSyncAllowed($key));
+        $this->assertSame(['id'], $registry->columnSelection($key));
+        $this->artisan('business-mirror:register', ['source' => $source, 'schema' => 'public', 'object' => 'records', '--disable-sync' => true])->assertSuccessful();
+        $this->assertFalse($registry->scheduled($key));
+    }
+
+    /** @dataProvider nativeDrivers */
+    public function test_native_tls_catalog_first_sync_pagination_and_incremental(string $driver, bool $timezoneAware = false, ?string $fixtureHost = null): void
+    {
+        if (getenv('CAIWU_PIPELINE_INTEGRATION') !== '1') $this->markTestSkipped('Requires isolated pipeline fixture containers.');
+        $host = $fixtureHost ?? ($driver === 'pgsql' ? 'caiwu-pipeline-pg' : 'caiwu-pipeline-mysql');
+        $database = $driver === 'pgsql' ? 'postgres' : 'pipeline_fixture';
+        $user = $driver === 'pgsql' ? 'postgres' : 'root';
+        $schema = $driver === 'pgsql' ? 'public' : $database;
+        $dsn = $driver === 'pgsql' ? "pgsql:host={$host};dbname={$database};sslmode=require" : "mysql:host={$host};dbname={$database}";
+        $options = [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION];
+        if ($driver === 'mysql') {
+            $options[PDO::MYSQL_ATTR_SSL_CIPHER] = 'DEFAULT';
+            $options[PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = false;
+        }
+        $admin = new PDO($dsn, $user, 'fixture-password', $options);
+        $admin->exec('DROP TABLE IF EXISTS pipeline_records');
+        $type = $driver === 'pgsql' ? ($timezoneAware ? 'timestamp with time zone' : 'timestamp without time zone') : 'datetime(6)';
+        $admin->exec('CREATE TABLE pipeline_records (id bigint primary key, modified_at ' . $type . ', amount decimal(18,2), label varchar(50), private_note text)');
+        $date = now()->subMinute()->format($timezoneAware ? 'Y-m-d H:i:sP' : 'Y-m-d H:i:s');
+        $insert = $admin->prepare('INSERT INTO pipeline_records (id, modified_at, amount, label) VALUES (?, ?, ?, ?)');
+        $insert->execute([1, $date, '12.30', 'first']);
+        $insert->execute([2, $date, '45.60', 'second']);
+        $row = $this->connection($driver);
+        $row->update(['host' => $host, 'database_name' => $database, 'username' => $user]);
+        $source = $row->sourceIdentifier();
+        $result = app(UpstreamSchemaCatalogSynchronizer::class)->sync($source);
+        $this->assertGreaterThanOrEqual(5, $result['columns']);
+        $this->artisan('business-mirror:register', [
+            'source' => $source, 'schema' => $schema, 'object' => 'pipeline_records', '--keys' => 'id',
+            '--columns' => 'id,modified_at,amount,label', '--watermark' => 'modified_at', '--enable-sync' => true,
+        ])->assertSuccessful();
+        $this->artisan('business-mirror:sync-tables')->assertSuccessful();
+        $dataset = app(BusinessMirrorDatasetRegistry::class)->get($source . '.' . $schema . '.pipeline_records');
+        $mirror = DB::connection('business_mirror')->table($dataset->targetTable());
+        $this->assertSame(2, $mirror->count());
+        $this->assertSame(2, (int) $mirror->orderBy('id')->offset(1)->value('id'));
+        $this->assertFalse(Schema::connection('business_mirror')->hasColumn($dataset->targetTable(), 'private_note'));
+        $admin->exec("UPDATE pipeline_records SET amount=99.50 WHERE id=1");
+        $insert->execute([3, $date, '6.70', 'third']);
+        $insert->execute([4, now()->addHour()->format($timezoneAware ? 'Y-m-d H:i:sP' : 'Y-m-d H:i:s'), '1.00', 'future']);
+        $this->artisan('business-mirror:sync-tables')->assertSuccessful();
+        $this->assertSame(3, DB::connection('business_mirror')->table($dataset->targetTable())->count());
+        $this->assertEquals(99.5, DB::connection('business_mirror')->table($dataset->targetTable())->where('id', 1)->value('amount'));
+        $pdo = UpstreamConnection::get($source);
+        $row->update(['enabled' => false]);
+        $page = app(BusinessMirrorDataReader::class)->paginate($dataset->key(), [], 2, 2);
+        $this->assertSame(3, $page['total']);
+        $this->assertSame(3, (int) $page['rows'][0]['id']);
+        $this->assertArrayNotHasKey('_mirror_key', $page['rows'][0]);
+        $filtered = app(BusinessMirrorDataReader::class)->paginate($dataset->key(), ['label' => 'first']);
+        $this->assertSame(1, $filtered['total']);
+        if ($driver === 'pgsql') {
+            $this->assertSame('on', $pdo->query('SHOW default_transaction_read_only')->fetchColumn());
+            $this->assertTrue((bool) $pdo->query('SELECT ssl FROM pg_stat_ssl WHERE pid=pg_backend_pid()')->fetchColumn());
+        } else {
+            $this->assertNotEmpty($pdo->query("SHOW SESSION STATUS LIKE 'Ssl_cipher'")->fetch(PDO::FETCH_NUM)[1]);
+        }
+        try {
+            $pdo->exec("INSERT INTO pipeline_records (id) VALUES (99)");
+            $this->fail('The native upstream connection must reject writes.');
+        } catch (PDOException $e) {
+            $this->assertStringContainsString('read', strtolower($e->getMessage()));
+        }
+    }
+
+    public static function nativeDrivers(): array
+    {
+        return [['pgsql'], ['mysql'], ['pgsql', true], ['mysql', false, 'caiwu-pipeline-mariadb']];
+    }
+}

tests/Unit/EcommerceFinance/InstallationDetailMirrorRepositoryTest.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace Tests\Unit\EcommerceFinance;
+
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Modules\EcommerceFinance\Repositories\GenericBusinessMirrorRepository;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
+use Modules\EcommerceFinance\Services\BusinessMirrorDatasetRegistry;
+use Tests\TestCase;
+
+class InstallationDetailMirrorRepositoryTest extends TestCase
+{
+    private InstallationDetailMirrorRepository $repository;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        config(['database.connections.business_mirror'=>['driver'=>'sqlite','database'=>':memory:','prefix'=>''], 'upstream_mirrors.connection'=>'business_mirror']);
+        DB::purge('business_mirror');
+        $definitions=[];
+        foreach ([InstallationDetailMirrorRepository::DATASET=>'fixture_install',InstallationDetailMirrorRepository::ITEM_DATASET=>'fixture_items'] as $key=>$table) {
+            $definitions[$key]=['source_key'=>'jiansun','schema'=>'dbo','object'=>explode('.',$key)[2],'target'=>$table,'keys'=>['Id']];
+        }
+        config(['upstream_mirrors.datasets'=>$definitions]);
+        $schema=Schema::connection('business_mirror');
+        $schema->create('business_mirror_table_states',function(Blueprint $t){$t->string('dataset_key')->primary();$t->dateTime('initial_completed_at')->nullable();});
+        $schema->create('fixture_install',function(Blueprint $t){
+            $t->integer('Id');
+            foreach(['SourceGuid','OrderNum','ordernum_id','shop_name','SubmitTime','kfshTime','cwshTime','apistatus','kfsh','cwsh','BidStatus','costtaker','installComplete','Delete','installCompanyName','TypeDto'] as $c) $t->string($c)->nullable();
+            $t->integer('StatusId')->default(0);
+            foreach(['installcost','settleAmount','acceptAmount'] as $c) $t->decimal($c,14,2)->default(0);
+        });
+        $schema->create('fixture_items',function(Blueprint $t){$t->integer('Id');$t->string('guid');$t->string('shopproid');$t->string('Sourceno')->nullable();});
+        foreach(array_keys($definitions) as $key) DB::connection('business_mirror')->table('business_mirror_table_states')->insert(['dataset_key'=>$key,'initial_completed_at'=>'2026-08-01']);
+        DB::connection('business_mirror')->table('fixture_install')->insert([
+            ['Id'=>1,'SourceGuid'=>'A','OrderNum'=>'OLD','shop_name'=>'旧店','SubmitTime'=>'2026-08-01','installcost'=>500],
+            ['Id'=>2,'SourceGuid'=>'A','OrderNum'=>'NEW','shop_name'=>'测试店','SubmitTime'=>'2026-08-20 23:59:59','installcost'=>20],
+            ['Id'=>3,'SourceGuid'=>'B','OrderNum'=>'OTHER','shop_name'=>'其他店','SubmitTime'=>'2026-08-20','installcost'=>30],
+            ['Id'=>4,'SourceGuid'=>'C','OrderNum'=>'NEXT','shop_name'=>'测试店','SubmitTime'=>'2026-08-21','installcost'=>40],
+        ]);
+        DB::connection('business_mirror')->table('fixture_items')->insert([
+            ['Id'=>1,'guid'=>'A','shopproid'=>'PRODUCT-A'],['Id'=>2,'guid'=>'A','shopproid'=>'PRODUCT-A'],
+        ]);
+        $this->repository=new InstallationDetailMirrorRepository(new GenericBusinessMirrorRepository(app('db')),new BusinessMirrorDatasetRegistry());
+    }
+
+    public function test_filters_apply_to_deduplicated_list_count_and_summary(): void
+    {
+        $filters=['shop_name'=>'测试店'];
+        $page=$this->repository->paginate(2,1,$filters);
+        $this->assertSame(2,$page['total']);
+        $this->assertSame(2,$page['data'][0]['id']);
+        $this->assertSame(60.0,$this->repository->summary($filters)['requested']);
+        $filters['created_to']='2026-08-20';
+        $this->assertSame(1,$this->repository->paginate(1,50,$filters)['total']);
+        $this->assertSame(20.0,$this->repository->summary($filters)['requested']);
+        $this->assertSame(0,$this->repository->paginate(1,50,['shop_name'=>"' OR 1=1 --"])['total']);
+    }
+
+    public function test_product_filter_does_not_multiply_main_rows(): void
+    {
+        $filters=['product_id'=>'PRODUCT-A'];
+        $this->assertSame(1,$this->repository->paginate(1,50,$filters)['total']);
+        $this->assertSame(20.0,$this->repository->summary($filters)['requested']);
+        $this->assertSame('NEW',$this->repository->details('A')['data'][0]['transaction_no']);
+        $this->assertSame([],$this->repository->details('missing')['data']);
+    }
+
+    public function test_status_filters_and_child_limit_are_explicit(): void
+    {
+        DB::connection('business_mirror')->table('fixture_install')->where('Id',2)->update(['kfsh'=>'1','Delete'=>'0','StatusId'=>2]);
+        $this->assertSame(1,$this->repository->paginate(1,50,['customer_review'=>'1','delete_status'=>'0','arranged_status'=>'1'])['total']);
+        $rows=[];for($i=1;$i<=101;$i++)$rows[]=['Id'=>$i+10,'guid'=>'B','shopproid'=>'P'.$i];
+        DB::connection('business_mirror')->table('fixture_items')->insert($rows);
+        $result=$this->repository->details('B');
+        $this->assertCount(100,$result['data']);
+        $this->assertTrue($result['has_more']);
+    }
+
+    public function test_end_date_alone_is_valid_and_invalid_status_is_rejected(): void
+    {
+        request()->merge(['created_to'=>'2026-08-20']);
+        $this->assertSame(['created_to'=>'2026-08-20'],InstallationDetailMirrorRepository::requestFilters());
+        request()->merge(['arranged_status'=>'unexpected']);
+        $this->expectException(\Illuminate\Validation\ValidationException::class);
+        InstallationDetailMirrorRepository::requestFilters();
+    }
+}

tests/Unit/EcommerceFinance/StoreReportRepositoryTest.php

@@ -0,0 +1,158 @@
+<?php
+
+namespace Tests\Unit\EcommerceFinance;
+
+use App\Business\UpstreamBusinessInformation;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Mockery;
+use Modules\EcommerceFinance\Repositories\BusinessInformationMirrorRepository;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
+use Modules\EcommerceFinance\Repositories\StoreReportRepository;
+use Modules\EcommerceFinance\Services\UpstreamQueryCacheFactory;
+use RuntimeException;
+use Tests\TestCase;
+
+class StoreReportRepositoryTest extends TestCase
+{
+    private StoreReportRepository $repository;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        config([
+            'database.connections.business_mirror' => ['driver' => 'sqlite', 'database' => ':memory:', 'prefix' => ''],
+            'upstream_mirrors.connection' => 'business_mirror',
+        ]);
+        DB::purge('business_mirror');
+        $this->createTables();
+        DB::connection('business_mirror')->table('store_report_import_states')->insert([
+            ['dataset_key' => StoreReportRepository::BILLS_DATASET, 'status' => 'succeeded', 'active_generation' => 'bills-v1'],
+            ['dataset_key' => StoreReportRepository::LIFECYCLES_DATASET, 'status' => 'succeeded', 'active_generation' => 'lifecycles-v1'],
+        ]);
+        $this->repository = new StoreReportRepository(app('db'));
+    }
+
+    public function test_lifecycle_boundaries_split_monthly_income_without_double_counting(): void
+    {
+        $db = DB::connection('business_mirror');
+        $db->table('store_report_lifecycle_rows')->insert([
+            $this->lifecycle(1, '店铺A', '主体甲', '2026-05-01', '2026-07-01'),
+            $this->lifecycle(2, '店铺A', '主体乙', '2026-07-01', null),
+        ]);
+        $db->table('store_report_bill_rows')->insert([
+            $this->bill(1, '店铺A', '2026-04-30 23:59:59', 9),
+            $this->bill(2, '店铺A', '2026-05-01 00:00:00', 100),
+            $this->bill(3, '店铺A', '2026-06-30 23:59:59', 60),
+            $this->bill(4, '店铺A', '2026-07-01 00:00:00', 70),
+            $this->bill(5, '店铺A', '2026-08-01 00:00:00', 80),
+            $this->bill(6, '店铺A', '2027-01-01 00:00:00', 5),
+        ]);
+
+        $rows = $this->repository->rows([
+            ['erp_store_name' => '店铺A', 'store_id' => 'STORE-001', 'company_name' => '旧主体', 'store_status' => '3'],
+        ], 2026);
+
+        $this->assertSame(['主体甲', '主体乙'], array_column($rows, 'entity'));
+        $this->assertSame('STORE-001', $rows[0]['store_id']);
+        $this->assertSame([160.0, 155.0], array_column($rows, 'period_sales'));
+        $this->assertSame([100.0, 0.0], array_column($rows, 'sales_05'));
+        $this->assertSame([0.0, 70.0], array_column($rows, 'sales_07'));
+        $this->assertSame(['关店中', '关店中'], array_column($rows, 'status'));
+    }
+
+    public function test_failed_refresh_keeps_the_previous_active_generation_readable(): void
+    {
+        DB::connection('business_mirror')->table('store_report_import_states')
+            ->where('dataset_key', StoreReportRepository::BILLS_DATASET)
+            ->update(['status' => 'failed', 'pending_generation' => null]);
+        DB::connection('business_mirror')->table('store_report_bill_rows')->insert(
+            $this->bill(1, '店铺A', '2026-05-03 12:00:00', 25.5),
+        );
+
+        $rows = $this->repository->rows([
+            ['erp_store_name' => '店铺A', 'company_name' => '公司表主体', 'opened_at' => '2026-05-01'],
+        ], 2026);
+
+        $this->assertSame(25.5, $rows[0]['period_sales']);
+        $this->assertSame(25.5, $rows[0]['sales_05']);
+        $this->assertSame('公司表主体', $rows[0]['entity']);
+    }
+
+    public function test_missing_first_import_is_reported_instead_of_returning_misleading_zeroes(): void
+    {
+        DB::connection('business_mirror')->table('store_report_import_states')
+            ->where('dataset_key', StoreReportRepository::BILLS_DATASET)->delete();
+
+        $this->expectException(RuntimeException::class);
+        $this->expectExceptionMessage('尚未完成首次导入');
+        $this->repository->rows([['erp_store_name' => '店铺A']], 2026);
+    }
+
+    public function test_upstream_business_information_exposes_shared_store_report_rows(): void
+    {
+        DB::connection('business_mirror')->table('store_report_lifecycle_rows')->insert([
+            $this->lifecycle(1, '店铺A', '主体甲', '2026-05-01', null),
+        ]);
+        DB::connection('business_mirror')->table('store_report_bill_rows')->insert([
+            $this->bill(1, '店铺A', '2026-06-30 23:59:59', 60),
+        ]);
+        $mirror = Mockery::mock(BusinessInformationMirrorRepository::class);
+        $mirror->shouldReceive('ready')->with('store-information.read')->andReturnTrue();
+        $mirror->shouldReceive('allStores')->once()->andReturn([[
+            'erp_store_name' => '店铺A', 'company_name' => '公司表主体', 'store_status' => '3',
+        ]]);
+        $service = new UpstreamBusinessInformation(
+            Mockery::mock(UpstreamQueryCacheFactory::class),
+            $mirror,
+            Mockery::mock(InstallationDetailMirrorRepository::class),
+            $this->repository,
+        );
+
+        $paginator = $service->paginate('store-management', 'store-report', 50);
+
+        $this->assertSame(1, $paginator->total());
+        $this->assertSame('主体甲', $paginator->items()[0]->entity);
+        $this->assertSame(60.0, $paginator->items()[0]->period_sales);
+    }
+
+    private function createTables(): void
+    {
+        $schema = Schema::connection('business_mirror');
+        $schema->create('store_report_import_states', function (Blueprint $table): void {
+            $table->string('dataset_key')->primary();
+            $table->string('status');
+            $table->string('active_generation')->nullable();
+            $table->string('pending_generation')->nullable();
+        });
+        $schema->create('store_report_bill_rows', function (Blueprint $table): void {
+            $table->increments('id');
+            $table->string('generation');
+            $table->string('store_name');
+            $table->dateTime('occurred_at')->nullable();
+            $table->decimal('income', 20, 4)->default(0);
+        });
+        $schema->create('store_report_lifecycle_rows', function (Blueprint $table): void {
+            $table->increments('id');
+            $table->string('generation');
+            $table->string('erp_store_name');
+            $table->string('company_name')->nullable();
+            $table->dateTime('effective_at')->nullable();
+            $table->dateTime('expires_at')->nullable();
+        });
+    }
+
+    private function bill(int $id, string $store, string $time, float $income): array
+    {
+        return ['id' => $id, 'generation' => 'bills-v1', 'store_name' => $store, 'occurred_at' => $time, 'income' => $income];
+    }
+
+    private function lifecycle(int $id, string $store, string $company, ?string $from, ?string $to): array
+    {
+        return [
+            'id' => $id, 'generation' => 'lifecycles-v1', 'erp_store_name' => $store,
+            'company_name' => $company, 'effective_at' => $from, 'expires_at' => $to,
+        ];
+    }
+}

tests/Unit/EcommerceFinance/UpstreamBusinessInformationTest.php

@@ -6,6 +6,7 @@ use App\Business\UpstreamBusinessInformation;
 use Closure;
 use Mockery;
 use Modules\EcommerceFinance\Repositories\BusinessInformationMirrorRepository;
+use Modules\EcommerceFinance\Repositories\InstallationDetailMirrorRepository;
 use Modules\EcommerceFinance\Services\UpstreamQueryCache;
 use Modules\EcommerceFinance\Services\UpstreamQueryCacheFactory;
 use Tests\TestCase;
@@ -20,6 +21,7 @@ class UpstreamBusinessInformationTest extends TestCase
         string $page,
         string $scope,
     ): void {
+        config(['upstreams.local_configuration.enabled' => true]);
         $cache = new class extends UpstreamQueryCache {
             public array $calls = [];
 
@@ -49,7 +51,7 @@ class UpstreamBusinessInformationTest extends TestCase
         $mirror = Mockery::mock(BusinessInformationMirrorRepository::class);
         $mirror->shouldReceive('ready')->once()->with($scope)->andReturnFalse();
 
-        $information = new class($caches, $mirror) extends UpstreamBusinessInformation {
+        $information = new class($caches, $mirror, Mockery::mock(InstallationDetailMirrorRepository::class)) extends UpstreamBusinessInformation {
             public array $snapshots = [];
 
             public function snapshot(string $scope, array $parameters): array
@@ -78,6 +80,7 @@ class UpstreamBusinessInformationTest extends TestCase
         string $page,
         string $scope,
     ): void {
+        config(['operations_replica.enabled' => false, 'upstreams.stored_configuration.enabled' => false]);
         $cache = new class extends UpstreamQueryCache {
             public function __construct() {}
 
@@ -99,7 +102,7 @@ class UpstreamBusinessInformationTest extends TestCase
         ]);
 
         $this->app['request']->merge(['page' => 2]);
-        $paginator = (new UpstreamBusinessInformation($caches, $mirror))
+        $paginator = (new UpstreamBusinessInformation($caches, $mirror, Mockery::mock(InstallationDetailMirrorRepository::class)))
             ->paginate($section, $page, 25);
 
         $this->assertSame(2, $paginator->currentPage());
@@ -107,6 +110,19 @@ class UpstreamBusinessInformationTest extends TestCase
         $this->assertSame(10, $paginator->items()[0]->id);
     }
 
+    public function test_bootstrap_without_mirror_explains_shared_connection_instead_of_requesting_upstream_credentials(): void
+    {
+        config(['system_database.mode' => 'bootstrap', 'upstreams.local_configuration.enabled' => false]);
+        $caches = Mockery::mock(UpstreamQueryCacheFactory::class);
+        $caches->shouldNotReceive('forSource');
+        $mirror = Mockery::mock(BusinessInformationMirrorRepository::class);
+        $mirror->shouldReceive('ready')->once()->with('store-information.read')->andReturnFalse();
+        $this->expectException(\Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException::class);
+        $this->expectExceptionMessage('无需另配上游 SQL Server');
+        (new UpstreamBusinessInformation($caches, $mirror, Mockery::mock(InstallationDetailMirrorRepository::class)))
+            ->paginate('store-management', 'basic-information');
+    }
+
     public static function businessInformationPages(): array
     {
         return [

tests/Unit/EcommerceFinance/UpstreamDatabaseProbeTest.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Tests\Unit\EcommerceFinance;
+
+use Mockery;
+use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
+use Modules\EcommerceFinance\Services\UpstreamDatabaseProbe;
+use PDO;
+use PDOException;
+use PDOStatement;
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException;
+
+class UpstreamDatabaseProbeTest extends TestCase
+{
+    use MockeryPHPUnitIntegration;
+
+    private function connection(): array
+    {
+        return ['host' => 'db.example.test', 'port' => 25432, 'database' => "test' database",
+            'username' => 'reader', 'password' => 'fixture-secret', 'connect_timeout' => 5, 'query_timeout' => 120];
+    }
+
+    public function test_postgres_probe_uses_the_shared_connector_and_one_select(): void
+    {
+        $statement = Mockery::mock(PDOStatement::class);
+        $statement->shouldReceive('fetchColumn')->once()->andReturn(1);
+        $statement->shouldReceive('closeCursor')->once();
+        $pdo = Mockery::mock(PDO::class);
+        $pdo->shouldReceive('query')->once()->with('SELECT 1')->andReturn($statement);
+        $probe = Mockery::mock(UpstreamDatabaseProbe::class)->makePartial()->shouldAllowMockingProtectedMethods();
+        $probe->shouldReceive('connect')->once()->with('pgsql', $this->connection())->andReturn($pdo);
+        $probe->probe('pgsql', $this->connection(), '测试库');
+    }
+
+    public function test_driver_error_never_exposes_credentials(): void
+    {
+        $probe = Mockery::mock(UpstreamDatabaseProbe::class)->makePartial()->shouldAllowMockingProtectedMethods();
+        $probe->shouldReceive('connect')->once()->andThrow(new PDOException('fixture-secret private driver detail'));
+        try {
+            $probe->probe('pgsql', $this->connection(), '测试库');
+            $this->fail('Expected sanitized connection error');
+        } catch (ServiceUnavailableHttpException $exception) {
+            $this->assertStringContainsString('上游只读连接失败', $exception->getMessage());
+            $this->assertStringNotContainsString('fixture-secret', $exception->getMessage());
+            $this->assertNull($exception->getPrevious());
+        }
+    }
+
+    public function test_unsupported_driver_is_not_probed(): void
+    {
+        $this->expectException(ServiceUnavailableHttpException::class);
+        $this->expectExceptionMessage('不支持此数据库类型');
+        (new UpstreamDatabaseProbe())->probe('unknown', [], '测试库');
+    }
+}

tests/Unit/Utilities/SystemDatabasePersistenceTest.php

@@ -9,6 +9,51 @@ use Tests\TestCase;
 
 class SystemDatabasePersistenceTest extends TestCase
 {
+    public function test_switch_replaces_all_legacy_connection_routes_and_duplicate_keys(): void
+    {
+        $environmentPath = storage_path('framework/testing-legacy-routes.env');
+        $original = "DB_HOST=mysql\nDB_HOST_READ=old-read\nDB_HOST_WRITE=old-write\n"
+            . "DATABASE_URL=mysql://fixture:fixture@old-url/old_database\nDB_SOCKET=/tmp/old.sock\n"
+            . "DB_HOST=old-duplicate\nSYSTEM_DATABASE_MODE=bootstrap\nUNRELATED_OPTION=keep\n"
+            . "BUSINESS_MIRROR_DB_HOST=old-mirror\nBUSINESS_MIRROR_DB_HOST_READ=old-mirror-read\nBUSINESS_MIRROR_DB_HOST_WRITE=old-mirror-write\nBUSINESS_MIRROR_DB_PORT=13306\nBUSINESS_MIRROR_DB_SOCKET=/tmp/mirror.sock\n";
+        file_put_contents($environmentPath, $original);
+        $configuration = new class($environmentPath) extends SystemDatabaseConfiguration {
+            public array $verified = [];
+            protected function runFreshVerification(string $command): void
+            {
+                $this->verified = $this->freshVerificationEnvironment();
+            }
+            protected function clearConfigurationCache(): void {}
+        };
+        try {
+            $backup = $configuration->persist([
+                'host' => 'shared.example.test', 'port' => 8443, 'database' => 'shared_system',
+                'username' => 'fixture_user', 'password' => 'fixture_password', 'prefix' => '',
+                'tls_required' => true, 'tls_verify_server_cert' => false,
+                'mirror_database' => 'caiwu_business_mirror',
+            ]);
+            $saved = \Dotenv\Dotenv::parse(file_get_contents($environmentPath));
+            $this->assertSame('shared.example.test', $saved['BUSINESS_MIRROR_DB_HOST']);
+            $this->assertSame('shared.example.test', $saved['BUSINESS_MIRROR_DB_HOST_READ']);
+            $this->assertSame('shared.example.test', $saved['BUSINESS_MIRROR_DB_HOST_WRITE']);
+            $this->assertSame('8443', $saved['BUSINESS_MIRROR_DB_PORT']);
+            $this->assertSame('', $saved['BUSINESS_MIRROR_DB_SOCKET']);
+            $this->assertSame('caiwu_business_mirror', $saved['BUSINESS_MIRROR_DB_DATABASE']);
+            $this->assertSame('fixture_password', $configuration->verified['BUSINESS_MIRROR_DB_PASSWORD']);
+            foreach (['DB_HOST', 'DB_HOST_READ', 'DB_HOST_WRITE'] as $key) {
+                $this->assertSame('shared.example.test', $saved[$key]);
+                $this->assertSame('shared.example.test', $configuration->verified[$key]);
+            }
+            $this->assertSame('', $saved['DATABASE_URL']);
+            $this->assertSame('', $saved['DB_SOCKET']);
+            $this->assertSame('keep', $saved['UNRELATED_OPTION']);
+            $this->assertSame($original, file_get_contents($backup));
+        } finally {
+            @unlink($environmentPath);
+            if (isset($backup)) @unlink($backup);
+        }
+    }
+
     public function test_failed_fresh_process_verification_restores_original_environment(): void
     {
         $environmentPath = storage_path('framework/testing-system-database.env');