Socket
Book a DemoInstallSign in
Socket

longtan

Package Overview
Dependencies
Maintainers
7
Versions
221
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

longtan

Server Side Framework via Koa

0.12.7-stage.4
latest
npmnpm
Version published
Weekly downloads
29
-91.08%
Maintainers
7
Weekly downloads
 
Created
Source

Longtan

基於 Koa 的伺服器端框架,提供完整的企業級應用程式開發解決方案。

概述

Longtan 是一個全功能的 Node.js 伺服器端框架,整合了多種企業級功能,包括資料庫支援、訊息佇列、即時通訊整合、機器學習模型支援以及分析工具等。

特色功能

  • 多資料庫支援: MongoDB、MySQL、Redis、InfluxDB
  • 訊息佇列: Bull、Bee Queue、Agenda、AMQP
  • 即時通訊整合: 釘釘、飛書、微信、Slack
  • 機器學習支援: LangChain 整合,支援 OpenAI、Anthropic、AWS
  • 分析工具: 內建分析引擎和資料處理工具
  • 進程管理: 叢集模式支援,優雅關機機制
  • 開發工具: 豐富的命令行工具和除錯支援

安裝

npm install longtan
# 或
yarn add longtan

快速開始

const longtan = require('longtan');

// 啟動應用程式
longtan.launch({
  title: 'MyApp',
  subTitle: ['Version 1.0.0', 'Enterprise Ready']
});

專案結構

longtan/
├── bin/                    # 命令行工具
│   ├── curl.js            # HTTP 請求工具
│   ├── entry.sh           # 應用程式入口腳本
│   ├── exec.sh            # 執行腳本
│   ├── restart.sh         # 重啟腳本
│   ├── stop.sh            # 停止腳本
│   └── yarn.sh            # Yarn 包管理腳本
├── lib/                   # 核心程式庫
│   ├── logic/            # 業務邏輯層
│   │   ├── entity/       # 實體定義
│   │   ├── generic_analytics/ # 通用分析工具
│   │   │   ├── analytics/ # 分析引擎
│   │   │   └── storage/   # 儲存層
│   │   ├── bit_analytics.js # 位元分析邏輯
│   │   ├── bit_batch.js     # 批次處理邏輯
│   │   ├── dingtalk.js      # 釘釘整合
│   │   ├── feishu.js        # 飛書整合
│   │   ├── mongo.js         # MongoDB 邏輯
│   │   ├── multi_agent.js   # 多代理系統
│   │   ├── slack.js         # Slack 整合
│   │   └── wechat.js        # 微信整合
│   ├── manager/          # 管理器層
│   │   ├── job.js        # 任務管理器
│   │   ├── route.js      # 路由管理器
│   │   └── thread.js     # 執行緒管理器
│   ├── model/            # 資料模型層
│   │   ├── agenda.js     # Agenda 佇列模型
│   │   ├── amqp.js       # AMQP 訊息佇列
│   │   ├── dingtalk.js   # 釘釘 API 模型
│   │   ├── feishu.js     # 飛書 API 模型
│   │   ├── influxdb.js   # InfluxDB 時序資料庫
│   │   ├── ioredis.js    # Redis 模型 (ioredis)
│   │   ├── llm.js        # 大語言模型整合
│   │   ├── mongo.js      # MongoDB 模型
│   │   ├── mysql.js      # MySQL 模型
│   │   ├── queue_redis_bee.js  # Bee Queue
│   │   ├── queue_redis_bull.js # Bull Queue
│   │   ├── slack.js      # Slack API 模型
│   │   ├── wechat.js     # 微信 API 模型
│   │   └── wechat_pay.js # 微信支付模型
│   ├── utility/          # 工具程式庫
│   │   ├── encryption_handler.js # 加密處理
│   │   ├── error_message.js      # 錯誤訊息管理
│   │   ├── id_card.js           # 身分證驗證工具
│   │   ├── logger.js            # 日誌工具
│   │   ├── logger_koa_bunyan.js # Koa Bunyan 日誌
│   │   ├── performance.js       # 效能監控
│   │   ├── queue_util.js        # 佇列工具
│   │   ├── shutdown_controller.js # 關機控制器
│   │   └── strategy.js          # 策略模式工具
│   ├── master.js         # 主進程管理
│   ├── thread-util.js    # 執行緒工具
│   ├── util.js           # 通用工具
│   └── worker-util.js    # Worker 工具
├── test/                 # 測試檔案
├── examples/             # 範例程式碼
├── docs/                 # 文件
├── index.js              # 主入口檔案
├── gulpfile.js           # Gulp 建置腳本
├── package.json          # 套件配置
└── tsconfig.json         # TypeScript 配置

核心模組說明

資料庫支援

  • MongoDB: 完整的 MongoDB 整合,支援連接池和事務
  • MySQL: MySQL 資料庫支援,包含連接管理
  • Redis: 雙重 Redis 支援 (ioredis 和 node_redis)
  • InfluxDB: 時序資料庫支援,適合指標和分析資料

訊息佇列

  • Bull Queue: 基於 Redis 的強大佇列系統
  • Bee Queue: 輕量級 Redis 佇列
  • Agenda: MongoDB 基礎的任務排程器
  • AMQP: RabbitMQ 等 AMQP 協議支援

即時通訊整合

  • 釘釘 (DingTalk): 企業即時通訊整合
  • 飛書 (Feishu): 字節跳動企業通訊平台
  • 微信 (WeChat): 微信 API 和微信支付整合
  • Slack: Slack 工作空間整合

AI/ML 支援

  • LangChain: 大語言模型鏈式處理
  • OpenAI: GPT 模型整合
  • Anthropic: Claude 模型支援
  • AWS: Amazon AI 服務整合
  • 多代理系統: 支援複雜的 AI 代理互動

命令行工具

Longtan 提供豐富的命令行工具:

# 重啟應用程式
longtan_restart

# 停止應用程式
longtan_stop

# 執行命令
longtan_exec

# 帶顏色輸出的執行
longtan_colorful_exec

# 外部執行
longtan_outside_exec

# 查看日誌
longtan_print_logs

# HTTP 請求工具
longtan_curl

# Yarn 操作
longtan_yarn

開發指令

# 程式碼格式化
npm run prettier

# 程式碼檢查
npm run lint

# 運行測試
npm run test

# 監控模式測試
npm run test:watch

# 產生測試覆蓋率報告
npm run test:coverage

# 壓縮和編譯
npm run compress

配置說明

應用程式支援環境變數配置,預設環境為 development。支援叢集模式部署,可以透過配置檔案管理多個叢集實例。

叢集配置範例

{
  "cluster": {
    "web": {
      "name": "WebServer",
      "enabled": true,
      "debug_enabled": true,
      "debug_port": 9229
    }
  },
  "general": {
    "graceful_shutdown": 10000
  }
}

進階功能

優雅關機

內建優雅關機機制,確保所有進程和連接正確關閉。

效能監控

整合效能監控工具,可以追蹤應用程式效能指標。

分析引擎

內建通用分析引擎,支援資料處理和統計分析。

加密支援

提供加密處理工具,確保敏感資料安全。

授權條款

MIT License

作者

Paul Lv paul@farsights.cn

版本

目前版本: 0.12.4

更多詳細資訊請參考 /docs 目錄下的文件或查看 /examples 目錄中的範例程式碼。

FAQs

Package last updated on 19 Aug 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.