X–1 docs / 03 主站

项目前期设计文档

03-A00-项目前期设计文档.md · 3422 字

项目前期设计文档

项目代号: A00
项目名称: TJFS集团官方网站及Web服务器
文档类型: 前期设计文档
创建日期: 2026-03-05
编制人: TBs
文档版本: V1.0
文档状态: 已批准


目录

  1. 设计概述
  2. 需求分析
  3. 系统架构设计
  4. 技术选型
  5. 页面设计
  6. 接口设计
  7. 安全设计
  8. 性能设计
  9. 部署架构
  10. 开发计划

一、设计概述

1.1 项目背景

TJFS集团官方网站是集团的对外展示窗口,需要展示集团的核心价值观、研究方向、业务领域、子公司信息等内容。网站采用单页应用设计,通过平滑滚动实现各章节的导航。

1.2 设计目标

目标编号目标描述优先级
D001实现响应式设计,适配多种设备高
D002提供流畅的动画和交互体验高
D003确保良好的性能和加载速度高
D004代码结构清晰,易于维护中

1.3 设计原则

原则说明
移动优先设计从移动端开始,逐步扩展到桌面端
渐进增强基础功能在无JavaScript时可用
性能优先优化加载速度和运行时性能
可访问性确保所有用户都能访问内容

1.4 文档范围

本文档涵盖TJFS集团官方网站的页面设计、技术架构、接口设计、安全设计、性能设计和部署方案。


二、需求分析

2.1 业务需求

2.1.1 业务流程

用户访问首页
    │
    ├── 浏览集团形象展示
    │
    ├── 查看关于我们
    │
    ├── 了解核心价值观
    │
    ├── 阅读技术哲学
    │
    ├── 查看研究方向
    │
    ├── 了解业务领域
    │
    ├── 查看子公司信息
    │
    ├── 了解合作方式
    │
    ├── 查看招聘信息
    │   └── 提交职位申请(可选)
    │
    └── 发送联系消息(可选)

2.1.2 业务规则

规则编号规则名称规则描述
BR001导航规则导航栏固定顶部,当前章节高亮
BR002动画规则元素进入视口时触发动画
BR003表单规则必填字段验证,提交后显示反馈

2.2 功能需求

2.2.1 功能清单

功能编号功能模块功能名称功能描述优先级
F001首页响应式导航固定导航栏,移动端汉堡菜单P0
F002首页英雄区展示Logo、标语、统计数据P0
F003首页粒子背景动态粒子动画效果P1
F004关于我们信息卡片集团简介、愿景、业务、技术P0
F005关于我们发展历程时间线展示重要节点P1
F006核心价值观价值观卡片四大价值观展示P0
F007技术哲学哲学卡片四大技术哲学理念P1
F008研究方向研究方向卡片七大研究方向展示P0
F009业务领域业务卡片五大业务领域展示P0
F010子公司子公司介绍SG Studio和TBs科技P0
F011合作伙伴合作方式四种合作类型展示P1
F012人才招聘职位列表热招职位展示P1
F013人才招聘职位申请模态框表单P1
F014联系我们联系信息邮箱、地址、社交媒体P0
F015联系我们联系表单在线留言表单P1

2.3 非功能需求

需求类型需求描述指标要求
性能需求首屏加载时间< 3秒
性能需求动画帧率> 30fps
兼容性需求浏览器兼容Chrome 90+, Firefox 88+, Safari 14+
兼容性需求设备兼容PC、平板、手机

2.4 约束条件

约束类型约束描述
技术约束使用原生HTML/CSS/JavaScript
时间约束项目周期1个月
资源约束1名开发人员

三、系统架构设计

3.1 整体架构

┌─────────────────────────────────────────────────────────────┐
│                        客户端                                │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐        │
│  │   PC端       │ │   平板端      │ │   手机端      │        │
│  └──────────────┘ └──────────────┘ └──────────────┘        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        Web服务器                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │              Python HTTP Server                      │   │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐          │   │
│  │  │ 静态文件  │  │  CORS    │  │ 日志记录  │          │   │
│  │  │ 服务     │  │  处理    │  │          │          │   │
│  │  └──────────┘  └──────────┘  └──────────┘          │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        静态资源                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐                  │
│  │ HTML文件  │  │ CSS样式  │  │ JS脚本   │                  │
│  │          │  │          │  │          │                  │
│  └──────────┘  └──────────┘  └──────────┘                  │
└─────────────────────────────────────────────────────────────┘

