# trafficCardNBS

**Repository Path**: keyudu/trafficCardNBS

## Basic Information

- **Project Name**: trafficCardNBS
- **Description**: trafficCardNBS
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# trafficCardNBS

#### 介绍
{**以下是 Gitee 平台说明，您可以替换此简介**
Gitee 是 OSCHINA 推出的基于 Git 的代码托管平台（同时支持 SVN）。专为开发者提供稳定、高效、安全的云端软件开发协作平台
无论是个人、团队、或是企业，都能够用 Gitee 实现代码托管、项目管理、协作开发。企业项目请看 [https://gitee.com/enterprises](https://gitee.com/enterprises)}

#### 软件架构
软件架构说明


#### 安装教程

1.  部署后端
mkdir -p ~/nps/conf ~/nps/dist
sudo ln -s /opt/nbs ~/nps/
find trafficCardMan-Srv/ -name "*.jar" -exec cp -t /opt/nbs/ {} +
find trafficCardMan-Srv/ -name "*.yml" -exec cp -t /opt/nbs/conf/ {} +
find trafficCardMan-Srv/ -name "*.prod" -exec cp -t /opt/nbs/conf/ {} +
cp -r trafficCardMan-Web/dist/* /opt/nbs/dist/

# 如果没有 env.prod 文件，要先创建环境变量文件 (含数据库密码, 不进 Git)
cat > /opt/nbs/env.prod <<'EOF'
SPRING_DATASOURCE_URL=jdbc:postgresql://127.0.0.1:5432/card_man
SPRING_DATASOURCE_USERNAME=ivorysql
SPRING_DATASOURCE_PASSWORD=your_prod_password
MOS_SSO_SERVER_URL=https://116.129.254.70:9074
EOF
sudo chmod 600 /opt/nbs/env.prod

# 启动后端 (加载外部配置 + 环境变量)
set -a && source /opt/nbs/conf/env.prod && set +a && \
java -jar /opt/nbs/nbsCardStarter.jar \
  --spring.profiles.active=prod \
  --spring.config.additional-location=file:/opt/nbs/conf/ &

2.  前端nginx 配置
vi /etc/nginx/site-available/default
# 配置内容
	# 前端静态资源 (按实际部署路径调整)
	root /opt/nbs/dist;
	index index.html;

    # 静态资源缓存 (hash 命名的 JS/CSS 永久缓存)
	location ~* \.(?:js|css|woff2?|ttf|svg|png|jpg|jpeg|gif|ico)$ {
		expires 30d;
		add_header Cache-Control "public, immutable";
	}

	# 后端 API 反向代理 → Spring Boot (端口 5013)
	location /api/ {
		proxy_pass http://127.0.0.1:5013/api/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_read_timeout 60s;
	}

sudo nginx -t
sudo nginx -s reload

3.  xxxx

#### 使用说明

1.  xxxx
2.  xxxx
3.  xxxx

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

./traffic-card-platform-demo 这个简单的前端 demo, 我要做成一个流量卡分级管理平台系统；最后前后端分别引入一下目录：
./trafficCardMan-Srv #springboot app JPA 后端
./trafficCardMan-Web #react 前端；
./css/orange 这个目录下，是我期望本项目的组件 style 风格模板；

软件功能包含主要八项：
docs/排期-平台功能 Demo-开发计划预估.xlsx
文件中的“排期预算”工作表，“功能模块”列， 包含以下 8 大功能组件；

1. 组织分级管理
2. 卡片基础信息管理
3. 激活状态管理
4. 缴费 & 账单管理
5. 通信通道 & 套餐使用监控
6. 卡物流状态查询
7. 数据报表中心
8. 系统基础配置

a. 并要求本项目 WebServie 作为 oss client, 完成接入 MOS 系统单点登录的过程；实现 MOS 系统的菜单可以无密码登录 trafficCardNBS 平台；并把 trafficCardNBS 网页嵌入 MOS 系统；为了嵌入，要求 trafficCardNBS 菜单涉及均为顶部下拉菜单；

b. 除此之外， 用户期望引入 AI 智能引擎开发，包含以下 3 个引擎；
1.AI 智能引擎一：停机风险智能预测
2.AI 智能引擎二：异常流量/异常行为智能检测
3.AI 引擎三 套餐智能推荐;

c. 注意！ “阶段评估”工作表，说明了该项目开发为 Demo, 不要求完全实战落地，以前端 UI 展示为主，整个开发计划为期 28 天；

d. ./trafficCardMan-Srv 后端要求能够指定 nbsCardStarter 子模块作为 java 主程序，其他模块作为依赖；Controller 接口模块放在 nbsCardStarter 模块下

请先按照 “排期预算”工作表 的 8 大功能点，将模块框架分拆到前后端目录；
在启动编码工作前，请将你的技术方案，在 docs/目录下生成 "trafficCardNBS Demo 技术构架方案.md"， 与 "trafficCardNBS Demo 开发文档.md"

我提议数据库用 ivorySQL docker container;