feat: 公共表更名 common/member 前缀 + 插件命令自动加载 + 版本 1.1.1

- 18 张公共表更名（addon/attachment/configure/links/spider_log/spider_stat/sms/notice/ad/task/prop/medal/help/card -> common_*，member_wallets->member_wallet，score_rule/score_log -> member_*，addon_config->common_addonconf），模型全部对齐新表名，Db 直引用清零 - Attachment 模型补表名绑定，修复富文本上传查 wxapp_attachment 1146 隐患 - install.sql + 迁移 SQL：backend_admin/backend_role delete_at 默认 0，修复软删除(NULL != 0)误过滤导致后台菜单为空 - AppService::boot() 支持插件 info.php 声明 commands 自动注册插件命令（psr-4 自动加载，坏类名自动跳过） - 各插件（haonav/mqttbroker/wxchat/articles/blog/forum 等）字段与配置同步调整 - 框架版本 1.1.0 -> 1.1.1
2026-08-20 20:19:15 +08:00
parent 303f548664
commit 1d49e6f5ee
395 changed files with 13342 additions and 2012 deletions
@@ -0,0 +1,132 @@
+<?php
+// +----------------------------------------------------------------------
+// | YwxApp [ WE CAN DO IT JUST THINK ]
+// +----------------------------------------------------------------------
+// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
+// +----------------------------------------------------------------------
+// | Author: ywxapp<admin@ywxapp.cn>
+// +----------------------------------------------------------------------
+
+declare(strict_types=1);
+
+namespace app\api\controller\v1;
+
+use think\facade\Filesystem;
+use ywxapp\controller\ApiBase;
+use ywxapp\model\SystemConfig;
+
+/**
+ * 通用基础接口（App 启动所需，聊天 / 商城等应用共用）
+ *
+ * 路由前缀：/api/v1/common/<action>
+ * 鉴权：config / init 公开；upload 需登录（防滥用）。
+ *
+ * @package app\api\controller\v1
+ */
+class Common extends ApiBase
+{
+    /**
+     * 免登录（公开）接口白名单。
+     *
+     * @var array<int, string>
+     */
+    protected $noNeedLogin = ['config', 'init'];
+
+    /**
+     * App 启动初始化数据（公开）。
+     *
+     * 返回站点基础信息、可用的注册方式开关、接口版本等，供客户端冷启动时读取。
+     *
+     * @return \think\Response JSON 响应，携带 site / register_methods / version
+     *
+     * @route GET /api/v1/common/init
+     */
+    public function init()
+    {
+        $config = $this->siteConfig();
+        $data = [
+            'site'             => $config,
+            'register_methods' => [
+                'password' => 1,
+                'sms'      => 1,
+                'email'    => 1,
+            ],
+            'version' => '1.0.0',
+        ];
+        return $this->apiSuccess($data);
+    }
+
+    /**
+     * 获取站点配置（公开）。
+     *
+     * 返回站点名称、Logo、备案号等基础配置。
+     *
+     * @return \think\Response JSON 响应，携带站点配置数组
+     *
+     * @route GET /api/v1/common/config
+     */
+    public function config()
+    {
+        return $this->apiSuccess($this->siteConfig());
+    }
+
+    /**
+     * 文件上传（需登录）。
+     *
+     * 接收 multipart/form-data 中的 file 字段，保存到本地存储并返回可访问 URL。
+     *
+     * @param \think\file\UploadedFile $file 上传的文件（form-data: file）
+     *
+     * @return \think\Response JSON 响应，成功携带 url / path
+     *
+     * @throws \Throwable 当文件存储失败时
+     *
+     * @route POST /api/v1/common/upload
+     */
+    public function upload()
+    {
+        $file = $this->request->file('file');
+        if (!$file) {
+            return $this->apiError('请选择上传文件');
+        }
+        try {
+            $path = Filesystem::disk('local')->putFile('uploads', $file);
+            $url  = Filesystem::disk('local')->url($path);
+            return $this->apiSuccess([
+                'url'  => $url,
+                'path' => $path,
+            ], '上传成功');
+        } catch (\Throwable $e) {
+            return $this->apiError('上传失败：' . $e->getMessage());
+        }
+    }
+
+    /**
+     * 读取站点配置。
+     *
+     * 优先从 SystemConfig 表读取，表不存在或字段缺失时回退到默认值。
+     *
+     * @return array<string, mixed> 站点配置数组（name / logo / icp）
+     */
+    protected function siteConfig(): array
+    {
+        $defaults = [
+            'name' => 'YwxApp',
+            'logo' => '',
+            'icp'  => '',
+        ];
+        try {
+            $rows = SystemConfig::column('value', 'name');
+            if ($rows) {
+                foreach ($defaults as $k => $v) {
+                    if (isset($rows[$k])) {
+                        $defaults[$k] = $rows[$k];
+                    }
+                }
+            }
+        } catch (\Throwable $e) {
+            // 表不存在时用默认值
+        }
+        return $defaults;
+    }
+}