3.2 架构说明

层级职责技术组件
客户端用户界面展示和交互浏览器
Web服务器静态文件服务、CORS支持Python HTTP Server
静态资源页面内容、样式、脚本HTML/CSS/JS文件

3.3 模块划分

模块编号模块名称模块职责依赖模块
M001导航模块响应式导航栏无
M002英雄区模块首页展示、粒子动画无
M003内容模块各章节内容展示动画模块
M004动画模块滚动动画、计数动画无
M005表单模块表单验证和提交无
M006模态框模块弹窗组件无

3.4 模块交互图

用户操作
    │
    ▼
┌──────────┐
│ 导航模块  │ ── 平滑滚动 ──▶ 内容模块
└──────────┘
    │
    ▼
┌──────────┐
│ 动画模块  │ ◀── 滚动事件 ──
└──────────┘
    │
    ▼
┌──────────┐
│ 表单模块  │ ── 提交 ──▶ 显示反馈
└──────────┘

四、技术选型

4.1 技术栈总览

技术领域技术选型版本选型理由
前端技术HTML5 + CSS3 + JavaScriptES6+原生技术,无需构建,轻量高效
服务器Python HTTP Server3.10+简单稳定,跨平台支持
版本控制Git2.x代码版本管理

4.2 前端技术

组件技术说明
结构HTML5语义化标签,SEO友好
样式CSS3Flexbox/Grid布局,CSS变量
脚本JavaScript (ES6+)原生JS,无框架依赖
动画CSS Animation + JS硬件加速动画
图标内联SVG矢量图标,可缩放

4.3 服务器技术

组件技术说明
运行环境Python 3.10+跨平台支持
HTTP服务器http.server标准库,无需额外安装
请求处理CustomHTTPRequestHandler自定义CORS和日志

4.4 开发工具

工具类型工具名称说明
代码编辑VS Code代码编辑和调试
浏览器Chrome DevTools调试和性能分析
版本控制Git代码版本管理

五、页面设计

5.1 页面结构

index.html
├── head
│   ├── meta标签(字符集、视口、描述)
│   ├── title
│   └── link(CSS、字体)
│
├── body
│   ├── nav(导航栏)
│   │   ├── logo
│   │   ├── 导航菜单
│   │   ├── 子站点入口
│   │   └── 移动端菜单按钮
│   │
│   ├── section#home(英雄区)
│   │   ├── 粒子背景
│   │   ├── 集团Logo和标语
│   │   ├── 统计数据
│   │   └── CTA按钮
│   │
│   ├── section#about(关于我们)
│   │   ├── 信息卡片网格
│   │   └── 发展历程时间线
│   │
│   ├── section#values(核心价值观)
│   │   └── 价值观卡片网格
│   │
│   ├── section#philosophy(技术哲学)
│   │   ├── 哲学卡片
│   │   └── 引言区块
│   │
│   ├── section#research(研究方向)
│   │   └── 研究方向卡片网格
│   │
│   ├── section#business(业务领域)
│   │   ├── 业务卡片
│   │   └── 发展战略时间线
│   │
│   ├── section#subsidiary(子公司)
│   │   ├── SG Studio介绍
│   │   └── TBs科技介绍
│   │
│   ├── section#partners(合作伙伴)
│   │   ├── 合作类型
│   │   └── 合作伙伴权益
│   │
│   ├── section#careers(人才招聘)
│   │   ├── 职位列表
│   │   └── 申请模态框
│   │
│   ├── section#contact(联系我们)
│   │   ├── 联系信息
│   │   └── 联系表单
│   │
│   ├── footer(页脚)
│   │   ├── 品牌信息
│   │   └── 快速链接
│   │
│   └── script(JavaScript)
│
└── 模态框(职位申请)

5.2 响应式断点

断点名称宽度范围布局调整
移动端< 768px单列布局,汉堡菜单
平板端768px - 1024px双列布局
桌面端> 1024px多列布局,完整导航

5.3 色彩方案

颜色名称色值用途
主色调#1a1a2e背景色
次色调#16213e卡片背景
强调色#A8FCF3按钮、高亮
文字主色#e2e8f0主要文字
文字次色#94a3b8次要文字
渐变开始#8b5cf6渐变起始
渐变结束#06b6d4渐变结束

5.4 字体规范

