bigcapitalhq/webapp

Bigcapital Web客户端镜像

镜像概述

该镜像为Bigcapital财务软件的前端Web客户端组件，基于现代Web技术构建，用于提供完整的用户操作界面。用户通过浏览器访问该客户端，实现与Bigcapital后端服务的交互，进行财务数据查看、管理及相关业务操作。

核心功能与特性

核心功能

• 提供Bigcapital财务软件的完整用户界面，包括仪表盘、账户管理、交易记录、财务报表等核心模块
• 与Bigcapital后端API服务通信，处理用户操作请求并展示后端返回数据
• 支持财务数据可视化，通过图表等形式直观呈现收支、资产负债等财务信息
• 实现用户认证与权限管理流程，确保财务数据访问安全

主要特性

• 响应式设计：适配桌面端、平板及移动设备，提供跨终端一致的操作体验
• 直观交互界面：简化财务操作流程，降低用户学习成本
• 实时数据同步：与后端服务保持数据实时同步，确保信息准确性
• 安全访问控制：支持用户登录、角色权限等安全机制，保护敏感财务数据

使用场景与适用范围

• 适用场景：部署Bigcapital财务软件时作为前端访问入口，供个人或企业用户通过浏览器使用财务管理功能
• 适用范围：需配合Bigcapital后端服务使用，适用于个人财务管理、小型企业会计核算、财务数据跟踪等场景
• 前置条件：已部署Bigcapital后端服务，且Web客户端可网络访问后端API接口

使用方法与配置说明

环境要求

• Docker引擎版本：20.10.0及以上
• 网络要求：客户端容器需与Bigcapital后端服务网络连通，确保API通信正常

关键配置参数

Docker运行示例

bash
docker run -d \
  --name bigcapital-web \
  -p 8080:80 \
  -e REACT_APP_API_URL=http://bigcapital-backend:3000/api \
  bigcapital/web-client

Docker Compose配置示例

yaml
version: '3'
services:
  web-client:
    image: bigcapital/web-client
    container_name: bigcapital-web
    ports:
      - "8080:80"
    environment:
      - REACT_APP_API_URL=http://backend:3000/api
    depends_on:
      - backend
    restart: unless-stopped

  backend:
    # Bigcapital后端服务配置（需参考对应文档）
    image: bigcapital/backend
    environment:
      - DATABASE_URL=postgres://user:password@db:5432/bigcapital
    # 其他后端配置...

注意事项

• 必须正确配置REACT_APP_API_URL环境变量，指向可用的Bigcapital后端API地址，否则客户端无法正常加载数据
• 启动容器后，通过浏览器访问 http://<主机IP>:<映射端口>（如http://localhost:8080）即可使用客户端
• 如需启用HTTPS，建议通过反向代理（如Nginx）配置，客户端本身通常不直接提供HTTPS服务