SocialResourceDockingApplication/doc/FunctionDocument.md

SocialResourceDocking 功能说明文档

Author 筱锋xiao_lfeng | Version: V1.0.0

功能简介

该系统由四个核心组成部分构成：登录模块、功能模块、数据交换、页面展示 登录部件：确保用户安全接入系统 功能模块：分为政府类、企业类、社区类、其他类，主要用于打破大学生与社会的信息差，方便各类社会组织和大学生双向上传需求：例如义工服务、创新创业合作、行业培训、社会实践、公益活动等，以此来满足双方的需求。 数据交换：保证信息流在系统内部和外部各实体间的高效、安全传输 界面展示：优化了用户体验，使得信息查阅和管理清晰、直观。

本项目旨在构建一款综合性系统，通过四个核心部分的协同工作，实现政府、企业、社区与大学生之间的信息共享与合作。通过该系统，大学生可以更便捷地参与各类社会活动，获得创新创业机会，完成行业培训，参与社会实践和公益活动。同时，各社会组织也能更轻松地找到合适的大学生资源，促进双向合作，打破信息壁垒，实现资源的共享和优化。通过数据交换保障信息的高效安全传输，通过优化界面展示提高用户体验，本项目旨在为大学生和社会组织提供一个便捷、高效、安全的合作平台。

概要描述

本系统服务的客户群体涵盖学生、老师、企业、政府相关部门以及各类机构。系统功能主要以双向参与为特点，为学生提供多方位支持。对政府而言，系统可用于社会实践和义工服务，帮助招募志愿者，并推送文章和政策解读以培养青年思想。对企业，系统支持创新创业合作，提供悬赏解决方案，申请孵化和资金支持，以及进行行业培训和职业发展。生态环保与可持续发展方面，企业可发布成果并征求解决方案。系统还服务社区，支持公益活动和各类文艺活动。其他主体如医疗结构和培训机构可通过平台宣讲知识、技能并发布相关服务。系统的多功能性旨在促进各方合作、交流与发展。

特点描述

本系统的显著特点在于其多功能性和双向参与机制。首先，系统通过覆盖学生、老师、企业、政府和各类机构等广泛客户群体，构建了一个全方位的服务平台。其次，系统支持政府举办社会实践和义工服务活动，同时提供文章推送和政策解读，以培养青年思想，将个人发展与国家命运紧密联系。对企业而言，系统不仅提供创新创业合作平台，还支持行业培训和职业发展，促使学生更好地理解实际岗位需求。生态环保与可持续发展方面，企业可以在平台上发布成果并吸引学生参与创新思考。此外，系统服务社区，鼓励学生参与公益和文艺活动，强化社区凝聚力。最后，系统还对其他主体如医疗结构和培训机构提供宣讲知识、技能的机会，实现全方位的社会资源对接。这一综合性的特点使得系统成为一个有力的创新与合作平台，为各方搭建交流桥梁，推动社会各领域的共同发展。

架构说明

根据提供功能模块叙述，将上述模块进行划分，可主要划分为如下模块

• 招募模块
• 文章模块
• 题解模块
• 孵化模块
• 交友模块
• 活动模块
• 服务模块
• 交易模块

数据库架构设计

数据表组织

数据表设计

-- 用户数据表
-- srd_user
create table srd_user
(
    id                bigint unsigned auto_increment comment '用户主键'
        primary key,
    username          varchar(40)                          not null comment '用户名',
    nickname          varchar(20)                          null comment '昵称',
    email             varchar(50)                          not null comment '邮箱',
    tel_country_area  int        default 86                not null comment '电话所属国区',
    tel               varchar(20)                          not null comment '电话号码',
    verify            tinyint(1) default 0                 not null comment '用户是否校验',
    password          varchar(100)                         not null comment '密码',
    old_password      varchar(100)                         null comment '旧密码',
    created_at        timestamp  default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at        timestamp                            null comment '信息修改时间',
    ban               tinyint(1) default 0                 not null comment '是否被封禁',
    permission        json                                 null comment '权限组',
    contact_qq        varchar(15)                          null comment 'qq号',
    contact_wechat    varchar(30)                          null comment '微信号',
    organization_type tinyint unsigned                     null comment '其他/学校/政府/企业/组织',
    organization_list bigint unsigned                      not null comment '所属列表',
    constraint srd_user_email_uindex
        unique (email),
    constraint srd_user_username_uindex
        unique (username)
)
    comment '用户数据表';

