76 lines
2.7 KiB
Markdown
76 lines
2.7 KiB
Markdown
# SocialResourceDocking 全局开发者文档
|
||
|
||
<div align="right">Author 筱锋xiao_lfeng | Version: V1.0.0</div>
|
||
|
||
## 说在前面
|
||
|
||
> 这部分为大部分接口文档通用部分的内容说明，具体每个接口的开发文档请参考
|
||
>
|
||
> <div align="right">———— 筱锋xiao_lfeng</div>
|
||
|
||
|
||
|
||
## 切面说明
|
||
|
||
> 切面为了更好进行快速开发，并且拒绝重复开发而生。开发时候请务必按照规定和标准化命名方案进行开发。下面会说切面在本开发中具体作用是什么
|
||
|
||
根据不同接口的权限要求不一样，故并非全部页面所需要的切面都一样。对于切面，**每一个切面仅会实现其中一种功能**。而并不是实现**全部功能**。故根据接口需要进行切面开发并且进行切面内容导入！
|
||
|
||
### 权限控制切面
|
||
|
||
|
||
|
||
### 时间戳控制切面
|
||
|
||
时间戳控制切面是对输入数据进行时间检验，检查输入的数据是否符合时间范围，保证数据的有效性。
|
||
|
||
另外，第二个时间戳控制切面为对数据表单进行校验。原理如下
|
||
|
||
在页面生成时候前端生成 \<form> 表单
|
||
|
||
|
||
|
||
## 登陆说明
|
||
|
||
对于 `srd_user` 和 `srd_user_ram` 数据表中 `permission` 字段部分json格式如下
|
||
|
||
```json
|
||
{
|
||
"group": "String",
|
||
"permission": []
|
||
}
|
||
```
|
||
|
||
另外，请注意，对于 `srd_user` 数据表中主键 `id` 字段值为 `1` 的用户为 `global` 权限。为整个系统中最高级权限。任何页面都可以访问以及随意切换内容页面
|
||
|
||
其余部分请参考**《功能说明文档》**以及**《SocialResourceDocking 开发者文档》**
|
||
|
||
### group 字段说明
|
||
|
||
在 `group` 字段中，具体具有值如下：
|
||
|
||
- user
|
||
|
||
- student
|
||
|
||
- teacher
|
||
|
||
- admin
|
||
|
||
- organization
|
||
|
||
仅值为 `"organization"` 代表为组织账号，其余字段均为普通账号
|
||
|
||
> 在社会学和管理学领域，组织通常指的是一个有目的、有结构的社会实体，它由一群人共同协作以达到共同的目标。这个实体可以是企业、政府机构、非营利组织、团体等。组织的特征包括人员、结构、文化、目标和资源等。管理学关注如何有效地组织和管理这些实体，以实现其既定的目标。
|
||
>
|
||
> <div align="right">———— 什么是组织</div>
|
||
|
||
在组织账号中，通过区分统一社会信用码来区分不同组织账号主体类型。具体区分内容参考数据库设计模式
|
||
|
||
### permission 字段说明
|
||
|
||
`permission` 字段表示内容为解决 group 权限组分组带来部分场景下权限组分配不够用，故单独为此用户赋予的额外权限
|
||
|
||
其值样式为 `admin.user.create` 或 `admin.user.*` 。采用点进行权限组类别区分，`*` 为赋予子权限段全部权限
|
||
|