flutter 插件

Flutter Secure Storage DevTools

购物车添加数量增减区域，每个购物车项都要有，至于怎样展示使用 ui-ux-pro-max 设计一下

/store/cart/change

参数

{
    // 购物车id
    "id": 561,
        // 产品数量
    "product_num": 3
}

详情页加购逻辑

在详情页点击加购按钮之后
如果站点信息中：productAddcartSpace 值为1的时候加购前要弹出一个输入框必填，输入space字段，然后点击确定进行加购，这个字段必填，然后要有取消按钮
如果等于0的话则，不需要弹这个输入框：space字段默认传入default字符串

/store/cart/create

请求类型post

参数

{
    "product_id": 64521,
    // 是最后筛选中 product.product_sub里的index字段
    "sub_index": "a0",
    "product_num": 1,
    "space": "defalut",
        // 是当前选中的product_sub的 name + spec-value中选中的options name
    "sub_name": "H17*W37.2*L1000,Aluminum,Black",
}

扩展，不止商品详情页有加购，产品列表也有加购

产品列表加购逻辑

点击加购按钮
根据产品id获取产品详情数据
展示sku数据，sku改变的逻辑，和加购的逻辑，和详情一摸一样，展示的数据也一样，只不过多了展示mainImage主图
只不过数据会展示到一个抽屉中在右侧弹出
最后会有一个确认按钮，点击之后就和详情的加购逻辑一样了也会有空间等。。。
调用的接口也是一样的

购物车修改

也会在侧边弹出，样式和展示的数据，和产品列表加购的抽屉一样只不过接口换了
接口/store/cart/changeSpec
post请求

参数

{
    "id": 613,
    "product_id": 117278,
        //     // 是最后筛选中 product.product_sub里的index字段
    "sub_index": "a0",
     "space": 'defalut'
        // 是当前选中的product_sub的name + spec-value中选中的options name
    "sub_name": "L1730*W930*H880,Artificial leather+sponge+Pine wood+stainless steel",
}

我放在一起说的原因是，我希望你能自己设计实现方案，决定逻辑的复用性，因为逻辑都一样，只是调用接口不用，然后就是侧边抽屉展示详情信息这个抽屉看看是否考虑做成公共组件

product_sku_cart_helpers.dart product_sku_resolver.dart

切换站点需求

在Another settings 同行右侧添加一个切换站点的icon botton，点击之后切换底部弹出切换站点列表

站点列表接口/store/company 不需要认证

不需要dto,直接使用map就行

{
    "code": 0,
    "message": "ok",
    "type": "success",
    "result": {
        "items": [
            {
                "id": 27,
                "title": "家具二部自建渠道"
            },
            {
                "id": 26,
                "title": "创客演示站"
            },
            {
                "id": 25,
                "title": "官方子站点"
            },

        ],
        "total": 12
    }
}

切换站点接口：/store/user/switchShop 需要认证
- 参数
```
{
    // 选中的id
    "company_id": 7,
        // 选中的id
    "shop_id": 7,
        // 固定5
    "terminal": 5
}
```
- 响应数据，和userBaseInfo相同的数据，统一更新到userBaseInfo
- 更新tokenMap, 还有companyId,
- 更新companyId之后要统一更新站点信息

当前需求，controllers service api都要加详情注释，还有参数注释

My Customers 需求

user_base_info中有个字段isAuthAccount，表示这个用户是否是业务员

是业务员的情况下profile中才会有这个菜单

接口：/store/account/customer?status=&page=1&page_size=20&keyword=&company_id=7

请求方式：get 需要认证

要求：是个列表下拉刷新和滚动加载，有新增，修改，删除，登录操作

response 结构, 创建对应的dto

{
    "code": 0,
    "message": "ok",
    "type": "success",
    "result": {
        "items": [
            {
                "id": 601,
                "username": "17614764200",
                "telephone": "11122233355",
                "email": "",
                "created_at": "2026-04-17 20:51:34",
                "name": "藏三",
                "avatar": null,
                "company_id": 26,
                "user_main_id": 323
            }
        ],
        "total": 1
    }
}

操作

修改用户：点击修改底部弹出输入框，是个表单下面带注释的字段就是表单的内容

