@k3000/s1 0.3.5 → 0.3.7

package/README.md

@@ -1,21 +1,67 @@
 以UDP微服务的形式构建的平台
 
-1、全局安装 npm i -g @k3000/s1
+#### 1、安装
+首选全局安装脚本，注意是否有占用全局命令：```bot```
 
-2、项目预览需要启动的服务：
+```
+> npm i -g @k3000/s1
+> mkdir mydir
+> cd mydir
+> bot init
+> bot init 1 # 覆盖已有文件
+```
+#### 2、目录说明
 
-npm run admin #管理后台服务
+_admin、app、file_ 为实例项目，自行根据需求增减。
 
-npm run jwt #用户身份校验
+_bin_ 为构建目录，不要占用。
 
-npm run store1 #存储服务
+_common_ 存放公共模块详见内部 _README.md_，请别随意删除。
 
-npm run proxy #转发服务
+_store1_ 为存储服务详见内部 _README.md_，。
 
-3、发布 npm run build，打包后存入bin文件夹
+_jwt_ 为用户身份校验服务。
 
-4、部署 node pm2.mjs
+_proxy_ 为http转发服务。
+
+_static_ 为静态资源目录。
+
+_ui-dev_ 为管理系统前端项目，构建后放进 _static_ 目录。
+
+_“谨慎打开”_ 为要饭文件夹。
+
+#### 3、项目预览
+需要启动的服务：
+
+```
+npm run admin # 管理后台服务
+npm run jwt # 用户身份校验（必要）
+npm run store1 # 存储服务（必要）
+npm run proxy # http转发服务（必要）
+```
+#### 4、后台管理系统web页面开发
+
+进入`ui-dev`文件夹
+
+```
+> bot update # 初始化目录
+> npm run dev # 执行
+```
+
+#### 4、发布
+
+编辑`build.mjs`文件
+
+执行`npm run build`
+
+打包后存入`bin`文件夹
+
+#### 5、部署
+
+把`bin`文件夹里面的文件拷贝到服务器的指定文件夹
+
+然后执行`node pm2.mjs`
 
 测试账号：admin
 
-测试密码：admin123
+测试密码：admin123

package/admin/README.MD

@@ -0,0 +1,47 @@
+主要用到的类`Admin`、`AdminAuth`和`AdminAuthPerm`。
+
+`Admin`普通的管理系统类。
+
+`AdminAuth`这个类需要登录授权后才能访问。
+
+`AdminAuthPerm`这个类在登录的基础上需要有特定的权限关键字才能访问。
+
+```
+export class User extends AdminAuthPerm {
+
+    pk = 'userId'
+    set = 'sysUser'
+    route = '/system/user'
+    except = ['deptTree', 'authRole', 'changeStatus']
+
+    GET(...arg) {
+        // 调用默认的GET方法
+        const result = this.call(...arg)
+        // 这个是处理没有get方法的情况，如请求为/system/user或者/system/user/
+        if (result === NoActionParams) return store1.getPostUserList().then(this.addCode200)
+        // 这个是处理请求为/system/user/:action但是没有实现action()的情况
+        if (NoActionHandle.is(result)) return store1.getUserInfoById(Number.parseInt(result))
+            .then(this.addCode200)
+
+        return result
+    }
+
+    POST(body, ...arg) {
+        // 调用默认的POST方法
+        const action = this.call(body, ...arg)
+        // 满足该条件表示已有相应方法处理，后续不需要再处理
+        if (action !== NoActionParams && !NoActionHandle.is(action)) return action
+
+        ......
+    }
+
+    list(query, {req, res}) {
+
+        ......
+
+        return this.page(query, undefined)
+    }
+    // 非默认方法（GET、POST、PUT、……）可以这样赋值
+    resetPwd = store1.resetUserPwd
+}
+```

package/admin/service.mjs

@@ -2,7 +2,7 @@ import createServer from '@k3000/server'
 import {adminUdpPort as port} from "../common/config.mjs";
 import {service as pools} from '../common/service.mjs'
 
-/*const service = */createServer({port, type: "udp"}, pools)
+createServer({port, type: "udp"}, pools)
 
 console.log('running on ' + port)
 

package/admin/system/user.mjs

@@ -24,7 +24,7 @@ export class User extends AdminAuthPerm {
 
         const action = this.call(body, ...arg)
 
-        if (action !== NoActionParams || NoActionHandle.is(action)) return action
+        if (action !== NoActionParams && !NoActionHandle.is(action)) return action
 
         body.createBy = body.userInfo.userName
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k3000/s1",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "",
   "scripts": {
     "sync": "npm link",

package/index.mjs

@@ -1,28 +0,0 @@
-
-import { Worker, isMainThread } from 'node:worker_threads';
-
-const files = [
-    './proxy/index.mjs',
-    './admin/index.mjs',
-    // './app/index.mjs',
-    './jwt/index.mjs',
-    './store1/index.mjs',
-]
-
-const workers = new Set;
-
-for (const file of files) {
-
-    const path = import.meta.resolve(file).substring(process.platform === "win32" ? 8 : 7)
-
-    workers.add(new Worker(decodeURI(path)))
-}
-
-process.on('beforeExit', () => {
-
-    for (const worker of workers.values()) {
-
-        worker.dispose();
-    }
-})
-