sivis/app

SIVIS Web前端镜像文档

1. 镜像概述和主要用途

本镜像为SIVIS Web系统的官方Web前端组件，基于现代Web技术构建，提供用户与SIVIS Web系统交互的图形界面。作为SIVIS Web架构的前端层，其主要用途是接收用户输入、展示系统数据及功能入口，并通过API与SIVIS Web后端服务通信，实现完整的用户操作流程。

2. 核心功能和特性

核心功能

• 用户界面渲染：提供SIVIS Web系统的可视化界面，包括菜单、表单、数据表格等交互元素
• 后端交互：通过HTTP/HTTPS协议与SIVIS Web后端API通信，处理数据请求与响应
• 用户状态管理：维护用户会话信息，支持登录、权限验证等用户状态相关操作
• 数据展示与处理：呈现SIVIS Web系统的业务数据，支持筛选、排序、导出等数据操作

主要特性

• 轻量级架构：基于静态Web技术构建，资源占用低，加载速度快
• 响应式设计：适配不同设备屏幕尺寸，支持桌面端与移动端访问
• 可配置化：支持通过环境变量或配置文件调整后端API地址等关键参数
• 易于集成：可与SIVIS Web后端服务无缝对接，支持容器化部署流程

3. 使用场景和适用范围

使用场景

• 部署SIVIS Web系统的前端服务，作为用户访问SIVIS Web功能的入口
• 替换或升级现有SIVIS Web前端版本，实现界面更新或功能扩展
• 与SIVIS Web后端服务配合，构建完整的SIVIS Web系统部署环境

适用范围

• 需要部署SIVIS Web系统的服务器环境（物理机、虚拟机或容器平台）
• 企业内部使用SIVIS Web系统的用户访问场景
• 需通过Web浏览器访问SIVIS Web功能的业务场景

4. 使用方法和配置说明

4.1 基本使用（Docker Run）

通过以下命令启动SIVIS Web前端服务：

bash
docker run -d -p 80:80 --name sivis-web-frontend \
  -e API_URL=http://sivis-web-backend:8080/api \
  sivis-web-frontend:latest

4.2 Docker Compose配置示例

yaml
version: '3'
services:
  frontend:
    image: sivis-web-frontend:latest
    ports:
      - "80:80"
    environment:
      - API_URL=http://backend:8080/api  # SIVIS Web后端API地址
      - PORT=80  # 前端服务监听端口
    depends_on:
      - backend  # 依赖SIVIS Web后端服务

  backend:
    image: sivis-web-backend:latest  # SIVIS Web后端镜像（示例）
    # 后端服务配置...

4.3 配置参数（环境变量）

4.4 访问服务

服务启动后，通过浏览器访问 http://<服务器IP>:<映射端口> 即可打开SIVIS Web前端界面。例如，使用默认配置时访问 http://localhost。