first commit

This commit is contained in:
2026-08-03 14:42:40 +08:00
commit 523ad43ef7
85 changed files with 3703 additions and 0 deletions
+707
View File
@@ -0,0 +1,707 @@
# 公司官方网站开发方案
**域名**: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: '&copy; 高德地图'
}).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
---
*文档结束,确认后开始开发。*