-- RAM用户
-- srd_user_ram
create table srd_user_ram
(
    id               bigint unsigned auto_increment comment '主键'
        primary key,
    user_id          bigint unsigned                      not null comment '主用户ID',
    username         varchar(40)                          not null comment '用户名',
    nickname         varchar(20)                          null comment '昵称',
    email            varchar(50)                          not null comment '邮箱',
    tel_country_area int        default 86                not null comment '电话国家区号',
    tel              varchar(20)                          not null comment '电话',
    password         varchar(100)                         not null comment '密码',
    created_at       timestamp  default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at       timestamp                            null comment '更新时间',
    ban              tinyint(1) default 0                 not null comment '是否禁用',
    permission       json                                 null comment '权限组',
    contact_qq       varchar(15)                          null comment '联系QQ',
    contact_wechat   varchar(30)                          null comment '联系微信',
    constraint srd_user_ram_email_uindex
        unique (email),
    constraint srd_user_ram_username_uindex
        unique (username),
    constraint srd_user_ram_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
            on delete cascade
);

-- 用户Token
-- srd_user_token
create table srd_user_token
(
    id         bigint unsigned auto_increment comment '令牌主键'
        primary key,
    user_type  tinyint(1) default 0 not null comment '用户类型',
    user_id    bigint unsigned      not null comment '用户id',
    token      varchar(50)          not null comment '令牌',
    expired_at timestamp            not null comment '过期时间',
    created_at timestamp            not null comment '创建时间',
    ip         varchar(45)          null comment 'IP地址',
    user_agent varchar(255)         null comment '用户UA'
)
    comment '用户Token';

-- 学校类型
-- srd_resources_school_type
create table srd_resources_school_type
(
    id         int unsigned auto_increment comment '学校类型主键'
        primary key,
    name       varchar(100) not null comment '类型名字',
    created_at timestamp    not null comment '创建时间',
    updated_at timestamp    not null comment '修改时间'
)
    comment '学校类型';

-- 学校数据库
-- srd_resources_school
create table srd_resources_school
(
    id              bigint unsigned auto_increment comment '学校主键'
        primary key,
    name            varchar(255) not null comment '学校名称',
    type            int unsigned null comment '学校类型',
    locate_province varchar(255) not null comment '省份',
    locate_city     varchar(255) not null comment '城市',
    locate_area     varchar(255) not null comment '所在地区',
    locate_lat      double       not null comment '所在纬度',
    locate_lng      double       not null comment '所在经度',
    created_at      timestamp    not null comment '创建时间',
    updated_at      timestamp    not null comment '更新时间',
    constraint srd_resources_school_srd_resources_school_type_id_fk
        foreign key (type) references srd_resources_school_type (id)
            on delete set null
)
    comment '学校数据库';

-- 企业类型
-- srd_resources_organization_type
create table srd_resources_organization_type
(
    id         int unsigned auto_increment comment '类型主键'
        primary key,
    name       varchar(100) not null comment '类型名称',
    created_at timestamp    not null comment '创建时间',
    updated_at timestamp    not null comment '修改时间'
)
    comment '企业类型';

-- 企业列表
-- srd_resources_organization
create table srd_resources_organization
(
    id                 bigint unsigned not null comment '企业主键'
        primary key,
    name               varchar(255)    not null comment '企业全名',
    code_credit        varchar(18)     not null comment '统一社会信用代码',
    code_agency        varchar(10)     null comment '组织机构代码',
    type               int unsigned    null comment '企业类型',
    company_created_at timestamp       not null comment '营业期限（起始）',
    company_updated_at timestamp       not null comment '营业期限（结束）',
    created_at         timestamp       not null comment '创建时间',
    updated_at         timestamp       not null comment '修改时间',
    constraint srd_resources_company_srd_resources_company_type_id_fk
        foreign key (type) references srd_resources_organization_type (id)
            on delete set null
)
    comment '企业列表';

-- 校验码
-- srd_verify_code
create table srd_verify_code
(
    id         bigint unsigned auto_increment comment '主键'
        primary key,
    type       tinyint unsigned not null comment '类型（0:邮箱，1:手机）',
    contact    varchar(50)      not null comment '联系方式',
    code       varchar(12)      not null comment '校验码',
    expired_at timestamp        not null comment '过期时间',
    created_at timestamp        not null comment '创建时间'
)
    comment '校验码';

-- 分类
-- srd_classify
create table srd_classify
(
    id         int unsigned auto_increment comment '分类主键'
        primary key,
    name       varchar(10)                         not null comment '分类名字',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '更新时间'
)
    comment '分类';

