初始化

DEPLOY.md

@@ -0,0 +1,85 @@
+# 部署指南（深圳市云创芯电子有限公司 · Laravel 12）
+
+本包已包含 `vendor/`（Composer 依赖已安装），上传到服务器后**无需再跑 composer install** 即可运行。
+如需自行重装依赖，删除 `vendor/` 后执行 `composer install --no-dev --optimize-autoloader`。
+
+## 1. 上传与解压
+- 将 `cloud-chip-laravel-vue.tar.gz` 上传到服务器网站根目录（如 Baota 的 `/www/wwwroot/cloud-chip.cn/`）。
+- 解压：
+  ```bash
+  tar -xzf cloud-chip-laravel-vue.tar.gz -C /www/wwwroot/cloud-chip.cn/
+  ```
+
+## 2. 配置环境变量
+```bash
+cp .env.example .env
+# 用编辑器打开 .env，至少修改以下项：
+#   APP_URL=https://你的域名
+#   DB_DATABASE / DB_USERNAME / DB_PASSWORD
+#   APP_DEBUG=false
+#   SESSION_SECURE_COOKIE=true   # 启用了 HTTPS 才设 true
+```
+生成应用密钥：
+```bash
+php artisan key:generate
+```
+
+## 3. 数据库
+```bash
+php artisan migrate --force
+# 如需初始演示数据（产品/文章/术语等）：
+php artisan db:seed --force
+```
+> 本次发布包含新增迁移 `2026_08_02_000001_add_profile_fields_to_users_table`：
+> 在 `users` 表追加 `real_name / phone / company / industry` 四个资料字段（均允许为空）。
+> **首次部署或升级时务必执行 `migrate --force`**，否则详细注册收集到的字段无法落库。
+
+## 4. 存储软链（文章图片上传需要）
+```bash
+php artisan storage:link
+```
+这会把 `storage/app/public` 映射到 `public/storage`，使上传的图片可通过网页访问。
+
+## 5. 目录权限（Baota 面板或命令行）
+确保以下目录**可写**（命令行示例）：
+```bash
+chmod -R 755 storage bootstrap/cache
+# 若仍报权限错，再放宽到 775 / 777（仅限这两个目录）
+```
+> 文章配图、封面图通过 `/upload` 接口写入 `storage/app/public/uploads/{年}/{月}/`，
+> 该目录由上传时自动创建，且已随包带 `storage/app/public/.gitkeep`。
+> 上一步 `chmod 755 storage` 已覆盖此路径；若上传报「无法写入」，单独放宽：
+> `chmod -R 755 storage/app/public`
+
+## 6. Web 服务器（关键：docroot 必须是 public/）
+- **Nginx**：`root` 指向 `.../public;` 并加 Laravel 重写：
+  ```nginx
+  location / {
+      try_files $uri $uri/ /index.php?$query_string;
+  }
+  ```
+- **Apache**：本包已带 `public/.htaccess`，只要把站点根目录设为 `public/` 即可，无需额外配置。
+- ⚠️ **不要**用项目根的 `router.php` 跑生产（`router.php` 仅本地 `php -S` 调试用）。
+
+## 7. 上线检查
+- 访问首页、产品、文章、论坛、联系我们页均返回 200。
+- 后台入口 `/admin`（需管理员账号，任意后台角色可登录）。
+- 前台用户注册/登录在「论坛」页内；管理员登录在独立页面 `/admin/login`。
+
+## 8. SEO 与搜索引擎收录（sitemap / robots）
+上线后建议提交站点地图，加快收录：
+- **robots 协议**：访问 `/robots.txt` 自动返回（动态读取 `APP_URL`，无需手改域名），
+  已对前台全开放，并屏蔽 `/admin`、`/login`、`/register`、`/settings`、`/upload`、`/api` 等后台与用户接口。
+- **站点地图**：访问 `/sitemap.xml`（机读 XML，含首页/关于我们/产品服务/文章/术语库/论坛/联系我们 + 全部已发布产品、文章、术语）。
+- **提交地址**：
+  - 百度搜索资源平台：https://ziyuan.baidu.com/ → 站点管理 → 链接提交 → 自动提交（sitemap）填入 `https://你的域名/sitemap.xml`
+  - Google Search Console：https://search.google.com/search-console → Sitemaps 填入 `https://你的域名/sitemap.xml`
+- 上线检查项补一条：访问 `/robots.txt` 与 `/sitemap.xml` 均返回 200，且 `Sitemap:` 行域名与 `APP_URL` 一致。
+
+## 备注
+- 图标采用 x-icon（纯 SVG，无 emoji）；配色走 CSS 变量 token，未硬编码颜色。
+- **本次已上线功能**：
+  - 文章富文本编辑（Quill）+ 图片上传（/upload 接口）+ HTMLPurifier 净化，正文安全渲染 HTML。
+  - 详细注册：注册表单新增「真实姓名 / 手机号 / 公司名称 / 行业领域」四项（选填）。
+  - 会员等级徽章（`level-badge` 组件）：论坛帖子与回复署名、导航（桌面+移动端）、账户设置页均展示等级。
+- **仍待办**：微信扫码注册（本期未排期，暂未实现）。