Merge pull request 'Add Login API(#20)' (#34) from dev-mrkbear into master

Reviewed-on: http://git.mrkbear.com/MrKBear/mini-dlpu-v3/pulls/34

README.md

@@ -4,7 +4,7 @@
 
 __*!!!警告!!!*__
 
-请在主仓库提交代码，而非镜像仓库！在镜像仓库提交的代码将会在同步时被覆盖！
+*请在主仓库提交代码，而非镜像仓库！在镜像仓库提交的代码将会在同步时被覆盖！*
 
 主仓库： http://git.mrkbear.com/MrKBear/mini-dlpu-v3
 
@@ -15,8 +15,9 @@ __*!!!警告!!!*__
 - [社区介绍](#小程序社区)
 - [项目设计](#第三代小程序)
 - [贡献规范](#社区贡献规范)
+- [社区福利](#贡献者分配制度)
 - [API文档](https://docs.apipost.cn/preview/e737de418d4ef150/419d45d8c97d6a9f)
-- [入门文档(等待撰写)](#第三代掌上教务处小程序)
+- [入门文档(等待撰写)](#快速入门)
 - [设计架构(等待撰写)](#第三代掌上教务处小程序)
 
 ## 小程序社区
@@ -98,6 +99,65 @@ __*!!!警告!!!*__
 
 5. 一个文件不要超过 1000 行代码，尽量保证代码可读性
 
+## 贡献者分配制度
+
+作为公益的开源项目：
+
+第三代开发时，将计划加入一个赞助功能，每个月赞助累计到达一定数额，将在下个月去除开屏广告。
+
+第三代上线后，我们将在每个月公示小程序的账目流水，去除服务器成本和其他费用(微信认证，微信支付，域名，...)后，若有剩余数额将按照开发时大家的贡献分配。
+
+小程序的广告位将计划外包给其他组织管理，我们也会得到一定收入，此收入也将按上面的规则处理。
+
+小程序开屏广告收入也同样按上面的规则处理。
+
+以上内容请大家仔细阅读，另外有意向负责项目财务的同学，处理财务账目也算做贡献。
+
+## 快速入门
+
+下面对大家的小问题进行解答：
+
+> 我在参与贡献之前，我需要先会哪些知识？他们好学吗？
+
+下面列出此项目使用的全部技术，从上到下是推荐学习顺序和学习重点，也是难度顺序：
+- HTML 
+  - 标签结构和语法
+- CSS 
+  - 基础样式
+  - 选择器
+  - 盒模型
+  - 布局和定位
+  - 行内元素和块级元素
+- JS
+  - 数据类型
+  - 基础运算符
+  - 流程控制语句
+  - 函数与闭包 (瓶颈)
+  - 原型和对象 (突破)
+- Vue (不用深入了解)
+  - 组件化设计思想
+- 小程序 API
+  - 了解小程序如何编写页面
+  - 了解小程序大概的 API
+  - 不用深入了解，随时查阅
+- TypeScript (只要JS数据结构玩的6，TS五分钟学会)
+  - 类型约束
+  - 接口
+  - 泛型
+  - 类型运算
+- Sass (拓展了CSS语法，实际上没有任何新知识)
+  - 语法
+
+> 小程序和主流前端技术差别在哪？对我以后职业发展帮助大嘛？
+
+如果你已经掌握了前端主流技术，例如 Vue，React，那么上手小程序只是 __1__ 天的事情
+
+换句话来说小程序开发用到技术和主流前端技术，有大概 __90%__ 是重叠的。
+
+小程序学了可以成为加分项，参与贡献拥有 __20000__ 人的项目，丰富项目经历，稳赚不亏。
+
+掌上教务处前端项目采用了很多创新的架构设计，虽然不一定优秀，但是一定是值得学习的。
+
 ## 贡献者
 
 @MrKBear (熊鲜森)

miniprogram/api/Login.ts

@@ -0,0 +1,149 @@
+import { API, HTTPMethod, IParamSetting, GeneralCallbackResult } from "../core/Api";
+
+interface ILoginInput {
+
+    /**
+     * 学号
+     */
+    studentId: string;
+
+    /**
+     * 教务处密码
+     */
+    password: string;
+}
+
+interface ILoginOutput {
+
+    /**
+     * 身份证后六位
+     * 用于尝试水卡登录
+     */
+    idCardLast6: string;
+
+    /**
+     * 使用的教务处链接
+     */
+    eduService: string;
+
+    /**
+     * 用户的真实姓名
+     */
+    actualName: string;
+
+    /**
+     * 用户是否关注了公共号
+     */
+    isSubscribeWxAccount: boolean;
+
+    /**
+     * 教务处的 session
+     */
+    eduSession: string;
+}
+
+interface ILoginEvent {
+
+    /**
+     * session 过期
+     */
+    expire: GeneralCallbackResult;
+
+    /**
+     * 登录失败
+     */
+    unauthorized: GeneralCallbackResult;
+
+    /**
+     * 未知的问题
+     */
+    error: GeneralCallbackResult;
+
+    /**
+     * 数据损坏或丢失
+     */
+    badData: GeneralCallbackResult;
+}
+
+/**
+ * Login API
+ * 此 API 用来向教务处发起登录请求
+ * 请求成功后将获得教务处返回的 session
+ */
+class Login extends API<ILoginInput, ILoginOutput, ILoginEvent> {
+
+    public override url: string = "/login";
+
+    public override method: HTTPMethod = HTTPMethod.POST;
+
+    public override params: IParamSetting<ILoginInput> = {
+
+        studentId: {
+            mapKey: "id",
+            tester: /^\d{8,12}$/,
+        },
+
+        password: {
+            mapKey: "pwd"
+        }
+    };
+
+    public constructor() {
+        super();
+        this.initDebugLabel("Login");
+
+        this.addFailedCallBack();
+
+        this.on("success", (data) => {
+
+            let isSuccess = true;
+            let errMsg = "";
+            let res: ILoginOutput | undefined;
+            const info: any = data.data;
+
+            // 数据缺失检测
+            if(!info) {
+                isSuccess = false;
+                errMsg = "Bad Data";
+                this.emit("badData", { errMsg });
+            }
+
+            if (isSuccess) switch (info.code) {
+                case (1):
+                    res = {
+                        idCardLast6: info.data.idCard,
+                        eduService: info.data.ip,
+                        actualName: info.data.name,
+                        isSubscribeWxAccount: info.data.official,
+                        eduSession: info.data.session
+                    };
+                    errMsg = info.err_msg ?? "Success";
+                    this.emit("ok", res);
+                    break;
+
+                case (2):
+                    isSuccess = false;
+                    errMsg = info.err_msg ?? "Session Expire";
+                    this.emit("expire", { errMsg });
+                    break;
+
+                case (3):
+                    isSuccess = false;
+                    errMsg = info.err_msg ?? "Unauthorized";
+                    this.emit("unauthorized", { errMsg });
+                    break;
+
+                case (4):
+                    isSuccess = false;
+                    errMsg = info.err_msg ?? "Error";
+                    this.emit("error", { errMsg });
+                    break;
+            }
+
+            if (!isSuccess) this.emit("no", { errMsg });
+            this.emit("done", { errMsg, data: res });
+        });
+    }
+}
+
+export { Login, ILoginInput, ILoginOutput };

miniprogram/core/Api.ts

@@ -33,6 +33,11 @@ type DeepReadonly<T> = {
 type IParamSetting<T extends IAnyData> = {
     [P in keyof T]: {
 
+        /**
+         * 键值映射
+         */
+        mapKey?: string,
+        
         /**
          * 默认值
          */
@@ -130,13 +135,13 @@ type IAPIResultEvent<O extends IAnyData, U extends IAnyData> = {
      * 无论因为什么
      * 总之数据获取到
      */
-    no: { message: string } & U,
+    no: GeneralCallbackResult & U,
 
     /**
      * 完成了
      * 无论失败与否
      */
-    done: { message: string, data: O } & U
+    done: { data?: O } & GeneralCallbackResult & U
 }
 
 /**
@@ -343,14 +348,15 @@ class API<
         for (let key in this.params) {
             
             let data = this.data[key];
-            let { isHeader, isTemplate } = this.params[key];
+            let { isHeader, isTemplate, mapKey } = this.params[key];
+            let useKey = mapKey ?? key;
 
             // 加载数据
             if (!isTemplate) {
                 if (isHeader) {
-                    requestData.header![key] = data;
+                    requestData.header![useKey] = data;
                 } else {
-                    (requestData.data as IAnyData)[key] = data;
+                    (requestData.data as IAnyData)[useKey] = data;
                 }
             }
         }
@@ -593,6 +599,17 @@ class API<
         return this;
     }
 
+    /**
+     * 自动挂载失败回调
+     */
+    public addFailedCallBack(): this {
+        this.on("fail", (e) => {
+            this.emit("no", e as any);
+            this.emit("done", e as any);
+        });
+        return this;
+    }
+
     /**
      * 请求失败后的提示语句
      */
@@ -680,4 +697,4 @@ enum HTTPMethod {
 }
 
 export default API;
-export { API, IParamSetting, IAppAPIParam, ICallBack, HTTPMethod, RequestPolicy }
+export { API, IParamSetting, IAppAPIParam, ICallBack, HTTPMethod, RequestPolicy, GeneralCallbackResult }

miniprogram/pages/Timetable/TestCore.ts

@@ -1,5 +1,5 @@
 import { Modular, Manager, ILifetime } from "../../core/Module";
-import { API, IParamSetting } from "../../core/Api";
+import { Login } from "../../api/Login";
 import { Storage } from "../../core/Storage";
 
 /**
@@ -28,43 +28,12 @@ implements Partial<ILifetime> {
             s.set("be", 12);
         }, 1000)
         
-        interface ITestApiInput {
+        new Login().param({studentId: "1806240113", password: "qazxsw123"})
-            name: string,
+        .request().wait({
-            id: number,
+            ok: (w) => {console.log("ok", w)},
-            info: {
+            no: (w) => {console.log("no", w)},
-                data: string
+            done: (w) => {console.log("done", w)}
-            }
+        });
-        }
-        
-        class TestApi extends API<ITestApiInput, {}> {
-        
-            public override params: IParamSetting<ITestApiInput> = {
-                name: {
-                    tester: "123",
-                    isHeader: true
-                },
-                id: {
-                    parse: (i) => ++i,
-                },
-                info: {}
-            }
-
-            public constructor() {
-                super();
-                this.initDebugLabel("TestApi");
-            }
-        }
-
-        let api = new TestApi();
-        api.param({
-            name: "123",
-            id: 456,
-            info: {
-                data: "abc"
-            }
-        }).request().waitRequest({
-            success: (d) => console.log(d)
-        })
     }
 }