-- 话题
-- srd_topic
create table srd_topic
(
    id         bigint unsigned auto_increment comment '主键'
        primary key,
    user_id    bigint unsigned                     null comment '话题创建人（RAM用户创建以主用户为准）',
    name       varchar(20)                         not null comment '话题名字',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '修改时间',
    constraint srd_topic_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
            on delete set null
)
    comment '话题';

-- 文章
-- srd_article
create table srd_article
(
    id         bigint unsigned auto_increment comment '主键'
        primary key,
    user_type  tinyint unsigned                           not null comment '普通/组织/RAM',
    user_id    bigint unsigned                            not null comment '用户主键',
    title      varchar(50)                                not null comment '文章标题',
    classify   json                                       not null comment '文章类型',
    topic      bigint unsigned                            null comment '话题',
    `desc`     varchar(100)                               null comment '描述',
    article    longtext                                   not null comment '文章正文',
    state      tinyint unsigned default '0'               not null comment '状态',
    created_at timestamp        default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                                  null comment '更新时间',
    deleted_at timestamp                                  null comment '删除时间',
    constraint srd_article_srd_topic_id_fk
        foreign key (topic) references srd_topic (id)
            on delete set null
)
    comment '文章';

-- 评论
-- srd_comment
create table srd_comment
(
    id           bigint unsigned auto_increment comment '组件'
        primary key,
    comment_type int unsigned                        not null comment '评论类别',
    comment_id   bigint unsigned                     not null comment '对应评论类别的主键',
    user_type    tinyint(1)                          not null comment '用户类型',
    user_id      bigint unsigned                     not null comment '用户主键',
    comment      text                                not null comment '评论',
    replay       bigint unsigned                     null comment '回复',
    created_at   timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at   timestamp                           null comment '修改时间',
    constraint srd_comment_srd_comment_id_fk
        foreign key (replay) references srd_comment (id)
            on delete cascade
)
    comment '评论';

-- 招募类型
-- srd_recruit_type
create table srd_recruit_type
(
    id         int unsigned auto_increment comment '主键'
        primary key,
    user_id    bigint unsigned                     null comment '词条创建者',
    name       varchar(20)                         not null comment '词条名字',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '修改时间',
    constraint srd_recruit_type_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
            on delete set null
)
    comment '招募类型';

-- 招募
-- srd_recruit
create table srd_recruit
(
    id          bigint unsigned auto_increment comment '组件'
        primary key,
    user_type   tinyint(1)                           not null comment '用户类型',
    user_id     bigint unsigned                      not null comment '用户主键',
    title       varchar(50)                          not null comment '招募标题',
    type        int unsigned                         null comment '招募类型',
    classify    json                                 null comment '分类',
    `desc`      longtext                             not null comment '招募描述',
    number      int        default 1                 not null comment '招募人数',
    recruited   json                                 null comment '已招入用户',
    price_type  tinyint(1) default 0                 not null comment '是否有金额',
    price_start int                                  not null comment '起始价格',
    price_end   int                                  not null comment '结束价格',
    created_at  timestamp  default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at  timestamp                            null comment '修改时间',
    constraint srd_recruit_srd_recruit_type_id_fk
        foreign key (type) references srd_recruit_type (id)
            on delete set null
)
    comment '招募';

-- 项目孵化
-- srd_incubation
create table srd_incubation
(
    id         bigint unsigned auto_increment comment '主键'
        primary key,
    user_id    bigint unsigned                     not null comment '用户主键',
    name       varchar(50)                         not null comment '项目名称',
    type       int unsigned                        not null comment '类别',
    `desc`     longtext                            not null comment '详细描述',
    state      tinyint   default 0                 not null comment '当前状态',
    company    bigint unsigned                     null comment '签约企业',
    contract   text                                null comment '签约合同',
    mooney     int                                 null comment '经济',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '修改时间',
    signing_at timestamp                           null comment '签名时间',
    constraint srd_incubation_srd_resources_organization_id_fk
        foreign key (company) references srd_resources_organization (id),
    constraint srd_incubation_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
)
    comment '项目孵化';

-- 交友
-- srd_user_friend
create table srd_user_friend
(
    id         bigint unsigned auto_increment comment '主键'
        primary key,
    user_id    bigint unsigned                      not null comment '用户主键',
    friend_id  bigint unsigned                      not null comment '好友',
    state      tinyint(1) default 0                 not null comment '对方是否同意',
    created_at timestamp  default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                            null comment '修改时间',
    constraint srd_user_friend_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
            on delete cascade,
    constraint srd_user_friend_srd_user_id_fk_2
        foreign key (friend_id) references srd_user (id)
            on delete cascade
)
    comment '交友';

