# 深圳市云创芯电子有限公司 · Laravel 12 + Vue3(CDN) 官网

一套**零构建、零 Node**的轻量全栈站点，专为宝塔面板（Nginx + PHP 8.3 + MySQL 5.7）设计，强调安全、稳定、易移植。

## 功能模块

| 模块 | 前台 | 后台管理 |
|------|------|----------|
| 产品中心 | 列表 + 搜索 + 分类筛选 + 详情页 | CRUD + 分类 + 草稿/发布 |
| 技术文章 | 列表 + 搜索 + 分类筛选 + 详情页 | CRUD + 分类 + 作者 + 发布时间 |
| 术语库 | 列表 + 搜索 + 详情页 | CRUD + 别名 + 分类 |
| 技术论坛 | 版块 + 帖子 + 回复 + 发帖/回复 | 版块管理 + 帖子删除 + 锁帖 |
| 联系我们 | Vue 异步表单 + CSRF + 限流 | 留言列表 + 详情 + 删除 |
| 用户系统 | 注册 + 登录 + 退出 + 个人设置 | 用户列表 + 管理员提权/降权 + 删除 |
| 用户等级 | 积分驱动 L1–L5 徽章 + 进度条 | 用户列表可见积分 |
| 账号安全 | `/settings` 自助修改密码（需验证当前密码） | - |
| 站点设置 | 站名 / Logo / Favicon / ICP 全站生效 | `/admin/settings` 统一维护 |
| SEO | 每页独立 title + description，缺省回落全局 | 文章/产品表单内逐条填写 |
| 文章版式 | 三种阅读版式（标准 / 宽栏 / 文档） | 发布时下拉选择 |
| 仪表盘 | - | 统计概览 + 最新留言/帖子 |

## 技术选型

| 项 | 方案 |
|----|------|
| 后端 | Laravel 12（PHP 8.3） |
| 前端交互 | Vue 3.5.13 全局构建，本地自托管（无 CDN 依赖） |
| 样式 | 纯 CSS + 设计令牌（:root 变量），全站只用 var() |
| 视图 | Blade 服务端渲染（SEO 友好，首屏快） |
| 图标 | 内联 SVG 组件（统一描边，16/20/24 三档尺寸） |
| 前端构建 | **无构建**（无 npm / Vite / Tailwind） |
| 数据库 | MySQL 5.7（utf8mb4_unicode_ci） |
| RBAC | is_admin 布尔标志位 + Admin 中间件 + /admin 路由组 |

## 目录结构

```
app/
  Http/Controllers/
    HomeController.php           首页（产品+文章）
    ProductController.php         产品列表/详情
    ArticleController.php         文章列表/详情
    GlossaryController.php        术语列表/详情
    ForumController.php           论坛版块/帖子/回复
    ContactController.php        联系表单（Vue 异步 + 限流）
    HealthController.php          /api/health 健康检查
    Auth/LoginController.php      登录 / 退出
    Auth/RegisterController.php   注册
    Auth/SettingsController.php   个人设置（修改密码）
    Admin/                        后台管理（10 个控制器，含站点设置）
  Http/Middleware/Admin.php       管理员中间件
  Models/                         10 个模型（含关系和 scope）
database/
  migrations/                     16 个迁移
  seeders/                        7 个 seeder（全部幂等，可重复执行）
public/
  css/app.css                     设计令牌 + 完整组件样式
  js/app.js                       Vue 挂载（联系表单）
  js/vendor/vue.global.prod.js    自托管 Vue 3.5.13
resources/views/
  layouts/app.blade.php           前台布局
  components/icon.blade.php       内联 SVG 图标组件
  home.blade.php                  首页
  products/ articles/ glossary/   前台展示页
  forum/                          论坛页面
  auth/                           登录/注册/个人设置
  admin/                          后台管理页面（layout + 16 个子页面）
routes/web.php                    前台 + /admin 路由组
```

## 安全要点

- 全站 CSRF（`@csrf` + 前端 `X-CSRF-TOKEN`）
- 表单服务端校验（`validate`），Vue 仅做体验增强
- 联系表单频率限制：同一 IP 60 秒内最多 5 次
- 密码 `bcrypt`（`hashed` cast），会话 cookie `secure` + `http_only` + `encrypt`
- Blade `{{ }}` 自动转义，防 XSS
- Eloquent 参数化查询，防 SQL 注入
- Admin 中间件保护所有后台路由

## 宝塔部署（3 步）

### 第 1 步：建站点 + 数据库

宝塔 → 网站 → 添加站点：
- 根目录指向 `public/`
- PHP 版本：8.3
- 同时建好 MySQL 数据库（排序规则 `utf8mb4_unicode_ci`）

### 第 2 步：传代码 + 安装

```bash
cd /www/wwwroot/cloud-chip.cn

# 配置 Composer 镜像（国内服务器）
composer config -g repos.packagist.org composer https://mirrors.aliyun.com/composer/

# 安装依赖（必须先于 artisan 命令）
composer install --no-dev --optimize-autoloader --no-interaction

# 配置环境
cp .env.example .env
# 编辑 .env，填写：
#   DB_DATABASE=你的数据库名
#   DB_USERNAME=你的数据库用户
#   DB_PASSWORD=你的数据库密码
#   APP_URL=https://cloud-chip.cn

# 生成密钥 + 迁移 + 种子数据
php artisan key:generate
php artisan migrate --force
php artisan db:seed --force

# 权限
chmod -R 755 storage bootstrap/cache
php artisan storage:link
```

或直接运行 `./install.sh`（自动完成上述全部步骤）。

### 第 3 步：配置伪静态

宝塔 → 站点设置 → 伪静态 → 选择 **Laravel** 模板。

### 注意事项

- **宝塔禁用函数**：PHP-8.3 设置 → 禁用函数，删除 `putenv, proc_open, proc_get_status, proc_close, popen` 并重启 PHP-FPM
- **运行时目录**：确保 `storage/` 和 `bootstrap/cache/` 对 www 用户可写（755）

## 默认管理员账号

Seeder 会自动创建管理员账号：
- 邮箱：`admin@cloud-chip.cn`
- 密码：`cloudchip2026`

**请在首次登录后立即修改密码**：登录后访问 `/settings` → 修改密码（需输入当前密码校验）。

## 数据库表

| 表名 | 说明 |
|------|------|
| users | 用户（is_admin 布尔 + points 积分） |
| settings | 站点级 key-value 配置（ICP / Logo / SEO 等） |
| password_reset_tokens | 密码重置令牌 |
| failed_jobs | 失败任务队列 |
| contact_messages | 联系表单留言 |
| categories | 分类（type: product/article） |
| products | 产品（软删） |
| articles | 文章（软删 + 发布时间） |
| glossary_terms | 术语 |
| forum_boards | 论坛版块 |
| forum_threads | 论坛帖子（软删 + 置顶 + 锁定） |
| forum_replies | 论坛回复（软删） |