feat: 上线前安全加固与发布工程化；appmall 由插件迁移为独立应用

安全（P0） - 发布包签名：新增 scripts/package_keygen.php、scripts/package_verify.php、 ywxapp\service\PackageVerifier；FrameworkService::apply() 解压前强制验签（ywxapp.framework_package_verify，默认开启） - JWT 收紧：config/jwt.php 移除公开默认密钥，JwtService::assertStrongSecret() 校验非空 / 长度≥32 / 已知弱值；.env.production.example 键名由 JWT_SECRET_KEY 修正为 JWT_SECRET - /api/v1/Article：免登录白名单收窄为只读接口，写操作字段白名单 + assertOwner() 越权校验 - 开发者令牌：查找接口不再回显明文、统一失败文案 + 限流 - TemplateInstaller：文件名白名单 + realpath 归一化 + 目录内断言，修复 Zip Slip；补 use ZipArchive - 后台登录：接入验证码、失败锁定与登录限流（config/ratelimit.php） - 缓存 / Session 驱动可由 .env 覆盖（CACHE_DRIVER / SESSION_TYPE），集群部署改 redis - paycenter 支付日志开关改为 PAY_LOG，不再跟随 APP_DEBUG 工程化 / 交付 - 新增 CHANGELOG.md 与 .env.production.example；composer.lock 入库锁定依赖版本 - 插件离线安装 CLI 增加 --uid，后台上传安装透传 uid，付费插件授权校验可通过 - 授权拒绝文案区分「未携带 uid」与「未找到有效授权」，便于排障 - .gitignore 放行 .env.production.example / .env.addon.example / .gitattributes / public/.htaccess 结构 - appmall 由 addon/appmall 迁移为独立应用 app/appmall（市场 / 开发者中心 / 审核 / 分润）
2026-10-22 00:53:39 +08:00
1 parent 1d49e6f5ee
commit 18101cf11a
@@ -0,0 +1,101 @@
+<?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 addon\docs\controller;
+
+use addon\docs\model\DocsDoc;
+use addon\docs\model\DocsProject;
+use addon\docs\model\DocsVersion;
+
+/**
+ * 站点地图（前台 SEO 用）
+ *
+ * 输出最简版 sitemap.xml：
+ *   - 首页 / 文档中心首页
+ *   - 所有启用项目的入口
+ *   - 所有启用项目下「默认版本」且 status=1 的文档（非默认版本不收录，避免长短 URL 双内容）
+ *
+ * 内容量大可后续改成分片/分项目，本版本供搜索引擎基本覆盖即可。
+ *
+ * @author ywxapp <admin@ywxapp.cn>
+ */
+class Sitemap extends DocsFrontend
+{
+    /**
+     * GET /sitemap.xml
+     */
+    public function index()
+    {
+        $base = docs_base_url();
+
+        $urls = [];
+        // 首页
+        $urls[] = ['loc' => $base . '/', 'priority' => '1.0'];
+        // 各项目入口
+        $projects = DocsProject::enabledList();
+        foreach ($projects as $project) {
+            $urls[] = [
+                'loc'      => $base . '/' . $project['name'],
+                'priority' => '0.8',
+                'lastmod'  => $this->dateOf((int) ($project['update_at'] ?? 0)),
+            ];
+
+            // 该项目默认版本的可阅读文档（避免短/长地址双内容）
+            $version = DocsVersion::resolve((int) $project['id'], (string) ($project['default_version'] ?? ''));
+            if (!$version) {
+                continue;
+            }
+            $docs = DocsDoc::where('project_id', $project['id'])
+                ->where('version_id', $version->id)
+                ->where('status', 1)
+                ->where('is_dir', 0)
+                ->field('name,update_at')
+                ->order('update_at', 'desc')
+                ->limit(5000)
+                ->select()
+                ->toArray();
+            foreach ($docs as $doc) {
+                $urls[] = [
+                    'loc'      => $base . '/' . $project['name'] . '/' . rawurlencode($doc['name']),
+                    'priority' => '0.6',
+                    'lastmod'  => $this->dateOf((int) ($doc['update_at'] ?? 0)),
+                ];
+            }
+        }
+
+        $xml = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
+        $xml .= '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
+        foreach ($urls as $u) {
+            $xml .= '<url>';
+            $xml .= '<loc>' . htmlspecialchars((string) $u['loc'], ENT_XML1, 'UTF-8') . '</loc>';
+            if (!empty($u['lastmod'])) {
+                $xml .= '<lastmod>' . $u['lastmod'] . '</lastmod>';
+            }
+            if (isset($u['priority'])) {
+                $xml .= '<priority>' . $u['priority'] . '</priority>';
+            }
+            $xml .= '</url>';
+        }
+        $xml .= '</urlset>';
+
+        return response($xml, 200, ['Content-Type' => 'application/xml; charset=utf-8']);
+    }
+
+    /**
+     * 时间戳 → W3C 日期（空值返回 null）
+     */
+    protected function dateOf(int $ts): ?string
+    {
+        if ($ts <= 0) {
+            return null;
+        }
+        return date('Y-m-d', $ts);
+    }
+}