快速开始
建站流程
SiteForge 采用「模板 + AI 生成 + 可视化编辑」的三段式建站流程：
- 选定行业模板后，系统自动载入该模板的区块结构（Hero、产品中心、工厂实力、资质证书、案例、FAQ、联系等）。
- AI 基于企业信息（名称、行业、主营产品）一次性生成全站文案与 SEO 元数据。
- 可视化编辑器支持拖拽调整、实时预览，无需任何代码基础。
- 支持多租户批量建站，可一键为多个企业生成独立站点与账号。
行业模板
系统内置 4 套行业模板，每套包含预设的区块组合与主题配色：
- 机械设备：制造业，含工厂实力、资质证书区块，主色蓝。
- 电子产品：科技，含应用案例区块，主色紫。
- 家具家居：家居，含工厂实景、工程案例区块，主色棕。
- 医疗器械：医疗，含医疗认证、临床案例区块，主色青。
管理员可在后台创建自定义模板，设置区块定义与主题默认值。
AI 内容生成
AI 生成依赖本地部署的 Ollama 服务，默认地址 http://localhost:11434/api/generate，通过环境变量 AI_SERVICE_URL 配置。
支持两类生成：
- 网站内容生成：输入企业名称、行业、主营产品，自动生成网站文案与产品描述。
- SEO 生成：基于企业与产品信息生成 title、description、keywords。
如未配置 Ollama，相关功能将不可用，但不影响手动编辑建站。
产品管理
每个网站独立管理产品，支持：
- 多级分类（树形结构）、排序、图片与视频。
- 规格（JSON）、价格范围、MOQ、单位、货币。
- 特色 / 热门 / 新品标记，用于首页推荐位。
- 中英双语名称、描述，配合多语言站点。
- 独立 SEO 关键词与描述。
询盘管理
站点访客通过联系表单提交询盘，后台统一管理：
- 记录访客姓名、公司、国家、邮箱、电话、留言、附件、意向产品与数量。
- 自动捕获来源页面 URL、IP、User-Agent。
- 状态流转：new → read → replied → archived。
- 支持后台回复，记录回复内容与时间。
- 预留 AI 分析字段，可扩展自动意图识别与智能回复。
多语言
支持 10 种语言：en、zh、de、fr、es、ja、ko、ar、pt、ru。每个网站可配置启用的语言与默认语言，产品、文章、企业资料均支持双语字段。
SEO 优化
每个网站按页面类型（首页、产品、文章等）独立配置 SEO：
- title / description / keywords。
- Open Graph（ogTitle、ogDescription、ogImage）用于社交分享。
- canonical URL、noindex / noFollow 控制。
- JSON-LD 结构化数据，提升搜索引擎富摘要。
在线支付
SaaS 订阅与外贸订单收款，支持 Stripe 与 PayPal：
- Stripe：Checkout Session、订阅、Webhook 回调（
/webhooks/stripe）。 - PayPal：沙箱 / 生产、订阅、Webhook 回调（
/webhooks/paypal）。 - 订单生命周期：PENDING → PAID → FAILED → CANCELLED → REFUNDED。
- 完整交易记录与幂等键，避免重复扣款。
- 租户可独立配置支付账户。
配置对应环境变量（STRIPE_SECRET_KEY、PAYPAL_CLIENT_ID 等）后即可启用。
API 概览
所有接口前缀 /api/v1，认证接口需 Authorization: Bearer <token>。
- 认证：
POST /auth/login、POST /auth/register - 网站：
/websites（CRUD、发布） - 产品 / 分类：
/websites/:id/products、/websites/:id/categories - 询盘：
POST /inquiries（访客公开提交）、/websites/:id/inquiries（后台） - 模板：
GET /templates - AI：
POST /ai/generate、POST /ai/generate-seo - 上传：
POST /upload - 支付：
GET /plans、POST /payment/:provider/create - Webhook：
POST /webhooks/stripe、POST /webhooks/paypal
健康检查：GET /health
部署
采用 Docker 单镜像部署，Nuxt SSR（3000）与 Go API（8080）同容器运行。容器内 Nuxt 通过 routeRules 将 /api、/webhooks、/uploads 反代到 Go 后端，对外仅需暴露 3000 端口。
数据卷：/app/data（SQLite）、/app/uploads（上传文件）、/app/.env（配置）。
CI/CD：推送到 main 触发 GitHub Actions 构建 → 推送镜像到 ACR → SSH 部署 :latest。
环境变量
关键配置项（完整列表见 backend/.env.example）：
SERVER_MODE：debug / release，release 下强制校验 JWT_SECRET。DB_DRIVER：sqlite / postgres。JWT_SECRET：JWT 密钥，生产环境必须为强随机值。AI_SERVICE_URL：Ollama 服务地址。STRIPE_SECRET_KEY/PAYPAL_CLIENT_ID/PAYPAL_SECRET：支付配置。UPLOAD_DIR：上传根目录。SITE_DOMAIN：子域名预览基准域名。
常见问题
默认账号是什么？
用户名 admin，密码 admin123。首次启动自动创建，登录后请尽快修改。
AI 生成不可用？
请确认已部署 Ollama 并配置 AI_SERVICE_URL。未配置时建站功能仍可手动编辑。
上传的图片无法访问？
检查 UPLOAD_DIR 目录权限与挂载，以及 Nuxt routeRules 是否将 /uploads/** 反代到后端。
支付回调 404？
确认 /webhooks/** 已被反代到 Go 后端（容器内 Nuxt routeRules 已配置）。