Deployment Guide

This guide walks you through deploying the Yanshan Meeting Big Data System on a Windows 10 machine operated by the meeting secretary (书记员). Because the system ships as a self-contained portable package (便携部署包), deployment requires no Docker, Kubernetes, or serverless infrastructure — you simply extract a ZIP archive and double-click a batch script. Follow this guide to get the web application server running on port 3005 and accessible both locally and over your local area network (局域网).

Before you begin, confirm that the secretary's computer meets the following requirements:

• Operating System: Windows 10 (the portable package is built and tested for Windows 10 only)
• Web Browser: Any modern browser (Chrome, Edge, Firefox) installed on the host machine and on any LAN client devices that need access
• Disk Space: Enough free space to extract the ZIP package (check the release page for the exact archive size)
• Network: The host machine must be connected to the local area network if other devices need LAN access
• Node.js: Not required — node.exe is bundled inside the package and is used automatically

No administrator privileges, no Node.js installation, and no npm or pnpm are needed on the host machine.

Step 1 — Download the portable package

Open the repository in your browser, navigate to the Releases section on the right-hand side, and download the latest release archive:

yanshan-meeting-bigdata-win10-portable-v5.zip

Save the file to a convenient location, such as the secretary's Downloads folder.

Step 2 — Extract the archive

Right-click the downloaded ZIP file and choose Extract All…, or use any ZIP utility. Extract the contents to a stable directory on the secretary's computer. A dedicated folder on a non-system drive is recommended to avoid permission issues:

D:\盐山会议大数据系统

After extraction, the folder should contain 启动系统.bat and the rest of the application files, including the bundled node.exe runtime.

Step 3 — Start the application server

Inside the extracted folder, locate the file named:

启动系统.bat

Double-click it to launch the web application server. A console window will appear while the server initializes. Leave that window open — closing it will stop the server.

Step 4 — Verify local access

Once the server is running, open your browser on the same machine and navigate to:

http://localhost:3005

The meeting big-data management interface should load. If it does not, refer to the Troubleshooting section.

Step 5 — Enable LAN access (optional)

To allow other computers on the same local network to reach the system, find the secretary's computer IP address (for example, 192.168.1.50) and share the following URL with other users:

http://192.168.1.50:3005

Replace 192.168.1.50 with the actual IP address of the host machine. Other devices on the LAN can then open this URL in their browsers to access the application.

The portable package is pre-configured for immediate use. The table below describes the one meaningful runtime parameter and its fixed default.

Why port 3005 is fixed: The application is designed for minimal-setup meeting environments. Hard-coding the port removes the need for the secretary to understand network configuration. Both http://localhost:3005 (local) and http://<host-IP>:3005 (LAN) rely on this value.

Bundled runtime: The node.exe included in the package is used automatically by 启动系统.bat. You do not configure the Node.js path; the batch script resolves it from within the extracted folder.

After completing installation, the primary way you interact with the system is through a web browser pointed at port 3005. The API layer handles data requests between the browser interface and the back-end business logic automatically.

Accessing the interface locally

On the secretary's computer, open any browser and go to:

http://localhost:3005

This is the standard address for the operator running the system on their own machine.

Accessing the interface over the LAN

Other attendees or administrators on the same local network can open the application without installing anything on their own computers. They simply open a browser and navigate to the secretary's machine IP address on port 3005:

http://<secretary-computer-IP>:3005

To find the secretary's IP address, open Command Prompt on the host machine and run:

ipconfig

Look for the IPv4 Address under the active network adapter (for example, 192.168.1.50).

Stopping the server

To shut down the web application server, close the console window that opened when you double-clicked 启动系统.bat. The service will stop and port 3005 will be released.

Restarting after a reboot

The portable package does not register a Windows service or startup entry. After the host machine restarts, the secretary must double-click 启动系统.bat again to bring the server back online.

Example 1 — Confirm the server is responding locally

After double-clicking 启动系统.bat, open a browser on the secretary's computer and enter the following URL:

http://localhost:3005

Expected result: The meeting big-data management interface loads in the browser. The console window launched by 启动系统.bat remains open in the background showing server activity.

Example 2 — Reach the system from another device on the LAN

Assume the secretary's computer IP address is 192.168.0.101. On a second device connected to the same Wi-Fi or wired network, open a browser and navigate to:

http://192.168.0.101:3005

Expected result: The same meeting management interface loads on the second device. No software installation is required on the remote device beyond having a web browser.

Example 3 — Locate the host IP address using ipconfig

On the secretary's Windows 10 computer, open Command Prompt (Win + R, type cmd, press Enter) and run:

ipconfig

Expected output (excerpt):

Ethernet adapter 以太网:

   IPv4 Address. . . . . . . . . . . : 192.168.0.101
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . : 192.168.0.1

Use the IPv4 Address value to construct the LAN URL: http://192.168.0.101:3005.

Example 4 — Make an API data request

Because the system exposes an API layer, you can interact with it programmatically from any HTTP client. The following example uses curl to confirm the server is accepting requests on port 3005:

curl http://localhost:3005

Expected result: The server returns an HTTP response (HTML or JSON depending on the endpoint). A non-empty response confirms the API layer is active and the application is running correctly.

Use the following reference to diagnose and resolve common deployment issues.

Issue: Browser shows "This site can't be reached" at http://localhost:3005

• Likely cause: The server did not start successfully, or 启动系统.bat was closed.
• Fix: Check whether the console window opened by 启动系统.bat is still open. If it is closed, double-click 启动系统.bat again to restart the server. If the window opens and immediately closes, right-click 启动系统.bat and choose Run as administrator, then watch for error messages before the window closes.

Issue: LAN clients cannot reach http://<host-IP>:3005

• Likely cause: Windows Firewall is blocking inbound connections on port 3005, or the IP address used is incorrect.
• Fix 1 — Verify the IP address: Run ipconfig on the secretary's computer and confirm you are using the correct IPv4 address for the active network adapter.
• Fix 2 — Allow the port through Windows Firewall: Open Windows Defender Firewall with Advanced Security, create a new Inbound Rule for Port 3005 using the TCP protocol, and set the action to Allow the connection.

Issue: Port 3005 is already in use — the server fails to start

• Likely cause: Another application on the host machine is already listening on port 3005, or a previous instance of the server is still running.
• Fix: Open Command Prompt and run the following to identify the process using the port:

netstat -ano | findstr :3005

Note the PID in the last column, then open Task Manager, find the process with that PID, and end it. Afterwards, double-click 启动系统.bat again.

Issue: 启动系统.bat shows an error about node.exe not being found

• Likely cause: The ZIP archive was not fully extracted, or the extracted folder structure was modified.
• Fix: Delete the extracted folder, re-extract yanshan-meeting-bigdata-win10-portable-v5.zip in its entirety, and ensure you extract all files — not just selected ones. Do not move 启动系统.bat outside of the extracted folder; it must remain alongside the bundled node.exe and application files.

Issue: The application loads but displays no data or shows API errors

• Likely cause: The API layer encountered an error communicating with back-end storage, or the application was not fully initialized before the browser request was made.
• Fix: Wait a few seconds after 启动系统.bat launches before opening the browser, then refresh the page. If the problem persists, close the console window, double-click 启动系统.bat again, and retry.