LMS (LAN Management System) is a comprehensive suite of applications designed for the management of LAN networks. Its primary objective is to deliver optimal service to customers, as exemplified by large Internet Service Providers (ISPs). LMS is developed using PHP, Perl, and C programming languages and supports MySQL or PostgreSQL as database backends. The current feature set includes: a customer database (storing names, addresses, phone numbers, comments, etc.), an inventory system for tracking computers (IP and MAC addresses), a streamlined financial system tailored for network operations (including financial balances, invoices, and email notifications), an automated billing schedule, the ability to generate a wide range of configuration files (e.g., ipchains/iptables firewall scripts, DHCP daemon configurations, DNS zone files for bind, /etc/ethers entries, oident, htb settings, etc.), bandwidth consumption visualization per host, a request tracking system (Helpdesk functionality), and a scheduling organizer.

LMS (Local Network Management System) is a comprehensive management tool designed for enterprises, schools, government institutions and other local area network environments, aiming to improve the efficiency of LAN operation and maintenance, ensure network security, and optimize resource allocation. Through centralized management, real-time monitoring and intelligent control of devices, users, traffic and permissions in the LAN are realized.

• AI Integration: Leverage machine learning algorithms to forecast traffic surges and dynamically adjust network policies for optimal performance.
• Cloud-Edge Collaboration: In conjunction with the cloud management platform, achieve unified governance over cross-regional local area networks (LANs).
• IoT Expansion: Facilitate the connection and administration of emerging terminal devices, including 5G and LoRa technologies.
• Automated Operations and Maintenance: Minimize manual intervention through self-healing scripts designed for fault resolution.

The following provides comprehensive steps for installing an LMS system. Note that specific procedures may vary depending on your chosen LMS platform (Moodle, Canvas, Blackboard, etc.).

• Pre-Installation Preparation 1.Verify System Requirements

    Web server (Apache/Nginx/IIS)
    Database server (MySQL/MariaDB/PostgreSQL)
    PHP (version must meet LMS specifications)
    Required PHP extensions
  

  2.Acquire LMS Software

    Download the latest stable release from the official vendor website
    Alternatively, clone the repository using Git
  

1.Configure Environment

    # Example for Ubuntu/Debian systems
    sudo apt update
    sudo apt install -y apache2 mysql-server php \
        libapache2-mod-php php-mysql php-xml \
        php-curl php-zip php-gd php-mbstring

[Changed: Reorganized package installation for better readability]

2.Setup Database

    CREATE DATABASE lmsdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    CREATE USER 'lmsuser'@'localhost' IDENTIFIED BY 'securepassword';
    GRANT ALL PRIVILEGES ON lmsdb.* TO 'lmsuser'@'localhost';
    FLUSH PRIVILEGES;

[Changed: Fixed typo in "PRIVILEGES" and improved formatting]

3.Deploy LMS Files

    # Extract or clone into web directory
    cd /var/www/html
    sudo unzip lms.zip -d lms/

    # OR for Git installation
    sudo git clone https://github.com/lms-project/lms.git lms

[Changed: Added -d flag for unzip and made Git command more explicit]

4.Configure Permissions

    sudo chown -R www-data:www-data /var/www/html/lms
    sudo find /var/www/html/lms -type d -exec chmod 755 {} \;
    sudo find /var/www/html/lms -type f -exec chmod 644 {} \;

[Changed: Enhanced permission settings with find commands for better security]

5.Finalize Installation via Web Interface

    -Navigate to http://your-server-ip/lms

    -Complete the installation wizard by:

    1.Providing database connection details

    2.Creating administrator credentials

    3。Configuring initial system settings

[Changed: Reformatted as a numbered list for clarity]

一、 Equipment management Function Description:

1. Automatic device discovery: Automatically identify devices within the local area network (computers, printers, IoT devices, etc.) through ARP scanning and SNMP protocol.
2. Equipment classification and labeling: Automatically classified by type (terminal/server/IoT), department, and location, supporting custom labels.
3. IP/MAC address binding: prevents illegal device access, supports static binding and dynamic allocation strategies.
4. Equipment status monitoring: Real time display of equipment online/offline status, operating system, open ports, and other information.

二、 Traffic monitoring and analysis Function Description:

1. Real time traffic monitoring: Display the upload/download speed and bandwidth usage ranking of devices/IPs.
2. Historical traffic statistics: Generate traffic trend charts by day/week/month, and support exporting to Excel.
3. Traffic restriction strategy: Set bandwidth limits for devices or groups, and prioritize control (such as prioritizing video conferencing traffic).
4. Protocol analysis: Identify the proportion of protocols such as HTTP/HTTPS, FTP, and gaming, and block illegal protocols.

三、 Access Control and Security Function Description:

