# 活牛采购智能数字化系统 - 域名配置说明

## 域名配置总览

| 域名类型 | 域名地址 | 用途 | 环境 |
|---------|---------|------|------|
| 后端API | `wapi.nanniwan.com` | 提供RESTful API服务 | 生产环境 |
| 管理后台 | `ad.nanniwan.com` | 管理员后台管理系统 | 生产环境 |
| 官方网站 | `www.nanniwan.com` | 产品官网和文档 | 生产环境 |
| 开发环境 | `localhost:3000` | 本地开发测试 | 开发环境 |
| 开发环境 | `localhost:5173` | Vite开发服务器 | 开发环境 |

## 配置文件更新记录

### 1. 后端配置更新

**文件：** `backend/src/config/config.js`
- 添加了 `domainConfig` 配置对象
- 包含所有生产环境域名配置

**配置内容：**
```javascript
const domainConfig = {
  backend: 'wapi.nanniwan.com',
  admin: 'ad.nanniwan.com',
  website: 'www.nanniwan.com'
};
```

### 2. CORS配置更新

**文件：** `backend/src/main.js`
- 更新了CORS配置，添加了所有允许的域名
- 启用了credentials支持

**配置内容：**
```javascript
app.use(cors({
  origin: [
    'http://localhost:3000',
    'http://localhost:5173',
    'https://wapi.nanniwan.com',
    'https://ad.nanniwan.com',
    'https://www.nanniwan.com'
  ],
  credentials: true
}));
```

### 3. API文档更新

**文件：** `backend/src/docs/api.yaml`
- 更新了生产环境服务器URL
- 从 `https://api.niumall.com` 改为 `https://wapi.nanniwan.com`

### 4. 管理后台配置更新

**文件：** `admin-system/.env.production`
- 更新了所有API相关配置
- 统一使用 `wapi.nanniwan.com` 域名

**更新内容：**
```bash
# API接口地址
VITE_API_BASE_URL=https://wapi.nanniwan.com/api

# WebSocket地址
VITE_WS_BASE_URL=wss://wapi.nanniwan.com

# 上传文件地址
VITE_UPLOAD_URL=https://wapi.nanniwan.com/api/upload

# 静态资源地址
VITE_STATIC_URL=https://wapi.nanniwan.com/static

# 错误日志上报地址
VITE_ERROR_LOG_URL=https://wapi.nanniwan.com/api/error-log

# 性能监控地址
VITE_PERFORMANCE_URL=https://wapi.nanniwan.com/api/performance
```

### 5. 官网API文档更新

**文件：** `website/api.html`
- 更新了API基础URL
- 从 `https://api.niumall.com/v1` 改为 `https://wapi.nanniwan.com/v1`
- 更新了curl示例中的域名

## 部署注意事项

1. **DNS配置**：确保所有域名都正确解析到服务器IP地址
2. **SSL证书**：为所有生产环境域名配置HTTPS证书
3. **Nginx配置**：需要配置反向代理，将请求转发到相应的服务
4. **环境变量**：生产环境部署时需要设置正确的环境变量

## 开发环境配置

开发环境继续使用localhost地址，配置位于：
- `admin-system/.env.development` - 管理后台开发配置
- 后端服务默认运行在 `localhost:3000`

## 验证检查清单

- [ ] 所有域名能够正常解析
- [ ] HTTPS证书配置正确
- [ ] CORS配置允许所有需要的域名
- [ ] 各服务之间的通信正常
- [ ] API文档中的域名已更新
- [ ] 管理后台能够正常访问API
- [ ] 官网能够正常展示

## 故障排除

如果遇到跨域问题，检查：
1. CORS配置是否正确
2. 域名是否在允许列表中
3. HTTPS证书是否有效
4. Nginx配置是否正确

---

*最后更新：2024年1月20日*
*版本：1.0.0*