Project Overview

Source Files

This page is generated from the following source files:

• README.md
• pom.xml
• docker-compose.yml
• [doc/NBCIO 亿事达企业管理平台帮助文档.docx](https://github.com/nbacheng/nbcio-boot/blob/master/doc/NBCIO 亿事达企业管理平台帮助文档.docx)
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/echarts-wordcloud.js
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/room.js
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/china.js
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/resize.js
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/geoCoord.js
• nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/jquery.min.js

NBCio-Boot is an enterprise management platform built on the Jeecg-Boot 3.0 framework, designed to provide comprehensive business process management capabilities. The project integrates Flowable workflow engine for process automation, DingTalk integration for mobile approvals, and includes features such as chat functionality and ERP-style data selection components. The platform targets enterprises requiring flexible workflow customization and multi-channel approval processes.

Project Introduction and Background

NBCio-Boot (NBCIO亿事达企业管理平台) version 3.0 is an enterprise-level management platform that extends the Jeecg-Boot low-code development framework. The project aims to deliver a comprehensive solution for business process management, workflow automation, and enterprise resource planning through a modular architecture.

The platform's core value proposition centers on three key areas: workflow management through Flowable 6.7.2 integration, mobile office capabilities via DingTalk connectivity, and extensible business modules for OA and ERP applications. Based on Jeecg-Boot 3.0 (released November 2021), the project inherits robust low-code capabilities while adding specialized enterprise features.

Project Metadata:

• Artifact ID: nbcio-boot-parent
• Version: 3.0
• Group ID: com.nbcio.boot
• Base Framework: Spring Boot 2.3.5.RELEASE

Evidence: README.md:1-10 | pom.xml:1-20

Core Functional Features

The platform provides a comprehensive set of enterprise management capabilities, with workflow automation as the primary differentiator.

Workflow Management System

The workflow module leverages Flowable 6.7.2 to deliver complete process lifecycle management:

• Process Design: Visual process definition with custom form binding
• Form Definition: Dynamic form creation linked to workflow nodes
• Process Initiation: User-initiated workflows with business data association
• Process Routing: Automated task assignment and transition handling
• Message Notifications: Real-time alerts for pending approvals

The system supports custom business process definitions, allowing enterprises to model complex approval chains without code modifications.

DingTalk Integration

A salary approval workflow demonstrates DingTalk integration capabilities. After defining a process in the backend system, approvals can be completed through DingTalk mobile client, enabling seamless mobile office scenarios.

Additional Enterprise Features

• Chat Functionality: Real-time communication module for internal collaboration
• ERP Data Selection: Frontend components supporting master-detail data selection for inventory and ERP applications
• Big Screen Visualization: Dashboard templates with ECharts integration for data presentation

Evidence: README.md:89-104 | README.md:54-64

Technical Architecture and Dependencies

Backend Technology Stack

Evidence: README.md:24-38 | pom.xml:15-45

Cloud and Microservice Dependencies

The project includes Spring Cloud and Spring Cloud Alibaba dependencies for potential microservice deployment:

• Spring Cloud: Hoxton.SR8
• Spring Cloud Alibaba: 2.2.3.RELEASE
• Nacos: Configuration center and service discovery (default: 127.0.0.1:8848)

Database Support

Multi-database compatibility is provided through appropriate driver versions:

The dynamic datasource starter (version 3.2.0) enables runtime database switching for multi-tenant scenarios.

Evidence: pom.xml:15-45

Development and Deployment Environment

Development Requirements

Docker Containerization

The project provides Docker Compose configuration for containerized deployment with three core services:

yaml
1version: '2'
2services:
3  nbcio-boot-mysql:
4    image: nbcio-boot-mysql
5    ports:
6      - 3306:3306
7    environment:
8      MYSQL_ROOT_PASSWORD: root
9      TZ: Asia/Shanghai
10    command:
11      --character-set-server=utf8mb4
12      --collation-server=utf8mb4_general_ci
13
14  nbcio-boot-redis:
15    image: redis:5.0
16    ports:
17      - 6379:6379
18    hostname: nbcio-boot-redis
19
20  nbcio-boot-system:
21    image: nbcio-boot-system
22    ports:
23      - 8080:8080
24    depends_on:
25      - nbcio-boot-mysql
26      - nbcio-boot-redis

Configuration Steps

1. Host Configuration: Map service hostnames to localhost
2. Profile Activation: Set active: dev in application.yml
3. Database Connection: Configure MySQL and Redis connections in application-dev.yml
4. Build: Execute mvn clean package from project root
5. Access: Navigate to http://localhost:8080/nbcio-boot/doc.html for Swagger API documentation

Evidence: README.md:41-52 | docker-compose.yml:1-42

System Architecture Overview

The platform follows a layered modular architecture with clear separation of concerns:

正在加载图表渲染器...

Architecture Explanation:

1. Presentation Layer: Vue-based frontend communicates with backend through RESTful APIs; Swagger UI provides interactive API documentation at /doc.html endpoint
2. Gateway Layer: Shiro handles authentication/authorization with JWT tokens for stateless session management
3. Business Layer: Three core modules handle distinct concerns - system management, workflow processing, and demonstration features
4. Data Layer: MyBatis-Plus provides ORM abstraction; Druid manages database connections; Redis handles caching and session storage
5. Storage Layer: MySQL as primary database; Aliyun OSS for file storage needs

Evidence: README.md:24-38 | docker-compose.yml:1-42

Request Processing Flow

The following sequence diagram illustrates the authentication and request processing flow:

正在加载图表渲染器...

Flow Explanation:

1. Authentication Check: Every request passes through Shiro filter chain which extracts and validates JWT token
2. Authorization: Valid tokens are decoded to extract user principal and permissions
3. Business Processing: Controllers delegate to service layer for business logic execution
4. Cache-Aside Pattern: Services check Redis cache first; on miss, query database and populate cache
5. Response Serialization: Results are serialized to JSON and returned to client

Evidence: README.md:24-38 | docker-compose.yml:1-42

Module Structure and Responsibilities

Core Modules

Based on the Maven project structure, the platform consists of the following modules:

Module Dependency Graph

正在加载图表渲染器...

Evidence: pom.xml:136-159

Big Screen Visualization Module

The demo module includes a big screen visualization template with ECharts integration. Key JavaScript components include:

The word cloud implementation includes sophisticated Bezier curve projection algorithms for text positioning:

javascript
1function cubicProjectPoint(x0, y0, x1, y1, x2, y2, x3, y3, x, y, out) {
2  var t;
3  var interval = 0.005;
4  var d = Infinity;
5  
6  // Coarse estimation of minimum distance t value
7  for (var _t = 0; _t < 1; _t += 0.05) {
8    _v1[0] = cubicAt(x0, x1, x2, x3, _t);
9    _v1[1] = cubicAt(y0, y1, y2, y3, _t);
10    d1 = v2DistSquare(_v0, _v1);
11    if (d1 < d) {
12      t = _t;
13      d = d1;
14    }
15  }
16  // Iterative refinement with 32 max iterations
17}

Evidence: nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/echarts-wordcloud.js:1875-2117 | nbcio-boot-module-demo/src/main/resources/static/bigscreen/template1/js/room.js:1161-1268

Quantitative Capabilities

Applicable Scenarios

The platform is suitable for:

1. Enterprise Workflow Automation: Organizations requiring customizable approval processes with mobile integration
2. Low-Code Development: Teams seeking rapid application development on Jeecg-Boot foundation
3. OA System Implementation: Office automation with workflow, chat, and document management
4. ERP Extension: Inventory and resource management with master-detail data selection
5. Data Visualization: Real-time monitoring dashboards with big screen displays

Report Reading Roadmap

正在加载图表渲染器...

Recommended Reading Order:

1. Project Overview (current): Understand project scope, technology stack, and core features
2. Architecture Analysis: Deep dive into module structure and dependency relationships
3. Workflow Module: Examine Flowable integration and process management implementation
4. Security Implementation: Review Shiro and JWT authentication mechanisms
5. API Design: Explore RESTful endpoints and data models
6. Deployment Guide: Follow production deployment procedures