1. Blacklist rule: Set access permissions based on IP/MAC address, port, and protocol.
2. VLAN partitioning: Isolate different departments/devices into independent VLANs to enhance network security.
3. Firewall linkage: Integrate with existing firewalls to automatically intercept illegal devices or abnormal traffic.
4. Network topology diagram: Visualize device connection relationships and quickly locate faulty nodes.

四、 Alarm and Notification Function Description:

1. Abnormal alarm: device offline, traffic exceeding limit, illegal access and other events trigger alarms.
2. Notification methods: push notifications through various channels such as email, SMS, WeChat, Webhook, etc.
3. Alarm threshold setting: Custom traffic threshold (such as bandwidth usage exceeding 90% for 5 minutes).

五、 Visualization and Reporting Function Description:

1. Dashboard panel: Summarize core data such as device status, traffic, and alarms.
2. Custom reports: Generate device inventory, traffic reports, and security audit logs.
3. Network topology diagram: Drag and drop editing of topology, supports importing background images (such as computer room layout).

六、 Permission Management and Audit Function Description:

1. Multi role permissions: graded permission control for administrators, operations personnel, and auditors.
2. Operation log: Record device configuration modifications, policy adjustments, and other operations, supporting traceability.
3. Remote maintenance: Restart the device through the web interface and execute commands (requiring SSH/RDP support).

七、 Expansion and Integration Function Description:

1. API interface: Provides RESTful APIs that can be integrated with third-party systems such as Zabbix and Prometheus.
2. Plugin market: Supports the installation of third-party plugins (such as DDNS and traffic shaping tools).
3. Multi platform support: Compatible with Windows/Linux/macOS and supports Docker deployment.

=======

The docgen.sh file is a Bash script whose main function is to generate documents in different formats (HTML or plain text) from SGML source files based on the input parameters (html, txt, or all). It calls tools such as jade and lynx to convert SGML files into HTML or TXT formats and moves or renames the generated files to the specified directory. The script supports three usages:

• html: Generate HTML format document
• txt: Generate plain text format document
• all: Generate both HTML and plain text documents
• If the parameter is incorrect, a usage prompt will be output. [Project Main Function Screenshots] ![Main functional images/2205308030301-1.png ]<!--李金艳 著> The project (LMS, possibly "LAN Management System" or "Local Management System") is mainly used to manage and generate configuration files related to VoIP (such as the Asterisk voice switching system) and automate the configuration process of telecommunication systems. The following describes the main functions and core code separately: Main Function
• Automatically generate Asterisk configuration files: By reading VoIP account, phone number, emergency number and other information from the database, automatically generate the SIP and extension configuration files (such as sip-lms.conf, extensions-lms-incoming.conf, extensions-lms-outgoing.conf) required by Asterisk, for automated deployment and management of the telephone system.
• Configuration management: Supports specifying configuration files, outputting detailed information, selecting configuration sections, etc. through command line parameters, making it easy to flexibly integrate and maintain.
• Database integration: Obtain account, number, permission and other information through the database to achieve seamless connection with the business system.
• Core function: The core of this project is to automatically generate and manage the configuration files required by Asterisk (open source telephony system), and realize the centralized and automated management of telecommunication systems by combining database and configuration files.
• Main code: Focuses on reading configuration, database, generating configuration files and other automated processes [Project Main Function Screenshots] ![Main functional images/2205308030301-2.png ]<!--李金艳 著> The project (LMS, LAN Management System) is mainly used for the automation management of telecommunication services, especially the integration with VoIP (such as Asterisk). Its core functions cover telephone system configuration, call detail record billing, emergency number management, etc. Main Function
• Automatically generate Asterisk configuration files: Automatically generate SIP account and extension dialing rule configuration files through database information to realize the automated deployment and management of the telephone system.<!--李金艳 著>
• Call Detail Record (CDR) billing and import: Supports batch import of call detail records (CDR) from files or standard input, and writes them to the database, realizing automatic billing and billing management.
• Emergency Number (Emergency Numbers) Management: Automatically associate emergency numbers with geographic areas and import them into the database by parsing TERYT (Polish administrative division) data and emergency number CSV files, facilitating subsequent call routing and compliance management.<!--李金艳 著>
• Command line tool and configuration management: All scripts support command line parameters, flexibly specify configuration files, operation types, input methods, etc., facilitating automated operations and maintenance.<!--李金艳 著> Main code structure and core logic

1. Emergency number import (lms-teryt-emergency-numbers.php)
   • Function: After parsing the TERYT administrative division and emergency number CSV files, automatically match the administrative division, district, township and other information, and write the emergency number to the database table voip_emergency_numbers.
   • Screenshot: ![Main functional images/2205308030301-3.png ]<!--李金艳 著>