-- 题解类型
-- srd_solve_problem_type
create table srd_solve_problem_type
(
    id         int unsigned auto_increment
        primary key,
    name       varchar(20)                         not null comment '类型名字',
    `desc`     varchar(255)                        null comment '类型描述',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '修改时间'
)
    comment '题解类型';

-- 题解模块
-- srd_solve_problem
create table srd_solve_problem
(
    id         bigint unsigned auto_increment comment '组件'
        primary key,
    user_id    bigint unsigned                     not null comment '用户主键',
    title      varchar(50)                         not null comment '题解标题',
    type       int unsigned                        null comment '题解类型',
    `desc`     longtext                            not null comment '题解描述',
    money      double    default 0                 not null comment '题解金额',
    solve_by   bigint unsigned                     null comment '解决用户',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    updated_at timestamp                           null comment '修改时间',
    solved_at  timestamp                           null comment '解决时间',
    constraint srd_solve_problem_srd_solve_problem_type_id_fk
        foreign key (type) references srd_solve_problem_type (id)
            on delete set null,
    constraint srd_solve_problem_srd_user_id_fk
        foreign key (solve_by) references srd_user (id),
    constraint srd_solve_problem_srd_user_id_fk_2
        foreign key (user_id) references srd_user (id)
)
    comment '题解模块';

-- 交流
-- srd_talk
create table srd_talk
(
    id         bigint unsigned auto_increment
        primary key,
    user_id    bigint unsigned                     not null comment '用户主键',
    topic      bigint unsigned                     null comment '话题',
    talk       mediumtext                          not null comment '聊天',
    replay     bigint unsigned                     null comment '回复',
    created_at timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    constraint srd_talk_srd_talk_id_fk
        foreign key (replay) references srd_talk (id)
            on delete set null,
    constraint srd_talk_srd_topic_id_fk
        foreign key (topic) references srd_topic (id)
            on delete set null,
    constraint srd_talk_srd_user_id_fk
        foreign key (user_id) references srd_user (id)
            on delete cascade
)
    comment '交流';

整体架构

整体架构图如下图所示

用户整体架构设计

用户架构分配图（区分用户区别）

说明

1. 自主注册与非自主注册用户主要区别在于是否在网站上注册
2. 用户注册需要进行用户激活校验，需要用户进行邮件内容校验
3. 用户操作较为敏感的信息，需要进行邮箱校验码进行验证，验证通过后允许操作
4. RAM用户的权限不应该超过普通用户所具有的权限（另外：管理员用户不允许有RAM用户的权限）
5. 普通用户进行权限组切换的时候需要检查名下所有RAM用户（若存在RAM用户需要进行移除，切换权限组时候不允许存在RAM用户）

用户授权

用户授权采用授权 token 的形式进行授权，在用户执行登陆或注册的时候执行生成 token 并且校验所生成的 token 是否重复（务必保证生成的 token 在数据表中处于唯一状态）

Token（令牌）对应格式：(补)(Timestamp)-^[0-9A-Za-z-_]{20}$-^[0-9]{14}$

​ 其中 (补) 对应时间戳（timestamp位数不为14的情况下）

​ (timestamp) 为时间戳函数，截至目前时间戳位数处于 13 位

​ 令牌总计字节一共 50 位

用户进行登陆和注册的时候，在操作执行完毕之后进行 Token 创建并且绑定给用户表，还需要将用户的 ip 地址和 userAgent 信息上传到数据库，以确保 token 的有效性。（请注意：由于目前互联网环境，用户很可能在访问网站的时候出现很多个IP进行访问，对于跨地域时候尤其明显。所以进行 token 校验时候需要仅需检查 userAgent 是否一致即可，作出大致判断，无需详细检查<UserAgent也可复制>的。）

用户组别

对于组织用户，除学校组织单独组织数据表，其余所有组织以 organization 数据表为准

组织用户架构设计

组织用户设计中，允许一位主干进行账号注册操作，即组织注册登记。主干账号登记后，允许主干账号开设RAM子账号。RAM账号的开设不得多于100个账号（不含100个）

组织用户注册授权模式

模块设计

文章模块

招募模块

孵化模块

服务模块

服务模块为一大板块，其中包含了 题解模块、活动模块、交友模块、推广模块等 子模块