# 企业文化模块升级指南

## 🎯 概述
将企业文化模块从硬编码方式升级为数据库动态管理，支持后台FastAdmin界面管理，保持现有复杂样式不变。

## ✅ 功能特性
- ✅ **独立数据表管理**：新建专用的企业文化数据表
- ✅ **复杂样式支持**：支持normal/reverse卡片布局，单列/双列内容布局
- ✅ **后台管理界面**：完整的FastAdmin CRUD管理
- ✅ **多语言支持**：支持中文/英文数据管理
- ✅ **灵活内容配置**：JSON格式存储复杂内容结构
- ✅ **保持原有样式**：完全兼容现有CSS样式

## 🗂️ 数据表结构

### 1. 企业文化卡片表 (`wwh_culture_card`)
| 字段 | 类型 | 说明 |
|------|------|------|
| title | varchar(100) | 卡片标题 |
| subtitle | varchar(100) | 英文副标题 |
| image | varchar(255) | 卡片图片 |
| card_type | enum | 卡片类型：normal/reverse |
| list_type | enum | 列表类型：single/double |
| content_items | text | 内容项目(JSON) |
| weigh | int | 排序权重 |
| status | enum | 状态：0=禁用,1=启用 |
| lang | enum | 语言：1=中文,2=英文 |

### 2. 企业文化横幅表 (`wwh_culture_banner`)
| 字段 | 类型 | 说明 |
|------|------|------|
| title | varchar(100) | 横幅标题 |
| subtitle | varchar(100) | 英文副标题 |
| image | varchar(255) | 背景图片 |
| content_type | enum | 内容类型：text/grid_single/grid_double |
| content_data | text | 内容数据(JSON) |
| weigh | int | 排序权重 |
| status | enum | 状态：0=禁用,1=启用 |
| lang | enum | 语言：1=中文,2=英文 |

## 🚀 安装步骤

### 1. 导入数据表
```sql
-- 导入数据表结构和示例数据
mysql> source culture_tables.sql
```

### 2. 导入后台菜单
```sql
-- 导入后台管理菜单
mysql> source culture_menu.sql
```

### 3. 清理缓存
```bash
# 清理模板缓存
rm -rf runtime/temp/*
# 清理系统缓存  
rm -rf runtime/cache/*
```

## 🎛️ 后台管理

### 访问路径
- **企业文化卡片管理**：`后台 > WWH模块管理 > 企业文化卡片`
- **企业文化横幅管理**：`后台 > WWH模块管理 > 企业文化横幅`

### 管理功能
- ✅ 卡片增删改查
- ✅ 横幅增删改查  
- ✅ 排序权重管理
- ✅ 状态启用/禁用
- ✅ 多语言数据管理
- ✅ 图片上传管理

## 📝 使用说明

### 卡片内容格式
内容项目按行分隔，例如：
```
善用资源
服务建设
企业育人
让员工与企业共同成长
```

### 横幅内容格式
根据内容类型：
- **纯文本**：直接输入文本内容
- **网格布局**：每行一个项目，例如：
```
敬畏
感恩
谦虚
得体
```

### 卡片类型说明
- **normal**：图片在上，内容在下
- **reverse**：内容在上，图片在下

### 列表类型说明
- **single**：单列布局
- **double**：双列布局（自动左右分列对齐）

## 🎨 样式特性

### 响应式布局
- 卡片宽度：285px
- 卡片高度：520px  
- 自适应间距：gap: 60px 20px

### 动画效果
- 悬停上升效果：transform: translateY(-5px)
- 图片缩放效果：transform: scale(1.05)
- WOW动画支持

### 特殊样式处理
- 支持nth-child选择器的特殊高度设置
- 自动处理card-normal和card-reverse的布局切换
- 双列内容的左右对齐显示

## 🔧 开发说明

### 文件结构
```
application/
├── admin/controller/wwh/
│   ├── CultureCard.php      # 卡片管理控制器
│   └── CultureBanner.php    # 横幅管理控制器
├── admin/view/wwh/
│   ├── culture_card/        # 卡片管理视图
│   └── culture_banner/      # 横幅管理视图
└── common/model/
    ├── WwhCultureCard.php   # 卡片模型
    └── WwhCultureBanner.php # 横幅模型

addons/wwh/
├── controller/Column.php    # 前台控制器(已修改)
└── view/materials/
    └── detail_culture.html  # 企业文化页面(已修改)
```

### 扩展开发
如需添加新字段：
1. 修改数据表结构
2. 更新模型文件的append属性
3. 修改控制器的表单处理
4. 更新视图模板

## ⚠️ 注意事项

1. **备份数据**：升级前请备份数据库
2. **样式兼容**：确保CSS文件完整加载
3. **图片路径**：使用cdnurl修饰符处理图片路径
4. **JSON格式**：内容数据使用JSON格式存储，注意编码
5. **权重排序**：权重值越大排序越靠前

## 🐛 故障排除

### 常见问题
1. **菜单不显示**：检查菜单SQL是否正确导入
2. **图片不显示**：检查图片路径和CDN配置
3. **样式错乱**：检查CSS文件是否完整加载
4. **数据不显示**：检查数据表是否正确创建和填充

### 调试方法
```php
// 在控制器中调试数据
var_dump($cultureCards);
var_dump($cultureBanners);
```

## 📞 技术支持
如遇问题，请检查：
1. 数据表是否正确创建
2. 菜单是否正确导入  
3. 文件权限是否正确
4. 缓存是否已清理