接口： /store/account/customerUpdate

请求类型：post，需要认证

参数：

{
    // 表单label: Username or Email
    "username": "17614764200",
    // 表单label: Password
    "password": "123456",
    // 表单label: name
    "name": "藏三",
  // 表单label: phone
    "telephone": "11122233355",
    "id": 601,
    "terminal": 5
}

校验： username 和 password 是必填的，都不能低于6个字符，点击Done，请求成功后提示成功

删除操作：点击删除按钮，弹出提示框，进行删除

接口： /account/customerDelete

请求类型：post 需要认证

参数：

{
    "company_id": 7,
    "id": 601
}

新增操作：点击新增底部弹出输入框,是个表单下面带注释的字段就是表单的内容

接口： /store/account/customerCreate

请求类型：post 需要认证

校验：同修改弹窗一致，点击Done，请求成功后提示成功

参数：

{
    // 表单label: Username or Email
    "username": "17614764200",
    // 表单label: Password
    "password": "123456",
    // 表单label: name
    "name": "藏三",
  // 表单label: phone
    "telephone": "11122233355",
    "terminal": 5
}

My Customers登录操作

接口：/store/account/customerLogin

请求方式：post 需要认证

操作：点击登录按钮调用这个接口注意要有loading

请求参数：

{
    // 要传入id
    "id": 610,
    "terminal": 5
}

response 结构：同user_base_info 字段一致，可以使用相同dto

{
    "code": 0,
    "message": "ok",
    "type": "success",
    "result": {
        "id": 610,
        "account_id": 1507,
        "name": "用户176147642011",
        "username": "176147642011",
        "company_id": 7,
        "avatar": null,
        "telephone": "",
        "description": null,
        "status": 1,
        "type": 0,
        "updated_at": "2026-04-19 10:14:48",
        "created_at": "2026-04-19 10:14:48",
        "deleted_at": null,
        "register_from": 5,
        "language_id": 1,
        "tourist": 0,
        "email": "",
        "nickname": "",
        "wechat": "",
        "customer_id": 0,
        "last_order_time": 0,
        "user_main_id": 331,
        "shop_id": 0,
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3NzY1NjU1NzQsIm5iZiI6MTc3NjU2NTU3NCwiZXhwIjoxNzkyMTE3NTc0LCJyY29kZSI6MzgwNDQ0LCJ1aWQiOjYxMCwicGFyYW1zIjo1fQ.aWcFgmyYLiM-kNQ3itPQcYAl70rHBQYek_ao2V0_z9s",
        "is_auth_account": false
    }
}

登录前要保留当前用户的user_base_info，持久化一份，可以叫做 main_user_info
将接口响应更新到当前用户信息中，包括token, company_id 登录成功
注意：这个时候更新user_base_info 信息了，我前面说过user_base_info中有个字段isAuthAccount，表示这个用户是否是业务员是业务员的情况下profile中才会有这个菜单，你要注意不要影响我现在的逻辑
成功登录之后 settings 判断有没有main_user_info信息，有的话才会展示 switch Account 区域，否则只有一个logout 区域
点击switch Account之后会切换回到主用户，逻辑就是在将main_user_info替换回来，到当前用户信息中，包括token, company_id
然后清空main_user_info，切换完成！

退出登录逻辑

接口：/store/user/logout

请求类型：post 使用protectedDioClient 实例需要认证注释有问题就改注释

操作：点击settings-> sign out之后按钮loading之后响应成功注意！！！退出之后如果还有接口发送请求那就你代码写的逻辑有很大的问题，开始清除个人信息，站点信息，token, companyId，购物车信息，main_user_info，等。。,清理完最后跳到登录页面

购物车数量

接口：/store/cart/num

请求类型：get 使用protectedDioClient 实例

响应数据

{
    "code": 0,
    "message": "ok",
    "type": "success",
    "result": {
        "total_num": 11
    }
}

将结果：total_num 展示到 settings 中的 CART NUM 上面的24 value值

Set Common Password 按钮逻辑

点击弹出 showStoreCustomerFormBottomSheet 也是个表单但是只有密码字段

接口： /store/account/customerResetPwd

