| | |
| | | ## 版权声明 |
| | | * BladeX是一个商业化软件,系列产品知识产权归**上海布雷德科技有限公司**独立所有 |
| | | * 您一旦开始复制、下载、安装或者使用本产品,即被视为完全理解并接受本协议的各项条款 |
| | | * 更多详情请看:[BladeX商业授权许可协议](https://license.bladex.cn) |
| | | |
| | | ## 答疑流程 |
| | | >1. 遇到问题或Bug |
| | | >2. 业务型问题打断点调试尝试找出问题所在 |
| | | >3. 系统型问题通过百度、谷歌、社区查找解决方案 |
| | | >4. 未解决问题则进入技术社区进行发帖提问:[https://sns.bladex.cn](https://sns.bladex.cn) |
| | | >5. 将帖子地址发至商业群,特别简单三言两语就能描述清楚的也可在答疑时间内发至商业群提问 |
| | | >6. 发帖的时候一定要描述清楚,详细描述遇到问题的**重现步骤**、**报错详细信息**、**相关代码与逻辑**、**使用软件版本**以及**操作系统版本**,否则随意发帖提问将会提高我们的答疑难度。 |
| | | |
| | | ## 答疑时间 |
| | | * 工作日:9:00 ~ 17:00 提供答疑,周末、节假日休息,暂停答疑 |
| | | * 请勿**私聊提问**,以免被其他用户的消息覆盖从而无法获得答疑 |
| | | * 答疑时间外遇到问题可以将问题发帖至[技术社区](https://sns.bladex.cn),我们后续会逐个回复 |
| | | |
| | | ## 授权范围 |
| | | * 专业版:只可用于**个人学习**及**个人私活**项目,不可用于公司或团队,不可泄露给任何第三方 |
| | | * 企业版:可用于**企业名下**的任何项目,企业版员工在**未购买**专业版授权前,只授权开发**所在授权企业名下**的项目,**不得将BladeX用于个人私活** |
| | | * 共同遵守:若甲方需要您提供项目源码,则需代为甲方购买BladeX企业授权,甲方购买后续的所有项目都无需再次购买授权 |
| | | |
| | | ## 商用权益 |
| | | * ✔️ 遵守[商业协议](https://license.bladex.cn)的前提下,将BladeX系列产品用于授权范围内的商用项目,并上线运营 |
| | | * ✔️ 遵守[商业协议](https://license.bladex.cn)的前提下,不限制项目数,不限制服务器数 |
| | | * ✔️ 遵守[商业协议](https://license.bladex.cn)的前提下,将自行编写的业务代码申请软件著作权 |
| | | # 指挥调度平台(大屏) |
| | | |
| | | ## 何为侵权 |
| | | * ❌ 不遵守商业协议,私自销售商业源码 |
| | | * ❌ 以任何理由将BladeX源码用于申请软件著作权 |
| | | * ❌ 将商业源码以任何途径任何理由泄露给未授权的单位或个人 |
| | | * ❌ 开发完毕项目,没有为甲方购买企业授权,向甲方提供了BladeX代码 |
| | | * ❌ 基于BladeX拓展研发与BladeX有竞争关系的衍生框架,并将其开源或销售 |
| | | ## 项目简介 |
| | | |
| | | ## 侵权后果 |
| | | * 情节较轻:第一次发现警告处理 |
| | | * 情节较重:封禁账号,踢出商业群,并保留追究法律责任的权利 |
| | | * 情节严重:与本地律师事务所合作,以公司名义起诉侵犯计算机软件著作权 |
| | | 本项目基于 **Vue 3** 开发,依赖 **Node.js 18 以上** 版本,并集成 **Cesium** 进行三维地图渲染。项目采用 **企业版 Blandx 前端框架** 进行二次开发,并使用 **rem** 进行响应式适配,以确保在不同设备上的良好体验。 |
| | | |
| | | ## 举报有奖 |
| | | * 向官方提供有用线索并成功捣毁盗版个人或窝点,将会看成果给予 500~10000 不等的现金奖励 |
| | | * 官方唯一指定QQ:1272154962 |
| | | ## 环境要求 |
| | | |
| | | - **Node.js**:18 及以上 |
| | | - **Vue 版本**:Vue 3 |
| | | - **依赖管理**: `yarn` |
| | | - **Cesium**:用于三维地图可视化 |
| | | |
| | | ## 项目启动 |
| | | |
| | | ### 1. 克隆仓库 |
| | | |
| | | ```sh |
| | | git clone git://139.196.74.78/drone/command-center-dashboard.git |
| | | cd command-center-dashboard |
| | | ``` |
| | | |
| | | ### 2. 安装依赖 |
| | | |
| | | ```sh |
| | | yarn install |
| | | ``` |
| | | |
| | | ### 3. 运行开发环境 |
| | | |
| | | ```sh |
| | | yarn dev |
| | | ``` |
| | | |
| | | ### 4. 构建项目 |
| | | |
| | | ```sh |
| | | yarn build |
| | | ``` |
| | | |
| | | ## 目录结构 |
| | | |
| | | ```bash |
| | | ├── public # 静态资源目录 |
| | | ├── src # 源代码目录 |
| | | │ ├── assets # 资源文件 |
| | | │ ├── components # 组件 |
| | | │ ├── views # 视图页面 |
| | | │ ├── router # 路由配置 |
| | | │ ├── store # Vuex 状态管理 |
| | | │ ├── main.js # 入口文件 |
| | | │ ├── App.vue # 根组件 |
| | | ├── package.json # 依赖管理 |
| | | ├── vite.config.mjs # Vue 配置文件 |
| | | ├── README.md # 项目说明 |
| | | ``` |
| | | |
| | | ## 主要技术栈 |
| | | |
| | | - **Vue 3**:前端框架 |
| | | - **Vue Router**:前端路由管理 |
| | | - **Vuex**:状态管理 |
| | | - **Cesium**:三维地图可视化 |
| | | - **Axios**:HTTP 请求库 |
| | | - **Element UI Plus**:UI 组件库 |
| | | |
| | | |
| | | |
| | | ## Git提交前缀 |
| | | |
| | | feat+英文冒号+空格+xxxxx |
| | | |
| | | | 类型 | 说明 | 示例 | |
| | | | -------- | ---------------------------- | -------------------------- | |
| | | | feat | 新增功能 | feat: 添加用户登录功能 | |
| | | | fix | 修复 bug | fix: 修复登录页面样式问题 | |
| | | | docs | 文档更新 | docs: 更新 README 文件 | |
| | | | style | 代码格式化(不影响代码逻辑) | style: 格式化代码 | |
| | | | refactor | 代码重构(不影响代码功能) | refactor: 重构用户管理模块 | |
| | | | perf | 性能优化 | perf: 优化数据加载速度 | |
| | | | test | 添加或修改测试 | test: 添加单元测试 | |
| | | | chore | 构建过程或辅助工具的变动 | chore: 更新依赖包 | |
| | | | ci | 持续集成相关配置更改 | ci: 配置 GitHub Actions | |
| | | | revert | 撤销之前的提交 | revert: 撤销上次提交 | |
| | | |
| | | ## 目录结构与命名规则 |
| | | |
| | | 项目采用 **大写开头的驼峰命名(PascalCase)** 方式,以保持统一性和可读性。 |
| | | |
| | | #### **1️⃣ 公共组件**(`components/`) |
| | | |
| | | - **存放全局复用的组件** |
| | | |
| | | - 命名方式:`PascalCase.vue` |
| | | |
| | | - **示例**: |
| | | |
| | | ``` |
| | | components/ |
| | | ├── Button.vue |
| | | ├── Modal.vue |
| | | ├── Table.vue |
| | | ``` |
| | | |
| | | #### **2️⃣ 页面组件**(按页面分类存放) |
| | | |
| | | - **每个页面独立文件夹,内部组件放在子文件夹** |
| | | |
| | | - **页面文件夹名:PascalCase** |
| | | |
| | | - **页面组件命名:与文件夹名一致** |
| | | |
| | | - **子组件按作用命名,保持层级清晰** |
| | | |
| | | - **示例**: |
| | | |
| | | ``` |
| | | bash复制编辑pages/ |
| | | ├── Home/ |
| | | │ ├── Home.vue # 首页主组件 |
| | | │ ├── HomeTop.vue # 首页顶部组件 |
| | | │ ├── HomeBottom/ |
| | | │ │ ├── HomeBottom.vue # 首页底部主组件 |
| | | │ │ ├── HomeBottomLink.vue # 首页底部链接组件 |
| | | ``` |