befly-tpl 3.3.5 → 3.4.0

package/.env.development

@@ -70,14 +70,3 @@ MAIL_ADDRESS='demo@qq.com'
 LOCAL_DIR="/wwwroot/static2/"
 # 微信配置
 PAY_NOTIFY_URL=""
-
-# --- 同步脚本开关（仅影响表结构同步） ---
-# 仅打印计划，不执行（0/1）
-# 合并每表多项 DDL（0/1）
-SYNC_MERGE_ALTER=1
-# 索引操作尽量在线（0/1）
-SYNC_ONLINE_INDEX=0
-# 禁止长度收缩（0/1）
-SYNC_DISALLOW_SHRINK=1
-# 允许类型变更（0/1）
-SYNC_ALLOW_TYPE_CHANGE=0

package/SYSTEMD_DEPLOY.md

@@ -0,0 +1,468 @@
+# Befly Systemd 部署指南
+
+## 快速开始
+
+### 1. 安装 Bun
+
+```bash
+# Linux/macOS
+curl -fsSL https://bun.sh/install | bash
+
+# 验证安装
+bun --version
+```
+
+### 2. 部署项目
+
+```bash
+# 创建项目目录
+sudo mkdir -p /var/www/befly
+sudo chown -R www-data:www-data /var/www/befly
+
+# 上传项目文件到服务器
+# 方式1：使用 git
+cd /var/www/befly
+git clone <your-repo-url> .
+
+# 方式2：使用 rsync
+rsync -avz --exclude 'node_modules' ./ user@server:/var/www/befly/
+
+# 安装依赖
+cd /var/www/befly
+bun install --production
+```
+
+### 3. 配置环境变量
+
+```bash
+# 复制环境变量模板
+cp .env.development .env.production
+
+# 编辑生产环境配置
+nano .env.production
+```
+
+### 4. 配置 systemd 服务
+
+```bash
+# 复制 service 文件
+sudo cp befly.service /etc/systemd/system/
+
+# 编辑配置（修改路径、用户等）
+sudo nano /etc/systemd/system/befly.service
+
+# 需要修改的配置项：
+# - WorkingDirectory: 项目实际路径
+# - User/Group: 运行用户
+# - ExecStart: bun 的实际路径（使用 which bun 查看）
+```
+
+### 5. 启动服务
+
+```bash
+# 重载 systemd 配置
+sudo systemctl daemon-reload
+
+# 启动服务
+sudo systemctl start befly
+
+# 查看状态
+sudo systemctl status befly
+
+# 设置开机自启
+sudo systemctl enable befly
+```
+
+## 常用命令
+
+### 服务管理
+
+```bash
+# 启动服务
+sudo systemctl start befly
+
+# 停止服务
+sudo systemctl stop befly
+
+# 重启服务
+sudo systemctl restart befly
+
+# 重载配置（不重启服务）
+sudo systemctl reload befly
+
+# 查看服务状态
+sudo systemctl status befly
+
+# 查看服务是否开机自启
+sudo systemctl is-enabled befly
+
+# 启用开机自启
+sudo systemctl enable befly
+
+# 禁用开机自启
+sudo systemctl disable befly
+```
+
+### 日志查看
+
+```bash
+# 实时查看日志
+sudo journalctl -u befly -f
+
+# 查看最近100行日志
+sudo journalctl -u befly -n 100
+
+# 查看今天的日志
+sudo journalctl -u befly --since today
+
+# 查看指定时间的日志
+sudo journalctl -u befly --since "2025-01-01 00:00:00" --until "2025-01-01 23:59:59"
+
+# 查看错误日志
+sudo journalctl -u befly -p err
+
+# 查看完整日志（包括被截断的内容）
+sudo journalctl -u befly --no-pager
+
+# 导出日志
+sudo journalctl -u befly > befly.log
+```
+
+### 配置修改后重载
+
+```bash
+# 修改 service 文件后
+sudo systemctl daemon-reload
+sudo systemctl restart befly
+```
+
+## 配置说明
+
+### 集群模式选择
+
+```ini
+# 选项1：单进程模式（适合小型应用）
+ExecStart=/usr/local/bin/bun run befly start
+
+# 选项2：自动集群模式（推荐，使用所有CPU核心）
+ExecStart=/usr/local/bin/bun run befly start --cluster max
+
+# 选项3：指定进程数（如4个进程）
+ExecStart=/usr/local/bin/bun run befly start --cluster 4
+```
+
+### 用户和权限
+
+```bash
+# 创建专用用户（推荐）
+sudo useradd -r -s /bin/false befly
+
+# 设置目录权限
+sudo chown -R befly:befly /var/www/befly
+
+# 修改 service 文件
+User=befly
+Group=befly
+```
+
+### 资源限制调整
+
+```ini
+# 根据服务器配置调整
+MemoryMax=4G              # 4个Worker进程，每个约1G
+MemoryHigh=3G             # 内存高水位警告
+LimitNOFILE=65536         # 高并发场景增加
+CPUQuota=200%             # 限制最多使用2个CPU核心
+```
+
+### 环境变量配置
+
+```ini
+# 在 service 文件中添加
+Environment="NODE_ENV=production"
+Environment="APP_PORT=3000"
+Environment="APP_HOST=0.0.0.0"
+Environment="DATABASE_URL=postgresql://..."
+Environment="REDIS_URL=redis://..."
+
+# 或使用环境文件
+EnvironmentFile=/var/www/befly/.env.production
+```
+
+## 反向代理配置
+
+### Nginx 配置示例
+
+```nginx
+upstream befly_cluster {
+    # 集群模式下配置多个端口
+    server 127.0.0.1:3000;
+    server 127.0.0.1:3001;
+    server 127.0.0.1:3002;
+    server 127.0.0.1:3003;
+
+    # 负载均衡策略
+    least_conn;  # 最少连接
+}
+
+server {
+    listen 80;
+    server_name yourdomain.com;
+
+    # HTTPS 配置（推荐）
+    # listen 443 ssl http2;
+    # ssl_certificate /path/to/cert.pem;
+    # ssl_certificate_key /path/to/key.pem;
+
+    location / {
+        proxy_pass http://befly_cluster;
+        proxy_http_version 1.1;
+
+        # WebSocket 支持
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        # 传递客户端信息
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # 超时设置
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 60s;
+    }
+
+    # 静态文件（如果有）
+    location /static/ {
+        root /var/www/befly/public;
+        expires 30d;
+        add_header Cache-Control "public, immutable";
+    }
+}
+```
+
+### Caddy 配置示例
+
+```caddyfile
+yourdomain.com {
+    reverse_proxy localhost:3000 localhost:3001 localhost:3002 localhost:3003 {
+        lb_policy least_conn
+        health_uri /health
+        health_interval 10s
+    }
+}
+```
+
+## 监控和告警
+
+### 基础监控脚本
+
+```bash
+#!/bin/bash
+# 保存为 /usr/local/bin/befly-monitor.sh
+
+SERVICE="befly"
+EMAIL="admin@example.com"
+
+# 检查服务状态
+if ! systemctl is-active --quiet $SERVICE; then
+    echo "Service $SERVICE is down! Attempting restart..." | mail -s "Alert: Befly Service Down" $EMAIL
+    systemctl restart $SERVICE
+fi
+
+# 检查内存使用
+MEMORY=$(systemctl show $SERVICE -p MemoryCurrent --value)
+MEMORY_MB=$((MEMORY / 1024 / 1024))
+if [ $MEMORY_MB -gt 3500 ]; then
+    echo "Service $SERVICE using ${MEMORY_MB}MB memory (high)" | mail -s "Warning: High Memory Usage" $EMAIL
+fi
+```
+
+### 定时监控（crontab）
+
+```bash
+# 编辑 crontab
+sudo crontab -e
+
+# 每5分钟检查一次
+*/5 * * * * /usr/local/bin/befly-monitor.sh
+```
+
+## 故障排查
+
+### 服务启动失败
+
+```bash
+# 查看详细错误信息
+sudo systemctl status befly -l
+
+# 查看完整日志
+sudo journalctl -u befly -n 100 --no-pager
+
+# 检查配置文件语法
+sudo systemd-analyze verify /etc/systemd/system/befly.service
+
+# 测试启动命令
+cd /var/www/befly
+sudo -u www-data bun run befly start --cluster max
+```
+
+### 权限问题
+
+```bash
+# 检查文件权限
+ls -la /var/www/befly
+
+# 修复权限
+sudo chown -R www-data:www-data /var/www/befly
+sudo chmod -R 755 /var/www/befly
+
+# 检查日志目录权限
+sudo mkdir -p /var/www/befly/logs
+sudo chown -R www-data:www-data /var/www/befly/logs
+```
+
+### 端口占用
+
+```bash
+# 检查端口是否被占用
+sudo netstat -tulpn | grep :3000
+
+# 或使用 ss
+sudo ss -tulpn | grep :3000
+
+# 杀死占用端口的进程
+sudo kill -9 <PID>
+```
+
+## 升级和维护
+
+### 应用升级
+
+```bash
+# 拉取最新代码
+cd /var/www/befly
+git pull
+
+# 安装新依赖
+bun install --production
+
+# 重启服务
+sudo systemctl restart befly
+
+# 查看状态
+sudo systemctl status befly
+```
+
+### 日志清理
+
+```bash
+# 查看日志占用空间
+sudo journalctl --disk-usage
+
+# 清理旧日志（保留最近7天）
+sudo journalctl --vacuum-time=7d
+
+# 清理日志（保留最近1GB）
+sudo journalctl --vacuum-size=1G
+
+# 配置自动清理（编辑配置文件）
+sudo nano /etc/systemd/journald.conf
+
+# 添加配置
+SystemMaxUse=1G
+MaxRetentionSec=7day
+```
+
+## 安全建议
+
+### 防火墙配置
+
+```bash
+# 使用 ufw
+sudo ufw allow 80/tcp
+sudo ufw allow 443/tcp
+sudo ufw enable
+
+# 或使用 firewalld
+sudo firewall-cmd --permanent --add-service=http
+sudo firewall-cmd --permanent --add-service=https
+sudo firewall-cmd --reload
+```
+
+### 最小权限原则
+
+```bash
+# 禁止 befly 用户登录
+sudo usermod -s /bin/false befly
+
+# 限制目录访问
+sudo chmod 750 /var/www/befly
+```
+
+### 定期更新
+
+```bash
+# 更新系统
+sudo apt update && sudo apt upgrade -y  # Debian/Ubuntu
+# 或
+sudo yum update -y  # CentOS/RHEL
+
+# 更新 Bun
+bun upgrade
+```
+
+## 备份策略
+
+```bash
+#!/bin/bash
+# 保存为 /usr/local/bin/befly-backup.sh
+
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/var/backups/befly"
+PROJECT_DIR="/var/www/befly"
+
+# 创建备份目录
+mkdir -p $BACKUP_DIR
+
+# 备份配置和代码
+tar -czf $BACKUP_DIR/befly_$DATE.tar.gz \
+    $PROJECT_DIR/.env.production \
+    $PROJECT_DIR/package.json \
+    $PROJECT_DIR/bun.lockb \
+    /etc/systemd/system/befly.service
+
+# 保留最近30天的备份
+find $BACKUP_DIR -name "befly_*.tar.gz" -mtime +30 -delete
+```
+
+## 性能优化
+
+### Bun 优化
+
+```bash
+# 使用生产模式
+NODE_ENV=production
+
+# 禁用调试日志
+DEBUG=0
+```
+
+### 系统优化
+
+```bash
+# 增加文件描述符限制
+echo "* soft nofile 65536" | sudo tee -a /etc/security/limits.conf
+echo "* hard nofile 65536" | sudo tee -a /etc/security/limits.conf
+
+# 优化内核参数
+sudo sysctl -w net.core.somaxconn=65535
+sudo sysctl -w net.ipv4.tcp_max_syn_backlog=8192
+```
+
+## 联系和支持
+
+- 文档：https://github.com/chenbimo/befly
+- 问题反馈：GitHub Issues