BottomSheet 标题：Set Common Password 要求修改/customer 的 showStoreCustomerFormBottomSheet 样式一致

点击完成按钮发送请求

请求方式：post 使用protectedDioClient 实例

参数：

{
    // Password
    "password": "123456"
}

My customers 是点击login才会去切换用户，点击行是我要查看当前用户订单

请求类型：get 使用protectedDioClient 实例

使用接口和当前用户列表一样 /store/account/customerOrderList，

{ status: , page: 1, page_size: 20, keyword: , // 相比多了这个参数 user_id: 608 with_batch_order: 1, all_shop: 1, 610 }

返回的数据格式同用户订单列表(就是Order Center 内容区域的Customer选中时候展示的列表) 可以抽取复用组件，一样也可以使用相同的dto ProductOrderListDto

操作和交互：

当点击My Customer用户列表的时候可以让当前行loading，成功响应数据之后，订单内容从右边划出，然后当前的 My Customers 列表隐藏。
My Customer 内容区域展示的是用户订单列表(就是Order Center 内容区域的Customer选中时候展示的列表)时，手指向右滑动，用户订单列表(就是Order Center 内容区域的Customer选中时候展示的列表)会划出隐藏，最后会重新展示My Customers内容区域
订单列表进入时候，用户列表要有慢慢隐藏的动画效果，回显的效果同样

最后注意此操作不允许修改现在有的样式

退出没登录旧提示没有token

请先为账号开通权限

“缓存”仅限于当前内存中的 provider state（页面不销毁时还在），不是落盘缓存。

如果你希望“下拉刷新先秒开缓存，再后台拉新”，我可以帮你改成 SWR 风格（先显示本地快照 + 静默更新 + 失败保留旧数据）。

SWR（Stale-While-Revalidate）可以理解成：先用“可能旧但可用”的数据立即渲染，再在后台悄悄请求最新数据，回来后自动刷新 UI。你现在订单列表是“下拉就直接打接口”，SWR 会把体验改成“先快，再准”。

注册逻辑

接口：/store/user/register

请求类型： post请求使用 publicDioClient实例

参数：{ “terminal”: 5, “username”: “17614764201”, “password”: “123456”, “passwordConfirm”: “123456” }

密码的校验规则：

password：必填，不少于6位密码

passwordConfirm：必填，不少于6位密码, 要和password输入一致

username：必填

响应：

错误格式：{ “code”: 100000, “message”: “The username already exists”, “type”: “error” }

成功格式：{ “code”: 0, “message”: “ok”, “type”: “success”, “result”: { “company_id”: 26, “account_id”: 785, “register_from”: 3, “username”: “17614764209”, “type”: 0, “tourist”: 0, “name”: “用户17614764209”, “telephone”: "", “email”: "", “user_main_id”: 349, “updated_at”: “2026-04-22 14:01:38”, “created_at”: “2026-04-22 14:01:38”, “id”: 639, “token”: “eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE3NzY4Mzc2OTgsIm5iZiI6MTc3NjgzNzY5OCwiZXhwIjoxNzkyMzg5Njk4LCJyY29kZSI6NDk4MjM1LCJ1aWQiOjYzOSwicGFyYW1zIjozfQ.Qy5h5_iQP4M_gaXbS_3gY5G_hhRLbNCOIlOaEIpe9CA”, “is_auth_account”: false } }

创建成功回返回结果，和/store/user/login 成功结果数据格式一样，创建成功之后直接登录

报价单逻辑

接口：/store/cart/exportQuotation

请求类型：post 使用protectedDioClient 请求实例

请求参数：就是刚刚的map

错误响应格式

{ “code”: 5500, “message”: “服务器出现了不可遇见的bug”, “type”: “error”, “errMsg”: [ “Merge must be on a valid range of cells.” ] }

成功响应格式

是一个流，要导出excel报价单，文件名可以叫quotation_+时间戳

完成按钮右侧要有一个preview按钮，点击调用同样的接口，参数还是map, 但是会多加一个参数就是response_type：1，

然后响应格式就是

{

“code”: 0,

“message”: “ok”,

“type”: “success”,

“result”: “https://img.gbuilderchina.com/store/quotation/20260422/177727243969e8b9c32c6a0043976657.xlsx”

}

result 是一个excel 的链接会重新拼成下面的链接

https://view.officeapps.live.com/op/view.aspx?src=+result,

拼好之后就是excel的预览链接，我希望在当前页面预览这个url，然后最上面有一个关闭按钮点击之后可以关闭预览

打开报价单导出弹窗逻辑

点击购物车中导出按钮之后会先请求一个接口，loading可以放到导出按钮上

请求接口：/store/quotationConfig

请求方式：get请求使用protectedDioClient 请求实例

响应数据：

{ “code”: 0, “message”: “ok”, “type”: “success”, “result”: { “formData”: [ { “field”: “depositratio”, “default”: 30, “type”: “number”, “title”: “定金比例”, “required”: true,

}, { “field”: “currency”, “default”: ”$”, “type”: “select”, “options”: { ”$”: “USD”, ”¥”: “RMB”, ”€”: “EUR”, ”£”: “GBP”, “HK$”: “HKD”, “A$”: “AUD” }, “title”: “币种”, “required”: true,

}, { “field”: “exchange_rate”, “default”: 1, “type”: “number”, “title”: “汇率”, “required”: true,
}, { “field”: “888”, “type”: “text”, “title”: “888”,
} ] } }

type 的类型只有3个 text: 对应文本输入， number: 对应类似购物车加减数量组件，select对应下拉组件

options 属性，key 是下拉label，value是收录的值

然后会弹出一个sheet,同用户列表编辑弹出的sheet, 然后使用上面的formData 的数据开始渲染表单，点击完成的时候将返回一个map格式就是{field: 输入的值}

样式和交互方式统一使用用户列表的编辑弹窗看看是否能复用

购物车export按钮上面加一个Pre Order的按钮，样式同export 一样,
点击之后会跳到预订单页面(新增页面)
调用的接口还是 requestCartListBySite，但是smStatus传1，
要有返回按钮这个按钮可以参考详情页的样式，有列表
列表展示和购物车一样，但是右侧的价格区域放到底部，价格和按钮都放到同一排
当前预订单页面和详情页面一样不展示底部菜单栏

将购物车页面的go to Checout 按钮移动到

商城+选品助手 升级架构： 暂定5月1日前完成

Pre Submit Order 按钮

点击之后, 先校验选中订单的当前部门有没有选择sm，发送请求

点击 pre submit order ,发送请求

/store/cart/setSm

请求方式 post 使用protectedDioClient 请求实例

参数

{

“data”: [

// 这个是个集合，应为有可能选中多个sm

{

// 这里是购物车列表请求响应中的第一级的id就是和sm_id 同一级别的id, 然后响应成功之后跳转到预订单页面

“shop_department_id”: 39,

// 这就是购物车列表中下拉选中的的id

“sm_id”: 72,

“cart ids”: [] 这里多加一个参数，就是当前部门下面选中的购物车id

}

]

}

quantity_adjust_icon_button_widget.dart 修改为 george_quantity_control

quantity_adjust_icon_button_widget.dart

mall_outlined_cta_button_widget.dart 改成 george_outlined_button
mall_filled_cta_button_widget.dart改成 george_filled_button
back_nav_filled_button_widget.dart改成 george_back_button
small_check_square_checkbox_widget.dart 改成 george_checkbox_button



mall_confirm_dialog_panel.dart  改成 george_confirm_dialog_panel
mall_dialog.dart  改成 george_dialog
mall_dialog_anim.dart  改成 george_dialog_anim
mall_dialog_surface.dart 改成 george_dialog_surface
show_mall_confirm_dialog.dart 改成 show_george_confirm_dialog
show_mall_session_expired_dialog.dart 改成 show_george_session_expired_dialog
show_mall_text_field_dialog.dart 改成 show_george_input_dialog
同样组件名字改成文件名大驼峰

购物车修改备注，这个逻辑和预定单页面是一致的

接口： /store/cart/remark

请求方式 post 使用protectedDioClient 请求实例

错误响应格式：

{

“code”: 100000,

“message”: “数据不存在”,

“type”: “error”

}

参数

id：购物id

remark: 就是输入框输入的指