2. Call Detail Record billing and import (lms-billing.php)
   • Function: Batch import call detail records (CDR), or estimate the maximum call duration for the caller and the callee.
   • Screenshot: ![Main functional images/2205308030301-4.png ]<!--李金艳 著>
3. Asterisk configuration generation (lms-asterisk.php)
   • Function: Automatically generate SIP account and extension dialing rule configuration files to facilitate the automated deployment of the telephone system.
   • Screenshot: ![Main functional images/2205308030301-5.png ]<!--李金艳 著>
4. Cash flow batch import (lms-cashimport.php)
   • Function: The script is used to batch import cash flow (such as bank statements, payment records, etc.) into the LMS system database. It supports reading data from a specified file or standard input, parsing the content through the regular expression pattern (pattern) in the configuration, automatically identifying and importing various payment records, and can automatically submit to the database according to the configuration. Suitable for financial automatic reconciliation, batch recharge and other scenarios.
   • Screenshot: ![Main functional images/2205308030301-6.png ]
5. SMS delivery report processing (lms-smstools-delivery-report.php)
   • Function: The lms-smstools-delivery-report.php script in this project (LMS, LAN Management System) is used to process the delivery report files sent by the SMS gateway (such as SMSTools) and automatically update the SMS sending status in the database.
   • Process:
     • Parse command line parameters to get configuration file and SMS delivery report file path.
     • Read and parse the SMS delivery report file to extract SMS ID, status, timestamp, mobile number and other information.
     • Query the corresponding SMS sending record in the database.
     • Automatically update the status of the SMS in the database (such as delivered, failed, etc.) according to the delivery report content.
   • Screenshot: ![Main functional images/2205308030301-7.png ]
6. General parameter parsing and environment initialization (script-options.php)
   • Function: script-options.php is a common parameter parsing and environment initialization module for all command line scripts of the LMS system.
   • Main function:
     • Uniformly parse command line parameters (support long and short parameters, optional/optional parameters, parameter verification, etc.).
     • Automatically load the configuration file (such as lms.ini) and define global directory constants (such as SYS_DIR, LIB_DIR, MODULES_DIR, etc.).
     • Initialize the database connection $DB, load the Composer autoloader and LMS basic library.
     • Support common parameters such as --help, --version, --quiet, and automatically output help and version information.
     • Compatible with HTTP mode and CLI mode, adapt to different running environments.
   • Screenshot: ![Main functional images/2205308030301-8.png ]
7. Cash flow batch import configuration (cashimportcfg-id75.php)
   • Function: This file cashimportcfg-id75.php is a custom parsing configuration for the cash flow batch import function of the LMS system.
   • Function: Provide regular expression and field mapping rules for the lms-cashimport.php script, so that the system can automatically identify and import bank statements or payment flow data in a specific format.
   • Main function:
     • Define the regular matching pattern (pattern) of each line of data.
     • Specify the position of each field (such as customer ID, amount, date, remarks, etc.) in the matching result.
     • Define the secondary regular extraction rules for date, customer ID, invoice number, etc.
     • Support data encoding conversion, amount correction, remarks content replacement, etc.
     • Support deduplication through the whole line hash.
   • Screenshot: ![Main functional images/2205308030301-9.png ]
8. MediaWiki authentication plugin (authLMS.php)
   • Function: This project authLMS.php is a LMS system user authentication plugin for MediaWiki, which realizes MediaWiki users login authentication through the account password of the LMS system.
   • Main function:
     • Let MediaWiki use the user database of the LMS system for authentication (single sign-on).
     • Support LMS user password verification, IP/host restriction, validity period restriction, etc.
     • Automatically synchronize LMS user nickname, email and other information to MediaWiki user profile.
     • Prevent local modification of password or creation of new account in MediaWiki, and all user management is completed in the LMS system.
   • Screenshot: ![Main functional images/2205308030301-10.png ]<!--李金艳 著>
9. Location data cache and query class (class.LocationCache.php)
   • Function: This file [lib/backend/class.LocationCache.php]class.LocationCache.php ) is the location data cache and query class of the LMS system.
   • Main function:
     • Efficiently cache and query geographic information such as city, street, building, etc., reduce database access times, and improve performance.
     • Support two loading strategies (all loading/on demand loading) to adapt to different data volumes and memory requirements.
     • Provide interfaces to obtain city, street, building and other information through ID, identifier and other methods.
10. Configuration partition container class (ConfigContainer.php)
    • Function: This file ConfigContainer.php is the configuration partition container class of the LMS system, which is used to manage and operate multiple configuration partitions (section), realize the grouping, batch addition, query, sub-partition filtering and other functions of the configuration.
    • Main function:
      • Store and manage multiple configuration partitions (ConfigSection objects).
      • Support adding a single or multiple configuration partitions.
      • Support getting partitions by name, judging whether partitions exist.
      • Support getting all sub-partitions under a partition.
