# sptzkf

**Repository Path**: caodaimin/sptzkf

## Basic Information

- **Project Name**: sptzkf
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-18
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商品通知群

一套兼容 PHP 8.0 / MySQL 5.7 的多租户商品通知系统。平台管理员为客户开通独立账号；客户在后台发布文字和图片；第三方网站粘贴一行 `<script>` 代码后，即可在页面右下角展示带未读数字的商品通知入口。

## 已实现功能

- 平台总管理员创建、启停客户账号并重置密码。
- 每个租户一个独立账号、独立公开标识和严格的数据隔离。
- 发布、编辑、软删除通知；每条支持 5000 字和最多 9 张图片。
- JPEG、PNG、WebP 真实类型校验、GD 重编码、元数据清除及缩略图生成。
- 一行代码跨站安装，iframe 隔离宿主样式，无需开放 CORS。
- 3 秒消息轮询，新增、编辑、删除均通过变更游标准确同步。
- 访客端历史分页、图片灯箱、响应式全屏和宿主网站本地未读状态。
- 主题色、群名称、按钮文字、左下/右下位置及手机端按钮高度配置。
- CSRF、Argon2id、三层登录限流、会话超时与轮换、安全审计、输出转义和上传目录防执行。

## 环境要求

- PHP 8.0 及以上，启用 `pdo_mysql`、`mbstring`、`fileinfo`、`gd`、`json`、`session`。
- MySQL 5.7 及以上。
- Apache 2.4（启用 `mod_rewrite`）或 Nginx。
- 生产环境必须使用 HTTPS。

## 安装

1. 创建本地配置：

   ```powershell
   Copy-Item config/local.php.example config/local.php
   ```

   编辑 `config/local.php`，填写数据库账号。系统会根据当前访问域名、端口、子目录和 HTTPS 动态生成后台链接及安装代码，不需要配置固定域名。该文件已被 Git 忽略。

   如果 HTTPS 在 CDN 或反向代理层终止，请将 `trust_proxy_headers` 设为 `true`；若 PHP/Nginx 直接处理 HTTPS，则保持 `false`。生产环境还可以用 `allowed_hosts` 限制允许的域名。

2. 创建或升级数据库。命令会安装到配置中选定的数据库，不会自动创建数据库。

   ```powershell
   php bin\migrate.php
   ```

3. 创建或更新首个平台总管理员：

   ```powershell
   php bin\create-admin.php admin "请替换为至少10位且含三类字符的强密码"
   ```

4. 确保 `storage/uploads` 可被 PHP 进程写入。Apache 会读取仓库内的 `.htaccess`；Nginx 可参考 `deploy/nginx.conf.example`。

5. 打开系统首页并登录。平台管理员先创建客户账号，客户登录后即可发布通知和复制安装代码。

## 第三方网站安装

租户后台会生成专属代码：

```html
<script async src="https://notify.example.com/widget.js"
        data-notify-key="48位租户公开标识"></script>
```

建议放在第三方网站的 `</body>` 之前。如果对方网站配置了 CSP，需要允许通知系统域名：

```text
script-src ... https://notify.example.com;
frame-src ... https://notify.example.com;
```

当前版本按产品约定不限制安装域名，通知内容应视为公开信息。不要在通知中发布内部资料、个人敏感信息或仅限会员查看的内容。

## 公开接口

- `api/widget-init.php`：组件配置、最新 20 条消息、未读数和当前游标。
- `api/widget-history.php`：使用 `before_id` 向前分页。
- `api/widget-changes.php`：使用 `after_cursor` 拉取新增、修改和删除事件。

接口只接受租户公开标识，不输出账号、内部租户 ID 或服务器真实文件路径。后台接口全部使用 Session、CSRF 和租户归属检查。

## 验证

不连接数据库的基础安全与图片处理检查：

```powershell
php tests\run.php
```

语法检查：

```powershell
Get-ChildItem -Recurse -Filter *.php | ForEach-Object { php -l $_.FullName }
```

完整验收需要先配置测试数据库，再分别使用一个总管理员和两个租户账号验证跨租户隔离、发布、编辑、删除、历史分页和跨域嵌入。

## 生产说明

- 每次更新代码后先运行 `php bin/migrate.php`，确保新增配置字段已同步到数据库。
- 备份数据库和 `storage/uploads`，两者必须同步恢复。
- Web 根目录下的 `config`、`src`、`database`、`bin`、`views`、`tests`、`.git` 和日志目录必须拒绝公网访问。
- 图片目录必须禁止 PHP 等脚本执行；仓库已提供 Apache 规则和 Nginx 示例。
- 关闭 `expose_php` 和 Nginx `server_tokens`，数据库账号使用仅限本库的最小权限并设置高强度随机密码。
- 后台“安全审计”会显示最近的登录失败、锁定和敏感管理操作，应定期检查陌生 IP。
- 本版本容量目标为总计不超过 200 名同时加载组件的访客；更高并发应增加 Redis 缓存或升级为推送架构。