慈屿铝业 - 企业网站项目

一个完整的企业级网站解决方案，包含前端展示、后端 API 和后台管理系统。

🌟 项目特点

• 🎨 现代化前端: Vue 3 + Element Plus + TypeScript
• 🔒 安全认证: JWT Token 用户认证
• 💾 数据持久化: PostgreSQL + Redis 缓存
• 🐳 容器化部署: 完整的 Docker 支持
• 📱 响应式设计: 适配移动端和桌面端
• 🚀 高性能: 优化的构建和运行时配置

📋 项目结构

ciyu-aluminum/
├── web/                      # 前端项目
│   ├── src/
│   │   ├── views/           # 页面组件
│   │   ├── router/          # 路由配置
│   │   ├── components/      # 公共组件
│   │   └── assets/          # 静态资源
│   ├── dist/                 # 构建输出
│   └── package.json
├── backend/                  # 后端项目
│   ├── src/
│   │   ├── models/           # 数据模型
│   │   ├── controllers/      # 控制器
│   │   ├── routes/           # 路由
│   │   ├── middleware/       # 中间件
│   │   ├── config/           # 配置文件
│   │   └── utils/            # 工具函数
│   ├── dist/                  # 构建输出
│   └── package.json
├── nginx/                    # Nginx 配置
│   ├── nginx.conf
│   └── conf.d/
├── redis/                    # Redis 配置
│   └── redis.conf
├── database/                 # 数据库脚本
│   └── init/
├── logs/                     # 日志文件
├── deploy.sh                 # 传统部署脚本
├── docker-compose.yml         # Docker Compose 配置
├── docker-start.sh          # Docker 快速启动
└── DEPLOYMENT.md             # 部署指南

🚀 快速开始

方式一：Docker 部署（推荐）

1. 克隆项目

git clone <your-repo-url> ciyu-aluminum
cd ciyu-aluminum

2. 配置环境变量

cp docker-compose.env.example .env
# 编辑 .env 文件，修改相关配置

3. 启动服务

./docker-start.sh

4. 访问网站

• 前端: http://localhost:8080
• 后端 API: http://localhost:30001
• 管理员: admin / admin123

方式二：本地开发

1. 安装依赖

# 前端
cd web
pnpm install

# 后端
cd ../backend
pnpm install

2. 配置数据库

确保 PostgreSQL 服务运行，创建数据库：

CREATE DATABASE ciyu_aluminum;

3. 启动服务

启动后端（端口 3002）：

cd backend
pnpm run dev

启动前端（端口 5173）：

cd web
pnpm run dev

方式三：传统部署

在生产服务器上使用一键部署脚本：

sudo ./deploy.sh

详见 DEPLOYMENT.md。

📖 文档

• 部署指南 - 详细的部署说明
• 项目总结 - 项目功能和技术细节
• 后端 README - 后端 API 文档

🔌 API 接口

认证 API

• POST /api/auth/login - 用户登录
• GET /api/auth/me - 获取当前用户
• GET /api/auth/users - 获取所有用户（管理员）

报价 API

• GET /api/quotes - 获取所有报价
• POST /api/quotes - 创建报价（管理员）
• PUT /api/quotes/:id - 更新报价（管理员）
• DELETE /api/quotes/:id - 删除报价（管理员）

留言 API

• GET /api/messages - 获取所有留言（管理员）
• POST /api/messages - 提交留言
• PUT /api/messages/:id/status - 更新留言状态（管理员）

🎨 前端页面

页面	路由	说明
首页	/	网站主页
公司简介	/company	公司介绍和发展历程
产品展示	/products	产品分类和详情
生产环境	/production	生产设备和工艺
业务范围	/business	业务和服务网络
销售报价	/quote	实时价格信息
联系我们	/contact	联系方式和留言

🛠️ 技术栈

前端

• 框架: Vue 3.5.31
• 构建工具: Vite 8.0.3
• UI 组件: Element Plus 2.13.7
• 路由: Vue Router 5.0.4
• 状态管理: Pinia 3.0.4
• 语言: TypeScript 6.0.0

后端

• 运行时: Node.js 22
• 框架: Express 4.22.1
• 数据库: PostgreSQL 15
• 缓存: Redis 7
• 认证: JWT
• 语言: TypeScript 5.9.3

开发工具

• 包管理器: pnpm 10.33.0
• 代码规范: ESLint + Prettier
• 容器化: Docker + Docker Compose

🔐 默认账号

⚠️ 生产环境请立即修改默认密码！

• 管理员用户名: admin
• 管理员密码: admin123

📦 Docker 镜像

项目提供以下 Docker 镜像：

• ciyu-aluminum-web - Nginx 前端服务
• ciyu-aluminum-backend - Node.js 后端服务
• ciyu-aluminum-postgres - PostgreSQL 数据库
• ciyu-aluminum-redis - Redis 缓存服务

🔧 配置说明

环境变量

主要环境变量在 docker-compose.env.example 中定义：

# 数据库配置
DB_NAME=ciyu_aluminum
DB_USER=ciyu_admin
DB_PASSWORD=your_password

# Redis 配置
REDIS_PASSWORD=your_redis_password

# JWT 配置
JWT_SECRET=your_jwt_secret

# 管理员配置
ADMIN_USERNAME=admin
ADMIN_PASSWORD=admin123
ADMIN_EMAIL=admin@ciyu-aluminum.com

端口映射

服务	宿主机端口	容器端口	说明
Web	8080	80	HTTP 前端
Web HTTPS	8443	443	HTTPS 前端
Backend	30001	3001	后端 API
PostgreSQL	54343	5432	数据库
Redis	63790	6379	缓存

📊 监控和日志

查看日志

# Docker 部署
docker-compose logs -f
docker-compose logs -f backend
docker-compose logs -f web

# 传统部署
pm2 logs ciyu-aluminum-backend
tail -f /var/log/nginx/ciyu-aluminum-access.log

健康检查

# 后端健康检查
curl http://localhost:30001/health

# 前端健康检查
curl http://localhost:8080/health

🔄 更新和维护

更新应用

# 拉取最新代码
git pull origin main

# Docker 部署
./docker-start.sh

# 传统部署
/usr/local/bin/update-ciyu-aluminum.sh

备份数据

# Docker 部署
docker-compose exec postgres pg_dump ciyu_aluminum > backup.sql

# 传统部署
/usr/local/bin/backup-ciyu-aluminum.sh

🚨 故障排除

常见问题

1. 端口冲突

   • 检查端口占用: sudo netstat -tlnp
   • 修改端口配置

2. 数据库连接失败

   • 检查 PostgreSQL 服务状态
   • 验证数据库配置

3. Docker 启动失败

   • 检查 Docker 服务: sudo systemctl status docker
   • 查看详细日志: docker-compose logs

🤝 贡献

欢迎提交问题和改进建议！

📄 许可证

MIT License

👥 联系方式

如有问题或建议，请联系开发团队。

---

🎉 感谢使用慈屿铝业网站项目！