Concept

Problem Being Solved

What this service provides


Overview

This page explains the core problem that the Yanshan Meeting Big Data System solves and what the service provides to you as a developer or operator. Understanding this context helps you make sense of the system's architecture, its deployment model, and how its API layer fits into a minimal-footprint meeting environment.


Content

The Deployment Problem

Deploying a web-based meeting management system in a real-world meeting environment presents a practical challenge: the computer used by the meeting secretary (书记员) may be a standard Windows 10 machine with no developer tooling installed. Requiring the operator to install Node.js, npm, or pnpm before running the system creates friction, introduces version-mismatch risks, and demands a level of technical expertise that cannot be assumed.

The Yanshan Meeting Big Data System eliminates this friction entirely. It is packaged as a 便携部署包 — a self-contained portable ZIP archive — that bundles everything the system needs to run, including the node.exe runtime. No software installation on the host machine is required beyond extracting the archive.

What the System Provides

Once extracted, the system gives you:

  • A one-click launch experience. The included 启动系统.bat script starts the application server with a double-click. The secretary does not need to open a terminal or type any commands.
  • A locally hosted web interface on port 3005. The Web Application Server begins listening immediately after launch. Any browser on the same machine can reach it at http://localhost:3005.
  • LAN-wide accessibility (局域网访问). Other devices on the same local area network can connect to the application using the secretary's computer IP address and port 3005. This allows participants or administrators at other machines to interact with the system without any additional setup.
  • An API layer for data operations. Behind the web interface, an API layer handles all data requests between the browser and the back-end business logic and storage. As a developer, this is the layer you interact with directly when building integrations or automating workflows.

Why a Portable, Self-Contained Package

Meeting environments demand fast, reliable setup with minimal IT involvement. By shipping node.exe inside the package itself, the system avoids dependency on the host machine's configuration. The version of Node.js the application was tested with is always the version it runs on, regardless of what the secretary's computer has installed — or does not have installed.

This design means you can treat the entire extracted directory as a single deployable unit: copy it to a machine, double-click 启动系统.bat, and the service is running. Teardown is equally simple — stop the server and delete the directory.

Who This Is For

The system is operated by the 书记员 (meeting secretary), whose computer acts as the host. As a developer consuming the API, you connect to the service that the secretary's machine is running — either from the same machine at http://localhost:3005, or from another device on the LAN using the host machine's IP address and port 3005.


Examples

Reaching the API from the host machine

After 启动系统.bat has been launched, the API is immediately reachable on the local machine:

GET http://localhost:3005/

Expected result: The web application interface is served by the Web Application Server. API endpoints under this base URL respond to data requests from the browser or any HTTP client.


Reaching the API from another device on the LAN

If the secretary's computer has the LAN IP address 192.168.1.42, any other device on the same network can reach the service:

GET http://192.168.1.42:3005/

Expected result: The same Web Application Server responds. The port 3005 is fixed; no configuration change is needed to enable LAN access — it is available by default once the server is running.


Verifying the server is up (curl)

curl -I http://localhost:3005/

Expected output (example):

HTTP/1.1 200 OK
...

A 200 OK response confirms the Web Application Server started successfully via 启动系统.bat and is accepting connections on port 3005.


Related concepts
  • Getting Started / Quick Start — Step-by-step instructions for downloading the portable package, extracting it, and launching the server with 启动系统.bat.
  • LAN Access (局域网访问) — How other devices on the local network connect to the Web Application Server using the secretary's computer IP and port 3005.
  • API Layer — Reference documentation for the endpoints, request formats, response schemas, and error handling exposed by the system.
  • Portable Package (便携部署包) — Details on the contents of the ZIP archive, including the bundled node.exe runtime and the role of each included component.