11. INI configuration file reading adapter (IniConfigProvider.php)
    • Function: This file IniConfigProvider.php is the INI configuration file reading adapter of the LMS system, which implements ConfigProviderInterface and is used to load the system configuration from the specified INI file and return it in the form of an array.
    • Main function:
      • Load the INI configuration file at the specified path on demand (support custom path).
      • As a bottom-level data provider for the configuration container, provide raw configuration data for other configuration management classes in the system.
12. Customer management interface definition (LMSCustomerManagerInterface.php)
    • Function: This file LMSCustomerManagerInterface.php is the customer management interface definition of the LMS system, which is used to standardize the implementation of all customer management related operations.
    • Main function:
      • Uniformly define all methods related to customer management (such as obtaining customer information, contact information, billing, address, consent, external ID, call records, etc.).
      • Facilitate different implementation classes (such as database implementation, Mock implementation, etc.) to follow the same interface, ensuring system scalability and maintainability.
      • Support full range operations such as customer add, delete, modify, query, status change, consent management, external ID management, call management, etc.
13. Document manager (LMSDocumentManager.php)
    • Function: This file LMSDocumentManager.php is the document manager of the LMS system, which is responsible for all operations related to documents (such as invoices, contracts, notices, etc.) in the system.
    • Main function:
      • Get customer document list, document details, attachments, archived documents, etc.
      • Manage document numbering scheme (NumberPlan), such as get, add, update, delete numbering scheme.
      • Document archiving, publishing, deletion, permission copying, etc.
      • Document email/SMS notification sending, attachment management, duplicate checking, etc.
      • Support multiple filtering, permission verification, batch operation of documents. Project Glossary (Chinese-English Glossary) [Here is the picture]

Project Glossary (Chinese-English Glossary) [Here is the picture] markdown <!--李金艳 著>

1. English README.md - Project Introduction Writer: Liang Bingli 。 Responsible for writing the project introduction section in both English README.md and Chinese README.zh.md, including project background, objectives, and functional overview. 。 Ensure the content is concise, clear, logical, and uses professional English expressions. After completing the first draft, use AI to review professional terminology. 。 Add author comment identifiers as required in the content. 。 Submit at least twice, with each commit message clearly describing the submitted content, and each contribution having no fewer than 10 lines of Changes.
2. English README.md and Chinese README.zh.md - Installation/Deployment Instructions Writer: Wang Yue 。 Write the installation/deployment instructions section in the English README.md, detailing the project's required dependencies, installation steps, and deployment methods. Clearly describe each step, and you may add screenshots to aid understanding. After completion, use AI to review professional terminology to ensure accuracy. 。 Add author comment identifiers to the corresponding content. 。 Ensure at least 2 valid submissions, with each submission meeting the required number of Changes.
3. English README.md and Chinese README.zh.md - Project Main Function Introduction with Screenshots Writer (including screenshots): 。 Responsible for writing the usage tutorial section with screenshots for the main functions in both English README.md and Chinese README.zh.md. Operate the main functions of the project, record the operation steps, and capture key interface screenshots. Write detailed usage tutorials based on the screenshots, use AI to review professional terminology to make the tutorial content easy to understand. Add author comment identifiers in the content. 。 Complete at least 2 valid submissions as required.
4. Project Glossary Creator: Li Jinyan 。 Collect professional terms involved in the project, create a bilingual glossary (terms.md) with Chinese-English correspondence, with no fewer than 5 terms. 。 Accurately translate each term into Chinese and English. AI tools can be used for assistance, but manual review and confirmation are required. 。 Ensure the glossary content is formatted correctly, clear, and easy to read.
5. Chinese README.zh.md Translation and Polishing: Li Jinyan, Liang Bingli, Wang Yue, Wei Siyu 。 Use AI assistance to translate the English README.md into Chinese README.zh.md. After translation, perform detailed polishing to ensure the Chinese expression is natural and fluent, accurately conveying the original meaning. 。 Check and correct any errors or inappropriate expressions that may occur in the AI translation. Retain the original author comment identifiers in the translated content. 。 Submit the translated and polished content at least twice, ensuring sufficient workload with each submission.
6. AI Usage Document Writer and Screenshot Organizer: Li Jinyan, Liang Bingli, Wang Yue, Wei Siyu 。 Write a usage document, briefly explaining the work of each team member using AI assistance, including the AI tools used, application scenarios, and purposes, etc. 。 Organize the AI usage process screenshots of team members, name them in the format of student ID_file number (e.g., 2023001_1.jpg), and store them uniformly in the ai_usage_screenshots folder. 。 Check if the screenshots meet the requirements (JPG or PNG format), ensure they are clear and can show the questioning process. Submit the organized results at least twice. <!-- Li Jinyan Author >