package/apis/user/login.ts

@@ -2,9 +2,7 @@
  * 用户登录接口 - TypeScript 示例
  */
 
-import { Yes, No } from 'befly';
-import { Cipher } from 'befly';
-import { Jwt } from 'befly';
+import { Yes, No, Cipher, Jwt } from 'befly';
 
 export default {
     name: '用户登录',

package/befly.service

@@ -0,0 +1,93 @@
+# Befly Systemd Service 配置文件
+#
+# 使用方法：
+# 1. 复制此文件到 /etc/systemd/system/befly.service
+#    sudo cp befly.service /etc/systemd/system/
+#
+# 2. 修改配置中的路径和用户信息
+#    sudo nano /etc/systemd/system/befly.service
+#
+# 3. 重载 systemd 配置
+#    sudo systemctl daemon-reload
+#
+# 4. 启动服务
+#    sudo systemctl start befly
+#
+# 5. 开机自启
+#    sudo systemctl enable befly
+#
+# 6. 查看状态
+#    sudo systemctl status befly
+#
+# 7. 查看日志
+#    sudo journalctl -u befly -f
+#
+# 8. 重启服务
+#    sudo systemctl restart befly
+#
+# 9. 停止服务
+#    sudo systemctl stop befly
+
+[Unit]
+Description=Befly Application Server
+Documentation=https://github.com/chenbimo/befly
+After=network.target
+
+[Service]
+Type=simple
+
+# 运行用户和组（根据实际情况修改）
+User=www-data
+Group=www-data
+
+# 工作目录（修改为实际项目路径）
+WorkingDirectory=/var/www/befly
+
+# 环境变量配置
+Environment="NODE_ENV=production"
+Environment="APP_PORT=3000"
+Environment="APP_HOST=0.0.0.0"
+
+# 启动命令
+# 单进程模式：
+# ExecStart=/usr/local/bin/bun run befly start
+#
+# 集群模式（推荐，自动使用所有CPU核心）：
+ExecStart=/usr/local/bin/bun run befly start --cluster max
+#
+# 集群模式（指定进程数）：
+# ExecStart=/usr/local/bin/bun run befly start --cluster 4
+
+# 重启策略
+Restart=always                    # 总是自动重启（崩溃、OOM、异常退出等）
+RestartSec=10                     # 重启前等待10秒
+StartLimitInterval=300            # 5分钟内
+StartLimitBurst=5                 # 最多重启5次（防止无限重启）
+
+# 资源限制
+MemoryMax=4G                      # 最大内存限制
+MemoryHigh=3G                     # 内存高水位警告
+LimitNOFILE=65536                 # 最大打开文件数
+LimitNPROC=4096                   # 最大进程数
+
+# CPU 限制（可选）
+# CPUQuota=200%                   # 最多使用2个CPU核心（200%）
+
+# 安全加固（可选，根据需要启用）
+# PrivateTmp=true                 # 使用私有 /tmp 目录
+# NoNewPrivileges=true            # 禁止提升权限
+# ProtectSystem=strict            # 保护系统目录只读
+# ProtectHome=true                # 保护家目录
+
+# 日志配置
+StandardOutput=journal            # 标准输出到 systemd journal
+StandardError=journal             # 错误输出到 systemd journal
+SyslogIdentifier=befly            # 日志标识符
+
+# 优雅关闭
+# KillMode=mixed                  # 混合模式：先 SIGTERM，超时后 SIGKILL
+# KillSignal=SIGTERM              # 发送 SIGTERM 信号
+# TimeoutStopSec=30               # 30秒后强制停止
+
+[Install]
+WantedBy=multi-user.target        # 多用户模式下启动

package/package.json

@@ -1,19 +1,13 @@
 {
     "name": "befly-tpl",
-    "version": "3.3.5",
-    "main": "main.ts",
-    "types": "main.ts",
+    "version": "3.4.0",
     "description": "Befly 3.0 TypeScript Template",
     "private": false,
     "publishConfig": {
         "access": "public",
         "registry": "https://registry.npmjs.org"
     },
-    "scripts": {
-        "dev": "bun --env-file=.env.development run main.ts",
-        "serve": "bunx --bun pm2 start pm2.config.cjs -a",
-        "test": "bun test"
-    },
+    "scripts": {},
     "files": [
         "apis",
         "checks",
@@ -24,20 +18,21 @@
         "tests",
         ".env.development",
         ".npmrc",
+        "befly.service",
         "LICENSE",
-        "main.ts",
         "package.json",
         "pm2.config.cjs",
         "README.md",
+        "SYSTEMD_DEPLOY.md",
         "tsconfig.json"
     ],
     "type": "module",
     "dependencies": {
         "@befly-addon/admin": "1.0.2",
-        "befly": "^3.3.5"
+        "befly": "^3.4.0"
     },
     "engines": {
         "bun": ">=1.3.0"
     },
-    "gitHead": "c2f3a7f31ca73cf114fc206a799b78c68ec73c2b"
+    "gitHead": "2fbc9a9d7f4e6a30945c0bb274f3c5982949a8f6"
 }

package/main.ts

@@ -1,9 +0,0 @@
-/**
- * Befly 项目入口文件
- */
-
-import { Befly } from 'befly';
-
-const app = new Befly();
-
-await app.listen();

package/pm2.config.cjs

@@ -1,85 +0,0 @@
-module.exports = {
-    apps: [
-        {
-            name: 'tpl',
-            instances: 4,
-            script: './main.js',
-            exec_mode: 'cluster',
-            watch: false,
-            autorestart: true,
-            interpreter: 'bun',
-            ignore_watch: ['node_modules', 'logs', 'data'],
-            max_memory_restart: '200M',
-            env: {
-                NODE_ENV: 'production',
-                // 项目名称
-                APP_NAME: '易接口',
-                APP_PORT: 3000,
-                // 监听端口,
-                APP_HOST: '127.0.0.1',
-                // 开发管理员邮箱
-                DEV_EMAIL: 'dev@qq.com',
-                // 开发管理员密码,
-                DEV_PASSWORD: '123456',
-                // 请求体大小,
-                BODY_LIMIT: 10,
-                // 参数检查,
-                PARAMS_CHECK: 0,
-                // 日志等级,
-                LOG_EXCLUDE_FIELDS: 'password,token',
-                LOG_LEVEL: 'info',
-                LOG_DIR: './logs',
-                LOG_TO_CONSOLE: 1,
-                LOG_MAX_SIZE: 52428800, // 50MB,
-                // 时区,
-                TZ: 'Asia/Shanghai',
-                // 跨域配置
-                ALLOWED_METHODS: 'GET, POST, PUT, DELETE, OPTIONS',
-                ALLOWED_HEADERS: 'Content-Type, Authorization, authorization, token',
-                EXPOSE_HEADERS: 'Content-Range, X-Content-Range, Authorization, authorization, token',
-                MAX_AGE: 86400,
-                ALLOW_CREDENTIALS: 'true',
-                // 数据库配置（DB_* 通用参数）,
-                DB_ENABLE: 1,
-                DB_TYPE: 'mysql',
-                DB_HOST: '127.0.0.1',
-                DB_PORT: 3306,
-                DB_USER: 'root',
-                DB_PASS: 'root',
-                DB_NAME: 'test',
-                DB_POOL_MAX: 10,
-                DB_DEBUG: 0,
-                // redis 配置,
-                REDIS_ENABLE: 1,
-                REDIS_URL: 'redis://root:root@127.0.0.1:6379',
-                REDIS_HOST: '127.0.0.1',
-                REDIS_PORT: 6379,
-                REDIS_USERNAME: '',
-                REDIS_PASSWORD: '',
-                REDIS_DB: 3,
-                REDIS_KEY_PREFIX: '',
-                // JWT 配置,
-                JWT_SECRET: 'dbfaf2c3-7ade-5042-b843-eca8814714b3',
-                JWT_EXPIRES_IN: '30d',
-                JWT_ALGORITHM: 'HS256',
-                // 邮箱配置,
-                MAIL_HOST: 'smtp.qq.com',
-                MAIL_PORT: 465,
-                MAIL_POOL: 1,
-                MAIL_SECURE: 1,
-                MAIL_USER: '',
-                MAIL_PASS: '',
-                MAIL_SENDER: '',
-                MAIL_ADDRESS: 'demo@qq.com',
-                // 上传配置,
-                LOCAL_DIR: '/wwwroot/static2/',
-                // 微信配置,
-                PAY_NOTIFY_URL: '',
-                // --- 同步脚本开关（用于表结构同步） ---
-                SYNC_MERGE_ALTER: 1,
-                SYNC_DISALLOW_SHRINK: 1,
-                SYNC_ALLOW_TYPE_CHANGE: 0
-            }
-        }
-    ]
-};

package/types/api.ts

@@ -1,128 +0,0 @@
-/**
- * API 请求/响应类型定义示例
- * 注意：实际项目中可能不需要这些类型定义
- */
-
-/**
- * 用户登录请求
- */
-export interface LoginRequest {
-    username: string;
-    password: string;
-}
-
-/**
- * 用户登录响应
- */
-export interface LoginResponse {
-    token: string;
-    user: Omit<User, 'password'>;
-}
-
-/**
- * 用户注册请求
- */
-export interface RegisterRequest {
-    username: string;
-    email: string;
-    password: string;
-}
-
-/**
- * 获取用户列表请求
- */
-export interface GetUsersRequest extends PaginationParams {
-    role?: string;
-    keyword?: string;
-}
-
-/**
- * 获取用户列表响应
- */
-export type GetUsersResponse = ListResponse<Omit<User, 'password'>>;
-
-/**
- * 创建文章请求
- */
-export interface CreateArticleRequest {
-    title: string;
-    content: string;
-    categoryId: number;
-    tags: string[];
-    summary?: string;
-    coverImage?: string;
-}
-
-/**
- * 获取文章列表请求
- */
-export interface GetArticlesRequest extends PaginationParams {
-    categoryId?: number;
-    authorId?: number;
-    keyword?: string;
-    published?: boolean;
-}
-
-/**
- * 获取文章列表响应
- */
-export type GetArticlesResponse = ListResponse<Article>;
-
-/**
- * 创建产品请求
- */
-export interface CreateProductRequest {
-    name: string;
-    price: number;
-    stock: number;
-    categoryId: number;
-    description: string;
-    images?: string[];
-    tags?: string[];
-}
-
-/**
- * 获取产品列表请求
- */
-export interface GetProductsRequest extends PaginationParams {
-    categoryId?: number;
-    minPrice?: number;
-    maxPrice?: number;
-    keyword?: string;
-}
-
-/**
- * 获取产品列表响应
- */
-export type GetProductsResponse = ListResponse<Product>;
-
-/**
- * 创建订单请求
- */
-export interface CreateOrderRequest {
-    productId: number;
-    quantity: number;
-    address?: string;
-}
-
-/**
- * 创建订单响应
- */
-export interface CreateOrderResponse {
-    orderId: number;
-    orderNo: string;
-    totalPrice: number;
-}
-
-/**
- * 获取订单列表请求
- */
-export interface GetOrdersRequest extends PaginationParams {
-    userId?: number;
-    status?: string;
-}
-
-/**
- * 获取订单列表响应
- */
-export type GetOrdersResponse = ListResponse<Order>;

package/types/index.ts

@@ -1,6 +0,0 @@
-/**
- * 导出所有类型定义
- */
-
-export * from './models';
-export * from './api';

package/types/models.example.ts

@@ -1,267 +0,0 @@
-/**
- * 数据模型类型定义
- *
- * 这个文件定义了常用的数据模型类型
- */
-
-/**
- * 基础实体接口（所有表共有的字段）
- */
-export interface BaseEntity {
-    /** 主键 ID */
-    id: number;
-    /** 创建时间（时间戳） */
-    createdAt: number;
-    /** 更新时间（时间戳） */
-    updatedAt: number;
-    /** 删除时间（时间戳，null 表示未删除） */
-    deletedAt: number | null;
-    /** 状态（0=正常，1=禁用） */
-    state: number;
-}
-
-/**
- * 用户角色类型
- */
-export type UserRole = 'admin' | 'user' | 'guest' | 'editor' | 'viewer';
-
-/**
- * 用户模型
- */
-export interface User extends BaseEntity {
-    /** 用户名 */
-    username: string;
-    /** 邮箱 */
-    email: string;
-    /** 密码（哈希后） */
-    password: string;
-    /** 角色 */
-    role: UserRole;
-    /** 手机号 */
-    phone?: string;
-    /** 头像 URL */
-    avatar?: string;
-    /** 昵称 */
-    nickname?: string;
-    /** 个人简介 */
-    bio?: string;
-}
-
-/**
- * 产品分类
- */
-export interface Category extends BaseEntity {
-    /** 分类名称 */
-    name: string;
-    /** 父分类 ID */
-    parentId: number | null;
-    /** 排序 */
-    sort: number;
-    /** 描述 */
-    description?: string;
-}
-
-/**
- * 产品模型
- */
-export interface Product extends BaseEntity {
-    /** 产品名称 */
-    name: string;
-    /** 价格（单位：分） */
-    price: number;
-    /** 库存 */
-    stock: number;
-    /** 分类 ID */
-    categoryId: number;
-    /** 标签 */
-    tags: string[];
-    /** 描述 */
-    description: string;
-    /** 图片 URL 列表 */
-    images?: string[];
-    /** SKU */
-    sku?: string;
-    /** 原价 */
-    originalPrice?: number;
-}
-
-/**
- * 订单状态
- */
-export type OrderStatus = 'pending' | 'paid' | 'shipped' | 'completed' | 'cancelled' | 'refunded';
-
-/**
- * 订单模型
- */
-export interface Order extends BaseEntity {
-    /** 订单号 */
-    orderNo: string;
-    /** 用户 ID */
-    userId: number;
-    /** 产品 ID */
-    productId: number;
-    /** 数量 */
-    quantity: number;
-    /** 总价 */
-    totalPrice: number;
-    /** 状态 */
-    status: OrderStatus;
-    /** 收货地址 */
-    address?: string;
-    /** 收货人 */
-    recipient?: string;
-    /** 联系电话 */
-    phone?: string;
-    /** 备注 */
-    remark?: string;
-}
-
-/**
- * 文章模型
- */
-export interface Article extends BaseEntity {
-    /** 标题 */
-    title: string;
-    /** 内容 */
-    content: string;
-    /** 作者 ID */
-    authorId: number;
-    /** 分类 ID */
-    categoryId: number;
-    /** 标签 */
-    tags: string[];
-    /** 摘要 */
-    summary?: string;
-    /** 封面图 */
-    coverImage?: string;
-    /** 浏览次数 */
-    viewCount: number;
-    /** 点赞次数 */
-    likeCount: number;
-    /** 是否发布 */
-    published: boolean;
-}
-
-/**
- * 评论模型
- */
-export interface Comment extends BaseEntity {
-    /** 评论内容 */
-    content: string;
-    /** 用户 ID */
-    userId: number;
-    /** 关联 ID（文章、产品等） */
-    targetId: number;
-    /** 关联类型 */
-    targetType: 'article' | 'product' | 'order';
-    /** 父评论 ID */
-    parentId: number | null;
-    /** 点赞次数 */
-    likeCount: number;
-}
-
-/**
- * 文件模型
- */
-export interface File extends BaseEntity {
-    /** 文件名 */
-    filename: string;
-    /** 原始文件名 */
-    originalName: string;
-    /** 文件路径 */
-    path: string;
-    /** 文件大小（字节） */
-    size: number;
-    /** MIME 类型 */
-    mimeType: string;
-    /** 文件哈希 */
-    hash: string;
-    /** 上传者 ID */
-    uploaderId: number;
-    /** 文件类型 */
-    type: 'image' | 'video' | 'audio' | 'document' | 'other';
-}
-
-/**
- * 配置模型
- */
-export interface Config extends BaseEntity {
-    /** 配置键 */
-    key: string;
-    /** 配置值 */
-    value: string;
-    /** 配置类型 */
-    type: 'string' | 'number' | 'boolean' | 'json';
-    /** 描述 */
-    description?: string;
-    /** 分组 */
-    group?: string;
-}
-
-/**
- * 日志模型
- */
-export interface Log extends BaseEntity {
-    /** 日志级别 */
-    level: 'info' | 'warn' | 'error' | 'debug';
-    /** 日志消息 */
-    message: string;
-    /** 用户 ID */
-    userId?: number;
-    /** IP 地址 */
-    ip?: string;
-    /** 用户代理 */
-    userAgent?: string;
-    /** 额外数据 */
-    metadata?: Record<string, any>;
-}
-
-/**
- * 通知模型
- */
-export interface Notification extends BaseEntity {
-    /** 标题 */
-    title: string;
-    /** 内容 */
-    content: string;
-    /** 接收者 ID */
-    receiverId: number;
-    /** 类型 */
-    type: 'system' | 'order' | 'comment' | 'like' | 'follow';
-    /** 是否已读 */
-    read: boolean;
-    /** 关联 ID */
-    targetId?: number;
-    /** 关联类型 */
-    targetType?: string;
-}
-
-/**
- * 权限模型
- */
-export interface Permission extends BaseEntity {
-    /** 权限名称 */
-    name: string;
-    /** 权限标识 */
-    code: string;
-    /** 描述 */
-    description?: string;
-    /** 资源类型 */
-    resource: string;
-    /** 操作类型 */
-    action: 'create' | 'read' | 'update' | 'delete' | 'execute';
-}
-
-/**
- * 角色模型
- */
-export interface Role extends BaseEntity {
-    /** 角色名称 */
-    name: string;
-    /** 角色标识 */
-    code: string;
-    /** 描述 */
-    description?: string;
-    /** 权限 ID 列表 */
-    permissions: number[];
-}

package/types/models.ts

@@ -1,67 +0,0 @@
-/**
- * 数据模型类型定义示例
- * 注意：实际项目中可能不需要这些类型定义
- */
-
-/**
- * 用户模型
- */
-export interface User extends BaseEntity {
-    username: string;
-    email: string;
-    password: string;
-    role: UserRole;
-    avatar?: string;
-    nickname?: string;
-}
-
-/**
- * 用户角色
- */
-export type UserRole = 'admin' | 'user' | 'guest';
-
-/**
- * 文章模型
- */
-export interface Article extends BaseEntity {
-    title: string;
-    content: string;
-    authorId: number;
-    categoryId: number;
-    tags: string[];
-    summary?: string;
-    coverImage?: string;
-    viewCount: number;
-    published: boolean;
-}
-
-/**
- * 产品模型
- */
-export interface Product extends BaseEntity {
-    name: string;
-    price: number;
-    stock: number;
-    categoryId: number;
-    description: string;
-    images: string[];
-    tags: string[];
-}
-
-/**
- * 订单模型
- */
-export interface Order extends BaseEntity {
-    orderNo: string;
-    userId: number;
-    productId: number;
-    quantity: number;
-    totalPrice: number;
-    status: OrderStatus;
-    address?: string;
-}
-
-/**
- * 订单状态
- */
-export type OrderStatus = 'pending' | 'paid' | 'shipped' | 'completed' | 'cancelled';