技术规格说明书

技术规格说明书

项目
这个作业属于哪个课程	https://bbs.csdn.net/forums/buaa-ase2023?typeId=2469180
这个作业的要求在哪里	https://bbs.csdn.net/topics/605875307?spm=1001.2014.3001.6377
我们在这个课程的目标是	学习并实践软件工程开发的方法论。在把握整体流程和内容要素的基础上实践细节，培养开发技术、开发思维、团队协作等能力。
这个作业在哪个具体方面帮助我们实现目标	对产品的技术规格进行描述和规划，为Alpha阶段的开发勾勒蓝图

前端

一、所选择的技术栈

• html + css + JavaScript
• 部署环境：ubuntu18.04 + node v16.13.0
• 应用开发框架：vue3 + element-plus

二、软件的总体架构

1. 包含的子系统

1. 用户登录和认证系统：此子系统负责用户的登录和认证。它应该包括一个登录页面，注册页面，以及适当的逻辑来验证用户的凭据。并且支持管理员账号登录。

   • 支持用户使用用户名和密码进行登录。
   • 能够验证用户输入的凭据是否正确，并在验证失败时显示错误消息。

2. 地图显示系统：此子系统负责显示地图及其上的所有地点。它应该包括一个地图界面，能够展示所有可用的地点信息。

   • 能够显示原始地图图像、以及进行缩放和拖动。
   • 能够在地图上标出所有地点。
   • 能够根据用户选择的地点，展开包含更多详细信息的信息框。

3. 数据库存储系统：此子系统负责存储在智能地图软件中使用的所有数据。

   • 能够安全地存储所有用户和地点信息。
   • 能够支持多个用户同时访问数据库。

4. 新地点添加系统：此子系统负责让用户添加新的地点并将其与地图上的其他地点区分开来。

   • 能够接受用户输入的地点详细信息。
   • 能够自动将新的地点添加到地图上，并为其指定一个唯一的ID号。
   • 当新地点被添加到地图上时，可以向用户显示一个成功的消息。

5. 地点搜索系统：此子系统负责让用户搜索并找到他们感兴趣的地点。

   • 能够接受用户输入的搜索词，并在地图上查找所有与该词匹配的地点。

6. 讨论区/论坛系统：此子系统将允许用户通过进入论坛来使用论坛功能。

   • 能够为智能地图软件和论坛之间提供必要的链接，以便用户轻松地从地图跳转到论坛页面。

7. 管理员系统：此子系统实现以管理员权限登录的附加功能。

   • 能够删除、隐藏论坛的帖子
   • 能够修改、添加新地点
   • 能够修改地点的详细信息

2. 各个子系统内部

1. 用户登录和认证系统：
   1. 登录模块：包含用户登录的窗口、登录的信息验证逻辑、适当的信息反馈窗口
   2. 注册模块：包含用户注册的窗口，满足多种注册方式以及相应的反馈
2. 地图显示系统：
   1. 整体地图模块：包含地图的显示与整体信息，实现对地图整体的操作，如放大、拖动等。
   2. 详细信息模块：对应于每个地点，提供展示该地点的详细信息的窗口，以及进项该地点相关操作的按钮接口。
   3. 地图标记模块：包含在地图上标记的相关信息，实现标记的展示、记录与相关操作。
3. 数据库存储系统：
   1. 用户信息模块：储存用户的用户名、密码、使用记录等信息。
   2. 地图信息模块：储存各地点位置、详细信息等。
   3. 控制模块：控制存储系统的多线程操作等运行。
4. 新地点添加系统：
   1. 数据库关联模块：用于向数据库中添加相关信息。
   2. 地图系统关联模块：用于获取、处理、展示新添加信息。
   3. 提示信息模块：提示输入、显示反馈等功能。
5. 地点搜索系统：
   1. 输入模块：用于提示并获取用户输入，并给出相应提示。
   2. 检索模块：包含检索算法、推荐算法。
   3. 结果展示模块：将反馈结果展示与界面。
6. 论坛系统：
   1. 讨论帖模块：实现一个单独的帖子的内容表现、评论等功能。
   2. 分类模块：用于分类检索各种讨论帖。
7. 管理员系统：
   1. 管理员登录验证模块：用于验证管理员权限的登录
   2. 地图管理员模块：实现地图系统中管理员权限操作
   3. 论坛管理员模块：实现论坛系统中管理员权限操作

三、功能的详细设计

1. 地图

地图页面显示了所有的公共地图钉与用户自身设置的私有地图钉。对于未登录用户，仅显示公共地图钉。

用户可以在本页面对地图进行缩放，查看BUAA学院路校区的地图；还可以在搜索栏搜索相关的信息，可以按照相关程度搜索地图钉和帖子，点击搜索结果后，地图会聚焦到对应地图钉，便于用户查看地图钉详细内容。

右键地图会出现菜单栏。在登录情况下，可以点击“添加钉子”按钮以进行地图钉的添加。也可以通过“修改位置”选择拥有权限的地图钉移动到该位置。

点击地图钉后，会显示出地图钉的详细信息，图片过多可以左右滑动，点击图片可以放大预览。对于私有地图钉，用户可以通过点击“申请公共”按钮将其申请为公共地图钉，后续待管理员审核。管理员可以修改公共地图钉数据，用户只能修改私人地图钉数据，希望更改公共地图钉可以通过向管理员反馈的方式。

2. 注册、登录

提供注册、登录功能。注册需要邮箱验证。

3. 论坛

• 论坛（Forum）界面

  

  论坛界面的主要功能是推荐热门帖子，并且为用户提供筛选、搜索、创建帖子的功能。

  “人像”的位置展示用户头像和用户昵称。

  用户可以通过搜索框搜索帖子，并且可以通过勾选Tag筛选帖子。Hot栏目可以根据用户所筛选的类别