chanjs 2.7.7 → 2.7.10

package/doc/Service.md

@@ -1,240 +0,0 @@
-# Service 服务基类
-
-## 概述
-
-`Service` 是纯业务逻辑层基类，继承自 `Container` 容器类。**不包含任何数据库 CRUD 方法**，仅作为业务逻辑的载体。
-
-业务子类可注入多个 `Repository` 实例，进行跨表事务编排。
-
-## 继承关系
-
-```
-Container <── Service
-```
-
-## 构造函数
-
-```javascript
-constructor()
-```
-
-调用父类 `Container` 构造函数，指定组件类型为 `'service'`。
-
-## 设计原则
-
-1. **无表绑定**：Service 不直接操作数据库表
-2. **无 CRUD 方法**：所有数据操作委托给 Repository
-3. **业务编排**：负责组合多个 Repository 完成复杂业务逻辑
-4. **事务管理**：可跨 Repository 进行事务编排
-
-## 使用示例
-
-### 基础示例
-
-```javascript
-import { Service } from 'chanjs';
-import UserRepo from '../repository/UserRepo.js';
-import OrderRepo from '../repository/OrderRepo.js';
-
-export default class UserService extends Service {
-  constructor() {
-    super();
-    this.userRepo = new UserRepo();
-    this.orderRepo = new OrderRepo();
-  }
-
-  // 查询用户及其订单
-  async getUserWithOrders(userId) {
-    const user = await this.userRepo.findById(userId);
-    if (!user.success) {
-      return user;
-    }
-    
-    const orders = await this.orderRepo.all({
-      query: { userId }
-    });
-    
-    return this.success({
-      data: {
-        user: user.data,
-        orders: orders.data
-      }
-    });
-  }
-}
-```
-
-### 跨表事务示例
-
-```javascript
-import { Service } from 'chanjs';
-import UserRepo from '../repository/UserRepo.js';
-import WalletRepo from '../repository/WalletRepo.js';
-
-export default class PaymentService extends Service {
-  constructor() {
-    super();
-    this.userRepo = new UserRepo();
-    this.walletRepo = new WalletRepo();
-  }
-
-  // 用户充值（跨表事务）
-  async recharge(userId, amount) {
-    const trx = await this.db.transaction();
-    
-    try {
-      // 更新用户余额
-      await this.userRepo.updateById(userId, {
-        balance: this.db.raw(`balance + ${amount}`)
-      }, trx);
-      
-      // 记录充值流水
-      await this.walletRepo.insert({
-        userId,
-        amount,
-        type: 'recharge',
-        createdAt: new Date()
-      }, trx);
-      
-      await trx.commit();
-      return this.success({ msg: '充值成功' });
-    } catch (err) {
-      await trx.rollback();
-      return this.fail({ 
-        msg: '充值失败', 
-        code: 500 
-      });
-    }
-  }
-}
-```
-
-### 复杂业务逻辑示例
-
-```javascript
-import { Service } from 'chanjs';
-import UserRepo from '../repository/UserRepo.js';
-import OrderRepo from '../repository/OrderRepo.js';
-import ProductRepo from '../repository/ProductRepo.js';
-
-export default class OrderService extends Service {
-  constructor() {
-    super();
-    this.userRepo = new UserRepo();
-    this.orderRepo = new OrderRepo();
-    this.productRepo = new ProductRepo();
-  }
-
-  // 创建订单
-  async createOrder(userId, products) {
-    // 1. 校验用户
-    const user = await this.userRepo.findById(userId);
-    if (!user.success) {
-      return this.fail({ msg: '用户不存在' });
-    }
-    
-    // 2. 校验商品库存
-    for (const item of products) {
-      const product = await this.productRepo.findById(item.productId);
-      if (!product.success || product.data.stock < item.quantity) {
-        return this.fail({ 
-          msg: `商品 ${product.data.name} 库存不足` 
-        });
-      }
-    }
-    
-    // 3. 计算订单金额
-    const totalAmount = await this.calculateTotal(products);
-    
-    // 4. 创建订单
-    const order = await this.orderRepo.insert({
-      userId,
-      totalAmount,
-      status: 'pending',
-      createdAt: new Date()
-    });
-    
-    // 5. 扣减库存
-    await this.deductStock(products);
-    
-    return this.success({
-      data: { orderId: order.data.insertId },
-      msg: '订单创建成功'
-    });
-  }
-
-  // 计算订单总额
-  async calculateTotal(products) {
-    let total = 0;
-    for (const item of products) {
-      const product = await this.productRepo.findById(item.productId);
-      total += product.data.price * item.quantity;
-    }
-    return total;
-  }
-
-  // 扣减库存
-  async deductStock(products) {
-    for (const item of products) {
-      await this.productRepo.updateById(item.productId, {
-        stock: this.db.raw(`stock - ${item.quantity}`)
-      });
-    }
-  }
-}
-```
-
-## 访问全局资源
-
-Service 继承自 Container，可访问以下全局资源：
-
-| 属性 | 说明 |
-|------|------|
-| `this.app` | 全局应用实例 |
-| `this.config` | 全局配置对象 |
-| `this.db` | 默认数据库连接 |
-| `this.paths` | 路径工具对象 |
-
-### 示例
-
-```javascript
-export default class ConfigService extends Service {
-  async getAppName() {
-    // 访问全局配置
-    const appName = this.config.APP_NAME;
-    return this.success({ data: appName });
-  }
-
-  async getDbVersion() {
-    // 访问数据库连接
-    const [result] = await this.db.raw('SELECT VERSION() as version');
-    return this.success({ data: result[0].version });
-  }
-}
-```
-
-## 动态加载组件
-
-Service 可使用 `get` 方法动态加载其他 Service 或 Repository：
-
-```javascript
-export default class OrderService extends Service {
-  async processOrder(orderId) {
-    // 动态加载 UserService
-    const userService = await this.get('user', 'UserService');
-    
-    // 调用 UserService 方法
-    const user = await userService.getUserById(1);
-    
-    // 业务逻辑...
-  }
-}
-```
-
-## 注意事项
-
-1. Service 不包含 CRUD 方法，数据操作请使用 Repository
-2. 建议在 Service 中注入所需的 Repository 实例
-3. 跨表事务需在 Service 层统一管理
-4. Service 文件应放在 `app/modules/{moduleName}/service/` 目录下
-5. 导出时使用 `export default` 导出实例或类

package/publish.bat

@@ -1,4 +0,0 @@
-npm config set proxy null
-npm cache clean --force
-npm config set registry=https://registry.npmjs.org
-npm publish

package/todo.md

@@ -1 +0,0 @@
-Express + HMVC + DI + AOP + Knex (多库) + Redis + 微服务