Files
company_website/项目开发方案.md
T
2026-08-03 14:42:40 +08:00

27 KiB
Raw Blame History

公司官方网站开发方案

域名: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)核心配置

# 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

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

5.2.3 静态文件 & 媒体文件

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 + 高德瓦片)

// 前端 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 软件安装清单

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 部署流程(简要)

# 拉取代码 → 创建虚拟环境 → 安装依赖
# 数据库迁移 → 收集静态文件 → 创建管理员
# 设置权限 → 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

文档结束,确认后开始开发。