vue3-element-plus-app-chu
v0.0.61
Published
基于 Vite 初始化的 Vue 3 项目,使用 TypeScript,并已全局注册 Element Plus。
Readme
Vue 3 + TypeScript + Element Plus
基于 Vite 初始化的 Vue 3 项目,使用 TypeScript,并已全局注册 Element Plus。
启动
pnpm dev # 同时启动前端(5173)和指定后端(3011)
pnpm dev:frontend # 只启动前端
pnpm dev:backend # 只启动 verce-vue-test/backend 后端一键启动命令通过 npm-run-all2 并行执行两个子命令,输出带 [dev:frontend] / [dev:backend] 前缀。
后端项目统一使用 /Users/bombingpig/WebstormProjects/verce-vue-test/backend,本项目不再保留 backend/ 代码。已有 3011 后端服务运行时,使用 pnpm dev:frontend 即可复用该服务。前端开发代理将 /TAM、/api、/nacos 请求转发到 http://localhost:3011/oms,例如 /TAM/0001/140501001 对应后端 /oms/TAM/0001/140501001。
接口以 Scalar 文档 和 OpenAPI JSON 为准,统一服务前缀为 /oms。仓库内的接口摘录用于查看字段和页面对应关系,不能替代运行中后端的文档。
全局布局
应用外壳位于 src/layout/index.vue,由 App.vue 通过 RouterView 挂载,统一承载侧边导航、折叠状态和业务页面内容。菜单配置在 src/router/menus.ts,路由表在 src/router/index.ts,新增业务页面时两处各追加一项即可。业务地址、浏览器前进后退和刷新都由 vue-router 驱动;头寸预报列表页由 KeepAlive 缓存,返回时保留筛选和分页状态。
“注资/预注资管理”为一级分组菜单,下设“数字人民币注资明细查询”和“数字人民币账户行余额查询申请”。页面目录统一放在 src/view/dcps/funding/ 下,路由分别为 /funding/injection 和 /funding/balance;旧地址 /injection、/balance 继续可用。
数字人民币头寸预报
默认入口为数字人民币头寸预报(/forecast),侧边菜单可切换至其他数字人民币页面。
- 列表页只保留筛选卡片和表格卡片;筛选条件压在一行,窗口过窄时才换行。
- 新增、修改、详情与列表共用
/forecast入口,以当前页面状态切换完整视图,页面顶部提供“返回列表”按钮;返回后列表的筛选和分页状态不变。 - 支持交易日期、客户、交易对手、机构、金额范围及业务代码筛选,分页、详情、新增、修改和批量删除。
- 金额、账号及流水号使用字符串处理。业务类型使用文档明确的中文选项,其余未提供字典的代码保留接口原值。
- 导出复用查询接口,提交公共头
fileFlag: 'Y'并下载后端返回的 CSV data URI;导入接口当前返回501,页面移除导入入口。 - 新增仅要求业务类型、预报金额、交易日期和收支方向,客户、机构等字段选填;支付渠道未传时由后端默认
8,预报日期未传时由后端默认当天。新增、修改不展示或提交接口未声明的票号、出票日。 - 详情只展示当前详情接口声明的 15 个字段;编辑提交修改接口的全部参数,包括禁用、未变化及空值字段,客户流水号映射为
custRefSeq。查询排序中,预报时间排序传1,预报金额排序传2。 - 模块目录与授权页面保持一致:
api.ts放接口定义,typs.ts放类型,index.vue包含列表、表单、详情和页面内工具函数。默认交易日期通过共用的src/view/dcps/runtime.ts获取,接口定义只维护在各自模块下,不再集中到src/api。 - 新增、修改表单按实际内容区宽度自动排列,最多四列;侧栏或宿主容器变窄后自动减少列数。详情页面按窗口宽度调整列数。
页面通过公共请求层读取 TAM 的 head/body,统一响应的解包与兼容处理由 src/utils/request.ts 负责。指定后端用于替代前端 mock;数字人民币核销、修改和撤销核销按顺序直接更新数据库,单机 MongoDB 即可使用。head.consumerSeqNo 可选,传入时支持相同请求重试;原金额和状态快照校验仍保留。注资发起只保存 PENDING / NOT_SENT 待处理记录,不调整账户余额;预报导入当前返回 501。业务校验、数据保存和导入导出均以指定后端的实时文档及实现为准。
所有页面的支付渠道统一使用 8 表示数字人民币。数字人民币页面的业务类型使用 201/202/203 字典,新增预报不提交 predName;项目内预报收支方向统一使用 1 收入、2 支出,流水统一使用 I 收入、O 支出,查询、请求和结果展示均按各自编码处理。核销预报待核销查询包含状态 1/3,展示交易对手账号;流水可按业务类型筛选并读取 tranStatus;注资明细支持起止交易日期;授权页展示业务类型中文名称。匡算明细展示部分核销状态。字段及页面接口映射见 数字人民币接口摘录,当前接口约束以实时文档为准。
独立页面 /flow-query 的普通查询、初次加载、分页和刷新与核销页面的流水信息共用 /TAM/0001/140502002,参数保持一致:交易日期 tranDate 必填且默认取共用业务日期,可按业务类型、我方机构、付款人、收款人、收支方向、金额范围和核销状态筛选,未填写的可选条件不提交。列表读取 resultList 和字符串类型的 totalCount,字段沿用核销流水模型。「查询」「实时查询流水」与「重置」按钮并排放在查询条件区末尾。「实时查询流水」单独调用 /TAM/0001/140504002,只携带公共分页参数 pageIndex: 1、pageSize: 1,业务请求体为空;成功提示“操作成功”,失败仅记录控制台,不更新列表。
城银清头寸参数接口
数币参数页面位于 src/view/dcps/parameters/,查询和新增使用 moduleCode: '5';详情直接取表格行数据,修改和删除按参数名称定位。指定后端当前通过 swaggerStub 返回参数接口的静态兼容响应,不持久化增删改。接口字段和调用方式见 城银清头寸参数接口说明,当前服务能力以 Scalar 文档 为准。