元素字体大小字重
标题H1Noto Sans SC48px-72px700-900
标题H2Noto Sans SC32px-48px700
标题H3Noto Sans SC20px-28px600
正文Noto Sans SC14px-16px400
小字Noto Sans SC12px-14px300-400

六、接口设计

6.1 接口规范

本项目为静态网站,主要接口为页面跳转和表单提交(前端模拟)。

6.2 页面路由

路由页面说明
/首页TJFS集团官网首页
/sgstudio/SG Studio松果工作室子站点
/tbs/TBs科技创生软件子站点

6.3 外部链接

链接类型目标说明
邮箱链接mailto:tjfs_gt_institute@163.com官方邮箱
社交媒体#预留社交媒体链接

七、安全设计

7.1 安全架构

┌─────────────────────────────────────┐
│           客户端安全                 │
│  - 输入验证                          │
│  - XSS防护                          │
└─────────────────────────────────────┘
              │
              ▼
┌─────────────────────────────────────┐
│           传输安全                   │
│  - HTTP/HTTPS                       │
│  - CORS配置                         │
└─────────────────────────────────────┘
              │
              ▼
┌─────────────────────────────────────┐
│           服务器安全                 │
│  - 静态文件服务                      │
│  - 访问日志                         │
└─────────────────────────────────────┘

7.2 CORS配置

# CORS头配置
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type

7.3 输入安全

安全措施说明
前端验证表单字段格式验证
输出转义用户输入内容转义显示

八、性能设计

8.1 性能目标

指标目标值说明
首屏加载< 3秒首屏内容可见
完全加载< 5秒所有资源加载完成
动画帧率> 30fps动画流畅无卡顿
服务器响应< 100ms静态文件响应

8.2 性能优化策略

优化方向优化措施
资源优化内联关键CSS,减少HTTP请求
图片优化使用SVG图标,减少图片大小
代码优化压缩HTML/CSS/JS
缓存策略配置浏览器缓存

8.3 动画性能

优化项措施
使用transform使用transform和opacity实现动画
will-change对动画元素添加will-change提示
减少重绘避免触发layout和paint

九、部署架构

9.1 部署拓扑

                    ┌─────────────────┐
                    │    用户请求      │
                    └────────┬────────┘
                             │
                             ▼
                    ┌─────────────────┐
                    │   Web服务器      │
                    │  (Python HTTP)   │
                    │    Port 80      │
                    └────────┬────────┘
                             │
                             ▼
                    ┌─────────────────┐
                    │   静态文件       │
                    │  HTML/CSS/JS    │
                    └─────────────────┘

9.2 环境规划

环境用途配置访问地址
开发环境开发调试本地Pythonhttp://localhost:80
测试环境测试验证本地Pythonhttp://localhost:8537
生产环境正式运行生产服务器http://tjfs.com

9.3 服务器配置

Python HTTP服务器配置:

# 服务器配置
PORT = 80  # 或 8537
DIRECTORY = Path(__file__).parent.resolve()

# CORS配置
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS

十、开发计划

10.1 迭代规划

迭代迭代目标开始日期结束日期
Sprint 1页面结构和样式2026-03-112026-03-15
Sprint 2交互和动画2026-03-162026-03-20
Sprint 3服务器和部署2026-03-212026-03-25

10.2 任务分解

任务编号任务名称负责人预计工时开始日期结束日期
T001HTML结构开发TBs16h2026-03-112026-03-13
T002CSS样式开发TBs16h2026-03-132026-03-15
T003JavaScript交互TBs16h2026-03-162026-03-18
T004动画效果实现TBs12h2026-03-182026-03-20
T005Python服务器TBs8h2026-03-212026-03-22
T006测试和优化TBs16h2026-03-232026-03-25

10.3 依赖关系

T001 (HTML结构)
    │
    ▼
T002 (CSS样式)
    │
    ▼
T003 (JS交互) ──▶ T004 (动画效果)
    │
    ▼
T005 (服务器)
    │
    ▼
T006 (测试优化)

附录

附录A: 术语表

术语定义
CORS跨域资源共享
SVG可缩放矢量图形
DOM文档对象模型
ES6ECMAScript 2015

附录B: 参考资料

附录C: 变更记录

版本日期变更内容变更人
V1.02026-03-05初始版本TBs

文档编制日期: 2026-03-05
编制单位: SG Studio - 松果工作室
文档版本: V1.0