708 lines
27 KiB
Markdown
708 lines
27 KiB
Markdown
# 公司官方网站开发方案
|
||
|
||
**域名**:www.tgoim.com
|
||
**文档版本**:v1.1
|
||
**最后更新**:2026-07-31
|
||
|
||
---
|
||
|
||
## 一、项目概述
|
||
|
||
### 1.1 项目目标
|
||
开发一个专业、现代、响应式的企业官方网站,用于展示公司形象、产品服务、新闻动态和联系方式,支持桌面端与移动端完美适配。支持中英双语,内容维护由非技术人员通过后台管理完成。
|
||
|
||
### 1.2 目标用户
|
||
- 潜在客户(了解公司实力与产品)
|
||
- 合作伙伴(寻求商务合作)
|
||
- 媒体与公众(获取公司资讯)
|
||
|
||
### 1.3 核心价值
|
||
- **专业形象**:现代化 UI 设计,树立品牌形象
|
||
- **响应式布局**:一套代码适配 PC、平板、手机
|
||
- **多语言支持**:中文 / 英文双语切换
|
||
- **易于维护**:基于 Django 后台管理,非技术人员可更新内容(无需改代码)
|
||
- **SEO 友好**:合理的语义化结构,有利于搜索引擎收录
|
||
- **高性能**:静态资源优化 + Nginx 缓存,提升访问速度
|
||
|
||
---
|
||
|
||
## 二、技术栈选型
|
||
|
||
### 2.1 后端技术栈
|
||
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Python | 3.12 | 编程语言 |
|
||
| Django | 5.0 LTS | Web 框架(含国际化 i18n) |
|
||
| Django Admin | 内置 | 后台管理系统(面向非技术人员) |
|
||
| Pillow | 最新 | 图片处理 |
|
||
| SQLite | 3.x | 数据库(开发 + 生产统一使用) |
|
||
| Gunicorn | 最新 | WSGI HTTP 服务器 |
|
||
|
||
### 2.2 前端技术栈
|
||
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Bootstrap | 5.3.x | 响应式 CSS 框架(CDN 引入) |
|
||
| Font Awesome | 6.x | 图标库(CDN 引入) |
|
||
| Leaflet | 1.9.x | 地图库(CDN 引入) |
|
||
| 高德公开瓦片 | - | Leaflet 底图服务 |
|
||
| HTML5 | - | 页面结构 |
|
||
| CSS3 | - | 样式(含 CSS 变量主题系统) |
|
||
| JavaScript | ES6+ | 交互逻辑(原生 JS,不依赖 jQuery) |
|
||
|
||
### 2.3 部署与运维技术栈
|
||
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| 操作系统 | Ubuntu 24.04 LTS | ECS 服务器系统 |
|
||
| Nginx | 1.24+ | 反向代理 + 静态资源服务 |
|
||
| SSL 证书 | Let's Encrypt / 阿里云免费证书 | HTTPS 加密传输 |
|
||
| Supervisor | 最新 | 进程守护(管理 Gunicorn) |
|
||
| 阿里云 DNS | - | 域名解析 |
|
||
| 阿里云 CDN(可选) | - | 静态资源加速 |
|
||
|
||
---
|
||
|
||
## 三、页面结构设计
|
||
|
||
### 3.1 网站导航
|
||
|
||
```
|
||
首页 (Home)
|
||
├── 关于我们 (About)
|
||
│ ├── 公司简介
|
||
│ └── 发展历程
|
||
├── 产品中心 (Products)
|
||
│ ├── 产品分类
|
||
│ └── 产品详情页(含图片、视频)
|
||
├── 解决方案 (Solutions)
|
||
│ ├── 方案分类
|
||
│ └── 方案详情页(含图片、视频)
|
||
├── 客户案例 (Customers)
|
||
│ └── 客户地区分布地图
|
||
├── 新闻中心 (News)
|
||
│ ├── 公司新闻 / 行业动态
|
||
│ └── 新闻详情页
|
||
└── 联系我们 (Contact)
|
||
├── 联系方式
|
||
└── 在线留言
|
||
```
|
||
|
||
### 3.2 语言切换
|
||
- 全站支持 **中文(简体)** 和 **英文**
|
||
- 页头导航栏右侧提供语言切换按钮
|
||
- URL 中体现语言前缀:`/zh-hans/...` 和 `/en/...`
|
||
|
||
### 3.3 页面清单
|
||
|
||
| 序号 | 页面名称 | 页面标识 | 说明 |
|
||
|------|----------|----------|------|
|
||
| 1 | 首页 | `home` | 品牌展示、轮播图、核心产品、新闻快讯、联系入口 |
|
||
| 2 | 公司简介 | `about` | 公司介绍、使命愿景、核心优势 |
|
||
| 3 | 发展历程 | `history` | 时间轴展示公司里程碑 |
|
||
| 4 | 产品列表 | `product_list` | 产品分类筛选、卡片式展示 |
|
||
| 5 | 产品详情 | `product_detail` | 产品参数、图片库、视频播放、特点、下载资料 |
|
||
| 6 | 解决方案列表 | `solution_list` | 方案分类与展示 |
|
||
| 7 | 解决方案详情 | `solution_detail` | 方案内容、图片、视频 |
|
||
| 8 | 客户分布 | `customer_map` | Leaflet 地图 + 高德瓦片,展示客户地点分布 |
|
||
| 9 | 新闻列表 | `news_list` | 新闻分类、分页 |
|
||
| 10 | 新闻详情 | `news_detail` | 新闻正文、相关推荐 |
|
||
| 11 | 联系我们 | `contact` | 联系信息、留言表单 |
|
||
| 12 | 404 / 500 页面 | `errors` | 友好的错误提示页 |
|
||
|
||
---
|
||
|
||
## 四、数据库设计
|
||
|
||
### 4.1 多语言字段设计原则
|
||
需要翻译的字段(名称、标题、摘要、正文等)采用 **双字段存储** 方式:
|
||
- `name_zh` / `name_en`
|
||
- `title_zh` / `title_en`
|
||
- `summary_zh` / `summary_en`
|
||
- `content_zh` / `content_en`
|
||
- `description_zh` / `description_en`
|
||
|
||
通过自定义模板标签在前端根据当前语言自动切换显示。
|
||
|
||
### 4.2 核心数据表
|
||
|
||
#### 4.2.1 产品分类表 (`ProductCategory`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| name_zh | CharField(100) | 分类名称(中文) |
|
||
| name_en | CharField(100) | 分类名称(英文) |
|
||
| slug | SlugField | URL 友好标识(英文) |
|
||
| description_zh | TextField | 分类描述(中文,可选) |
|
||
| description_en | TextField | 分类描述(英文,可选) |
|
||
| image | ImageField | 分类封面图(可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
| is_active | BooleanField | 是否启用 |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
| updated_at | DateTimeField | 更新时间 |
|
||
|
||
#### 4.2.2 产品表 (`Product`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| category | ForeignKey | 所属分类 |
|
||
| name_zh | CharField(200) | 产品名称(中文) |
|
||
| name_en | CharField(200) | 产品名称(英文) |
|
||
| slug | SlugField | URL 友好标识 |
|
||
| model | CharField(100) | 产品型号 |
|
||
| summary_zh | CharField(300) | 产品摘要(中文) |
|
||
| summary_en | CharField(300) | 产品摘要(英文) |
|
||
| description_zh | TextField | 详细描述(中文,支持 HTML) |
|
||
| description_en | TextField | 详细描述(英文,支持 HTML) |
|
||
| main_image | ImageField | 主图 |
|
||
| video_url | URLField | 视频链接(可选,支持 MP4 / YouTube / B站 嵌入) |
|
||
| video_file | FileField | 视频文件上传(可选) |
|
||
| features_zh | JSONField | 产品特点列表(中文) |
|
||
| features_en | JSONField | 产品特点列表(英文) |
|
||
| specs_zh | JSONField | 技术参数(中文,键值对) |
|
||
| specs_en | JSONField | 技术参数(英文,键值对) |
|
||
| download_file | FileField | 资料下载(可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
| is_active | BooleanField | 是否上架 |
|
||
| is_featured | BooleanField | 是否推荐(首页展示) |
|
||
| seo_title_zh | CharField(100) | SEO 标题(中文) |
|
||
| seo_title_en | CharField(100) | SEO 标题(英文) |
|
||
| seo_keywords_zh | CharField(200) | SEO 关键词(中文) |
|
||
| seo_keywords_en | CharField(200) | SEO 关键词(英文) |
|
||
| seo_description_zh | CharField(300) | SEO 描述(中文) |
|
||
| seo_description_en | CharField(300) | SEO 描述(英文) |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
| updated_at | DateTimeField | 更新时间 |
|
||
|
||
#### 4.2.3 产品图库表 (`ProductImage`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| product | ForeignKey | 关联产品 |
|
||
| image | ImageField | 图片 |
|
||
| caption_zh | CharField(200) | 图片说明(中文,可选) |
|
||
| caption_en | CharField(200) | 图片说明(英文,可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
|
||
#### 4.2.4 解决方案分类表 (`SolutionCategory`)
|
||
结构同 `ProductCategory`
|
||
|
||
#### 4.2.5 解决方案表 (`Solution`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| category | ForeignKey | 所属分类 |
|
||
| title_zh | CharField(200) | 方案标题(中文) |
|
||
| title_en | CharField(200) | 方案标题(英文) |
|
||
| slug | SlugField | URL 友好标识 |
|
||
| summary_zh | CharField(300) | 方案摘要(中文) |
|
||
| summary_en | CharField(300) | 方案摘要(英文) |
|
||
| content_zh | TextField | 方案内容(中文,支持 HTML) |
|
||
| content_en | TextField | 方案内容(英文,支持 HTML) |
|
||
| cover_image | ImageField | 封面图 |
|
||
| video_url | URLField | 视频链接(可选) |
|
||
| video_file | FileField | 视频文件上传(可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
| is_active | BooleanField | 是否启用 |
|
||
| seo_title_zh / seo_title_en | CharField(100) | SEO 标题 |
|
||
| seo_keywords_zh / seo_keywords_en | CharField(200) | SEO 关键词 |
|
||
| seo_description_zh / seo_description_en | CharField(300) | SEO 描述 |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
| updated_at | DateTimeField | 更新时间 |
|
||
|
||
#### 4.2.6 客户地点表 (`CustomerLocation`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| name_zh | CharField(200) | 客户/地点名称(中文) |
|
||
| name_en | CharField(200) | 客户/地点名称(英文) |
|
||
| latitude | FloatField | 纬度(如 39.9042) |
|
||
| longitude | FloatField | 经度(如 116.4074) |
|
||
| address_zh | CharField(300) | 地址(中文,可选) |
|
||
| address_en | CharField(300) | 地址(英文,可选) |
|
||
| description_zh | TextField | 描述说明(中文,可选) |
|
||
| description_en | TextField | 描述说明(英文,可选) |
|
||
| marker_color | CharField(20) | 标记点颜色(默认蓝色,可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
| is_active | BooleanField | 是否启用 |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
|
||
#### 4.2.7 新闻分类表 (`NewsCategory`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| name_zh | CharField(50) | 分类名称(中文) |
|
||
| name_en | CharField(50) | 分类名称(英文) |
|
||
| slug | SlugField | URL 友好标识 |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
|
||
#### 4.2.8 新闻表 (`News`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| category | ForeignKey | 所属分类 |
|
||
| title_zh | CharField(200) | 新闻标题(中文) |
|
||
| title_en | CharField(200) | 新闻标题(英文) |
|
||
| slug | SlugField | URL 友好标识 |
|
||
| summary_zh | CharField(300) | 摘要(中文) |
|
||
| summary_en | CharField(300) | 摘要(英文) |
|
||
| content_zh | TextField | 正文(中文,支持 HTML) |
|
||
| content_en | TextField | 正文(英文,支持 HTML) |
|
||
| cover_image | ImageField | 封面图(可选) |
|
||
| author | CharField(50) | 作者(可选) |
|
||
| source | CharField(100) | 来源(可选) |
|
||
| view_count | IntegerField | 浏览量 |
|
||
| is_top | BooleanField | 是否置顶 |
|
||
| is_active | BooleanField | 是否发布 |
|
||
| seo_title_zh / seo_title_en | CharField(100) | SEO 标题 |
|
||
| seo_keywords_zh / seo_keywords_en | CharField(200) | SEO 关键词 |
|
||
| seo_description_zh / seo_description_en | CharField(300) | SEO 描述 |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
| updated_at | DateTimeField | 更新时间 |
|
||
|
||
#### 4.2.9 在线留言表 (`ContactMessage`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| name | CharField(50) | 姓名 |
|
||
| company | CharField(100) | 公司名称(可选) |
|
||
| phone | CharField(20) | 电话 |
|
||
| email | EmailField | 邮箱 |
|
||
| subject | CharField(100) | 主题 |
|
||
| message | TextField | 留言内容 |
|
||
| ip_address | GenericIPAddressField | IP 地址 |
|
||
| is_read | BooleanField | 是否已读 |
|
||
| created_at | DateTimeField | 提交时间 |
|
||
|
||
> **注意**:留言仅保存到数据库,无需邮件/短信通知,管理员通过后台查看。
|
||
|
||
#### 4.2.10 网站设置表 (`SiteSettings`) — 单例模式
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| site_name_zh | CharField(100) | 网站名称(中文) |
|
||
| site_name_en | CharField(100) | 网站名称(英文) |
|
||
| site_logo | ImageField | 网站 Logo |
|
||
| site_description_zh | CharField(300) | 网站描述(中文) |
|
||
| site_description_en | CharField(300) | 网站描述(英文) |
|
||
| company_name_zh | CharField(200) | 公司全称(中文) |
|
||
| company_name_en | CharField(200) | 公司全称(英文) |
|
||
| company_address_zh | CharField(300) | 公司地址(中文) |
|
||
| company_address_en | CharField(300) | 公司地址(英文) |
|
||
| company_phone | CharField(50) | 联系电话 |
|
||
| company_email | EmailField | 联系邮箱 |
|
||
| wechat_qr | ImageField | 微信二维码(可选) |
|
||
| weibo_url | URLField | 微博链接(可选) |
|
||
| icp_number | CharField(50) | ICP 备案号 |
|
||
| copyright_zh | CharField(200) | 版权信息(中文) |
|
||
| copyright_en | CharField(200) | 版权信息(英文) |
|
||
| seo_title_zh / seo_title_en | CharField(100) | 全站默认 SEO 标题 |
|
||
| seo_keywords_zh / seo_keywords_en | CharField(200) | 全站默认 SEO 关键词 |
|
||
| seo_description_zh / seo_description_en | CharField(300) | 全站默认 SEO 描述 |
|
||
|
||
#### 4.2.11 首页轮播图表 (`Banner`)
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| id | AutoField | 主键 |
|
||
| title_zh | CharField(100) | 标题(中文,可选) |
|
||
| title_en | CharField(100) | 标题(英文,可选) |
|
||
| subtitle_zh | CharField(200) | 副标题(中文,可选) |
|
||
| subtitle_en | CharField(200) | 副标题(英文,可选) |
|
||
| image | ImageField | 图片(建议 1920x800) |
|
||
| mobile_image | ImageField | 移动端图片(可选) |
|
||
| link_url | URLField | 跳转链接(可选) |
|
||
| sort_order | IntegerField | 排序权重 |
|
||
| is_active | BooleanField | 是否启用 |
|
||
| created_at | DateTimeField | 创建时间 |
|
||
|
||
---
|
||
|
||
## 五、Django 项目架构
|
||
|
||
### 5.1 目录结构
|
||
|
||
```
|
||
company_website/
|
||
├── manage.py
|
||
├── requirements.txt # Python 依赖清单
|
||
├── .env # 环境变量(不入库)
|
||
├── .env.example # 环境变量示例
|
||
├── .gitignore
|
||
├── locale/ # 翻译文件目录
|
||
│ ├── en/
|
||
│ │ └── LC_MESSAGES/
|
||
│ │ ├── django.po
|
||
│ │ └── django.mo
|
||
│ └── zh_Hans/
|
||
│ └── LC_MESSAGES/
|
||
│ ├── django.po
|
||
│ └── django.mo
|
||
├── company_website/ # 项目主配置
|
||
│ ├── __init__.py
|
||
│ ├── settings.py # Django 配置(含 i18n)
|
||
│ ├── urls.py # 主 URL 路由(含语言前缀)
|
||
│ ├── wsgi.py # WSGI 入口
|
||
│ └── asgi.py # ASGI 入口
|
||
├── apps/ # 业务应用集合
|
||
│ ├── __init__.py
|
||
│ ├── core/ # 核心应用(网站设置、公共模块)
|
||
│ │ ├── __init__.py
|
||
│ │ ├── models.py # SiteSettings, Banner
|
||
│ │ ├── admin.py # 后台配置
|
||
│ │ ├── views.py # 首页、关于、发展历程
|
||
│ │ ├── urls.py # 路由
|
||
│ │ ├── templatetags/ # 自定义模板标签
|
||
│ │ │ ├── __init__.py
|
||
│ │ │ ├── i18n_tags.py # 多语言字段切换
|
||
│ │ │ └── site_tags.py # 全局设置获取
|
||
│ │ ├── context_processors.py # 全局上下文处理器
|
||
│ │ ├── mixins.py # 通用 Mixin(多语言切换等)
|
||
│ │ └── migrations/
|
||
│ ├── products/ # 产品中心
|
||
│ │ ├── __init__.py
|
||
│ │ ├── models.py # ProductCategory, Product, ProductImage
|
||
│ │ ├── admin.py
|
||
│ │ ├── views.py
|
||
│ │ ├── urls.py
|
||
│ │ └── migrations/
|
||
│ ├── solutions/ # 解决方案
|
||
│ │ ├── __init__.py
|
||
│ │ ├── models.py
|
||
│ │ ├── admin.py
|
||
│ │ ├── views.py
|
||
│ │ ├── urls.py
|
||
│ │ └── migrations/
|
||
│ ├── customers/ # 客户案例/地区分布
|
||
│ │ ├── __init__.py
|
||
│ │ ├── models.py # CustomerLocation
|
||
│ │ ├── admin.py
|
||
│ │ ├── views.py
|
||
│ │ ├── urls.py
|
||
│ │ └── migrations/
|
||
│ ├── news/ # 新闻中心
|
||
│ │ ├── __init__.py
|
||
│ │ ├── models.py # NewsCategory, News
|
||
│ │ ├── admin.py
|
||
│ │ ├── views.py
|
||
│ │ ├── urls.py
|
||
│ │ └── migrations/
|
||
│ └── contact/ # 联系我们
|
||
│ ├── __init__.py
|
||
│ ├── models.py # ContactMessage
|
||
│ ├── admin.py
|
||
│ ├── views.py
|
||
│ ├── forms.py # 留言表单
|
||
│ ├── urls.py
|
||
│ └── migrations/
|
||
├── templates/ # HTML 模板目录
|
||
│ ├── base.html # 基础模板(所有页面继承)
|
||
│ ├── includes/ # 公共片段
|
||
│ │ ├── header.html # 页头导航(含语言切换)
|
||
│ │ ├── footer.html # 页脚
|
||
│ │ ├── navbar_mobile.html # 移动端导航抽屉
|
||
│ │ ├── breadcrumb.html # 面包屑导航
|
||
│ │ └── pagination.html # 分页组件
|
||
│ ├── core/
|
||
│ │ ├── home.html # 首页
|
||
│ │ ├── about.html # 关于我们
|
||
│ │ └── history.html # 发展历程
|
||
│ ├── products/
|
||
│ │ ├── list.html # 产品列表
|
||
│ │ └── detail.html # 产品详情(含视频播放)
|
||
│ ├── solutions/
|
||
│ │ ├── list.html
|
||
│ │ └── detail.html # 方案详情(含视频播放)
|
||
│ ├── customers/
|
||
│ │ └── map.html # 客户分布地图(Leaflet)
|
||
│ ├── news/
|
||
│ │ ├── list.html
|
||
│ │ └── detail.html
|
||
│ ├── contact/
|
||
│ │ └── index.html
|
||
│ └── errors/
|
||
│ ├── 404.html
|
||
│ └── 500.html
|
||
├── static/ # 静态资源
|
||
│ ├── css/
|
||
│ │ ├── style.css # 自定义样式(覆盖 Bootstrap)
|
||
│ │ └── responsive.css # 响应式补充样式
|
||
│ ├── js/
|
||
│ │ └── main.js # 自定义脚本
|
||
│ └── images/
|
||
│ ├── logo.png
|
||
│ ├── favicon.ico
|
||
│ └── placeholders/ # 占位图
|
||
└── media/ # 用户上传文件(SQLite + 文件存储)
|
||
├── products/
|
||
├── solutions/
|
||
├── news/
|
||
└── banners/
|
||
```
|
||
|
||
### 5.2 Django 配置要点
|
||
|
||
#### 5.2.1 国际化(i18n)核心配置
|
||
|
||
```python
|
||
# settings.py
|
||
LANGUAGE_CODE = 'zh-hans' # 默认语言
|
||
|
||
LANGUAGES = [
|
||
('zh-hans', '简体中文'),
|
||
('en', 'English'),
|
||
]
|
||
|
||
TIME_ZONE = 'Asia/Shanghai'
|
||
USE_I18N = True
|
||
USE_L10N = True
|
||
USE_TZ = True
|
||
|
||
LOCALE_PATHS = [BASE_DIR / 'locale']
|
||
|
||
# 语言中间件(LocaleMiddleware 必须在 SessionMiddleware 和 CommonMiddleware 之间)
|
||
MIDDLEWARE = [
|
||
'django.middleware.security.SecurityMiddleware',
|
||
'django.contrib.sessions.middleware.SessionMiddleware',
|
||
'django.middleware.locale.LocaleMiddleware', # 关键!
|
||
'django.middleware.common.CommonMiddleware',
|
||
'django.middleware.csrf.CsrfViewMiddleware',
|
||
'django.contrib.auth.middleware.AuthenticationMiddleware',
|
||
'django.contrib.messages.middleware.MessageMiddleware',
|
||
'django.middleware.clickjacking.XFrameOptionsMiddleware',
|
||
]
|
||
|
||
# URL 路由配置
|
||
ROOT_URLCONF = 'company_website.urls'
|
||
```
|
||
|
||
#### 5.2.2 数据库配置 — 统一使用 SQLite
|
||
|
||
```python
|
||
DATABASES = {
|
||
'default': {
|
||
'ENGINE': 'django.db.backends.sqlite3',
|
||
'NAME': BASE_DIR / 'db.sqlite3',
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 5.2.3 静态文件 & 媒体文件
|
||
|
||
```python
|
||
STATIC_URL = '/static/'
|
||
STATIC_ROOT = BASE_DIR / 'staticfiles'
|
||
STATICFILES_DIRS = [BASE_DIR / 'static']
|
||
|
||
MEDIA_URL = '/media/'
|
||
MEDIA_ROOT = BASE_DIR / 'media'
|
||
```
|
||
|
||
---
|
||
|
||
## 六、前端设计规范
|
||
|
||
### 6.1 设计风格
|
||
- **整体风格**:现代简约、专业大气、科技感
|
||
- **设计原则**:留白充足、层级清晰、视觉引导明确
|
||
|
||
### 6.2 配色方案
|
||
|
||
| 颜色名称 | 色值 | 用途 |
|
||
|----------|------|------|
|
||
| 主色(Primary) | `#165DFF` | 导航、按钮、链接、强调元素 |
|
||
| 主色深色 | `#0E42D2` | 按钮悬停、激活状态 |
|
||
| 主色浅色 | `#E8F0FF` | 按钮背景、标签背景 |
|
||
| 标题色 | `#1D2129` | 标题、重要文本 |
|
||
| 正文色 | `#4E5969` | 正文内容 |
|
||
| 辅助文字色 | `#86909C` | 次要信息、时间、标签 |
|
||
| 边框色 | `#E5E6EB` | 分割线、卡片边框 |
|
||
| 背景色 | `#F7F8FA` | 页面底色、区块背景 |
|
||
| 白色 | `#FFFFFF` | 卡片背景、内容区背景 |
|
||
|
||
### 6.3 字体规范
|
||
- **中文**:`"PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif`
|
||
- **英文/数字**:`"Inter", -apple-system, BlinkMacSystemFont, sans-serif`
|
||
- **字号层级**:
|
||
- H1:2rem / 32px
|
||
- H2:1.5rem / 24px
|
||
- H3:1.25rem / 20px
|
||
- 正文:1rem / 16px
|
||
- 辅助文字:0.875rem / 14px
|
||
|
||
### 6.4 响应式断点(Bootstrap 5 默认)
|
||
|
||
| 断点 | 尺寸 | 设备 |
|
||
|------|------|------|
|
||
| `sm` | ≥ 576px | 手机横屏 |
|
||
| `md` | ≥ 768px | 平板竖屏 |
|
||
| `lg` | ≥ 992px | 平板横屏/小笔记本 |
|
||
| `xl` | ≥ 1200px | 桌面显示器 |
|
||
| `xxl` | ≥ 1400px | 大屏显示器 |
|
||
|
||
### 6.5 视频播放实现
|
||
- 使用 HTML5 `<video>` 标签播放上传的视频文件
|
||
- 外部视频(YouTube/B站)使用 `<iframe>` 嵌入
|
||
- 响应式视频容器:`aspect-ratio: 16/9`
|
||
|
||
### 6.6 地图实现(Leaflet + 高德瓦片)
|
||
|
||
```javascript
|
||
// 前端 JS 示例
|
||
const map = L.map('customer-map').setView([35.8617, 104.1954], 4); // 中国区域中心
|
||
|
||
// 高德公开瓦片(无需 API Key)
|
||
L.tileLayer('https://webrd0{s}.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x={x}&y={y}&z={z}', {
|
||
subdomains: ['1', '2', '3', '4'],
|
||
attribution: '© 高德地图'
|
||
}).addTo(map);
|
||
|
||
// 从后端 API 获取客户地点并添加标记点
|
||
// 每个点包含:lat, lng, name, address, description
|
||
```
|
||
|
||
---
|
||
|
||
## 七、Django Admin 后台管理设计(面向非技术人员)
|
||
|
||
### 7.1 设计目标
|
||
- **零代码操作**:所有内容更新通过后台表单完成
|
||
- **友好的中文界面**:字段名称、帮助说明全部中文化
|
||
- **分组清晰**:按业务模块分开展示
|
||
- **富文本编辑**:正文内容支持富文本编辑(集成 django-summernote)
|
||
- **排序功能**:列表页支持拖拽排序
|
||
|
||
### 7.2 后台模块分组
|
||
|
||
```
|
||
内容管理
|
||
├── 网站设置(单例:公司信息、联系方式、SEO)
|
||
├── 首页轮播图
|
||
└── ─────────────────
|
||
|
||
产品管理
|
||
├── 产品分类
|
||
└── 产品
|
||
|
||
解决方案
|
||
├── 解决方案分类
|
||
└── 解决方案
|
||
|
||
客户地图
|
||
└── 客户地点
|
||
|
||
新闻中心
|
||
├── 新闻分类
|
||
└── 新闻
|
||
|
||
留言管理
|
||
└── 在线留言
|
||
|
||
系统管理
|
||
├── 用户
|
||
├── 组
|
||
└── 操作日志
|
||
```
|
||
|
||
---
|
||
|
||
## 八、部署方案
|
||
|
||
### 8.1 服务器环境配置
|
||
|
||
#### 8.1.1 系统要求
|
||
- **操作系统**:Ubuntu 24.04 LTS
|
||
- **CPU**:2 核(最低),推荐 4 核
|
||
- **内存**:2GB(最低),推荐 4GB
|
||
- **磁盘**:40GB SSD 以上
|
||
|
||
#### 8.1.2 软件安装清单
|
||
```bash
|
||
sudo apt update && sudo apt upgrade -y
|
||
sudo apt install -y git curl wget vim unzip
|
||
sudo apt install -y python3 python3-pip python3-venv python3-dev
|
||
sudo apt install -y nginx supervisor
|
||
sudo apt install -y certbot python3-certbot-nginx
|
||
```
|
||
|
||
### 8.2 部署架构
|
||
|
||
```
|
||
用户浏览器
|
||
│
|
||
▼
|
||
[阿里云 DNS] ──► www.tgoim.com 解析到 ECS 公网 IP
|
||
│
|
||
▼
|
||
[Nginx] ──► 端口 80/443
|
||
│
|
||
├─ 静态文件 (/static/, /media/) ──► 直接读取本地文件
|
||
│
|
||
└─ 动态请求 ──► [Gunicorn] ──► 端口 8000(内部)
|
||
│
|
||
▼
|
||
[Django Application]
|
||
│
|
||
▼
|
||
[SQLite 数据库]
|
||
```
|
||
|
||
### 8.3 Nginx 配置要点
|
||
- 静态资源(/static/、/media/)由 Nginx 直接处理,设置浏览器缓存
|
||
- 动态请求转发到 Gunicorn(127.0.0.1:8000)
|
||
- 配置 Gzip 压缩
|
||
- HTTP 自动重定向到 HTTPS
|
||
|
||
### 8.4 部署流程(简要)
|
||
```bash
|
||
# 拉取代码 → 创建虚拟环境 → 安装依赖
|
||
# 数据库迁移 → 收集静态文件 → 创建管理员
|
||
# 设置权限 → Supervisor 启动 Gunicorn → 重启 Nginx
|
||
```
|
||
|
||
---
|
||
|
||
## 九、开发进度安排
|
||
|
||
### 9.1 阶段划分
|
||
|
||
| 阶段 | 内容 | 预计工时 |
|
||
|------|------|----------|
|
||
| 阶段一:项目搭建 | Django 初始化、i18n 配置、目录结构 | 0.5 天 |
|
||
| 阶段二:数据库设计 | Models 编写(含双语言字段、视频、客户地图) | 1 天 |
|
||
| 阶段三:后台管理 | Django Admin 配置(面向非技术人员) | 1 天 |
|
||
| 阶段四:公共模板 | base.html、header、footer、语言切换、主题 CSS | 1 天 |
|
||
| 阶段五:首页/关于/历程 | 首页轮播、产品推荐、新闻、关于页、时间轴 | 1 天 |
|
||
| 阶段六:产品中心 | 分类、列表、详情(图库、视频播放) | 1.5 天 |
|
||
| 阶段七:解决方案 | 分类、列表、详情(视频播放) | 1 天 |
|
||
| 阶段八:客户地图 | Leaflet + 高德瓦片、标记点展示 | 0.5 天 |
|
||
| 阶段九:新闻中心 | 分类、列表、详情、分页 | 0.5 天 |
|
||
| 阶段十:联系我们 | 联系信息、留言表单(无邮件通知) | 0.5 天 |
|
||
| 阶段十一:多语言翻译 | 翻译文件编写、双字段切换逻辑 | 1 天 |
|
||
| 阶段十二:响应式调试 | 各端适配、交互优化 | 0.5 天 |
|
||
| **合计** | | **11 天** |
|
||
|
||
---
|
||
|
||
## 十、安全防护
|
||
|
||
- **Django 内置**:CSRF、XSS、SQL 注入防护
|
||
- **服务器**:UFW 防火墙(仅 22/80/443)、Fail2ban
|
||
- **Nginx**:隐藏版本号、限制请求体大小
|
||
- **Admin**:修改默认 admin 路径、强密码策略
|
||
|
||
---
|
||
|
||
## 十一、后续扩展方向(可选)
|
||
|
||
1. **全文搜索**:集成 Django Haystack + Whoosh
|
||
2. **在线客服**:接入企业微信 / 在线客服系统
|
||
3. **数据统计**:接入百度统计 / Google Analytics
|
||
4. **性能监控**:接入 Sentry 错误监控
|
||
5. **CDN 加速**:静态资源上阿里云 CDN
|
||
6. **后台美化**:集成 SimpleUI 美化 Django Admin
|
||
|
||
---
|
||
|
||
*文档结束,确认后开始开发。*
|