Files
Web_BLS_SQL_Temp/temporary_project_management
XuJiacheng a13414ffad feat: 添加MySQL2依赖并实现云端数据库集成
添加mysql2依赖以支持MySQL数据库连接
实现云端数据库配置和连接池管理
新增数据验证脚本用于检查酒店和房间数据
优化数据服务以支持云端数据缓存和同步
更新环境变量和配置以支持新功能
2026-03-13 09:27:55 +08:00
..

Temporary Project Management

This is a local Node.js project for fetching hotel data and loop addresses, managing them in a local SQLite database.

Prerequisites

  • Node.js (v14+ recommended)
  • npm

Installation

  1. Clone or navigate to the project directory.
  2. Install dependencies:
    npm install
    
  3. Copy .env.example to .env and configure:
    cp .env.example .env
    
    (On Windows: copy .env.example .env)

Configuration (.env)

  • PORT: App port (default 3000)
  • DB_FILE: Path to SQLite database file (default ./local.db)
  • ENABLED_HOTEL_IDS: Comma-separated list of Hotel IDs to fetch loops for (e.g., 1085,2144)
  • API_BASE_URL: Base URL for external APIs

Usage

  • Development Mode (with hot reload):
    npm run dev
    
  • Start Production:
    npm start
    
  • Run Tests:
    npm test
    

Project Structure

  • src/config: Configuration loading
  • src/db: Database connection and schema initialization
  • src/services: Business logic for fetching and saving data
  • src/utils: Helpers (Logger, HTTP client with retry/delay)
  • src/scripts: Main entry point

Troubleshooting

  • Database Locks: If you encounter SQLITE_BUSY, ensure no other process (like a DB viewer) has the file open. The app handles some concurrency but file locks can block it.
  • API Timeouts: If the API is slow, the app is configured with a 100s timeout and 2 retries. Check your network connection.
  • Logs: Check logs/ directory for daily application logs and error snapshots.