yicangzongtai_app_240321

#项目说明

1.项目设计图原型及代码

后台管理原型 https://hbo9jb.axshare.com/ 后台管理代码 https://47.104.208.8/svn/songlanyun/lida/admin

app代码 https://47.104.208.8/svn/songlanyun/lida/app app设计图 https://app.mockplus.cn/app/c8JlYe8ge/design app原型 https://org.modao.cc/app/09f1570446780fedf05a929fd58392529b2cdee8#screen=ski4b5zasy253ky

小程序代码 https://47.104.208.8/svn/songlanyun/lida/wx 小程序设计图 https://app.mockplus.cn/app/Roq5I5QfkO/design

接口文档 http://api.songlanyun.com/project/36/interface/api

2.功能模块划分

小程序有的功能App 都有，大致包含

1 普通商品订单模块 2 钱包模块 3 分销模块

##### app多的功能包含 1 服务模块（服务商品，服务订单）， 2 积分模块（积分商品，积分订单）， 3 消息模块， 4 网红模块， 5 文章/作品/素材

项目结构

目录大致结构

├─api   ----api接口位置
├─common 
│  ├─request ----http请求入口
│  └─style ------公共样式 图标
├─components----- 公共组件
├─config   ------基础配置 接口请求地址和缺省图
├─directives ----指令
├─node_modules 
├─pages ---------页面文件
│  ├─index-------入口tabbar的文件目录
│  ├─order-------订单模块
│  │  ├─gbOrder----团订单
│  │  └─orderList--普通订单
│  ├─pointsMall
│  ├─product
│  │  ├─goods
│  │  ├─search
│  │  └─surePay
│  ├─public
│  ├─research
│  │  ├─business
│  │  ├─community
│  │  ├─homepage
│  │  ├─nearby
│  │  ├─recommend
│  │  ├─register
│  │  └─setup
│  └─user
│      ├─address
│      ├─bankCard
│      ├─distribution
│      ├─invitationCode
│      ├─merchant
│      ├─shop
│      └─wallet
├─static----------静态资源图片
│  ├─delImg
│  ├─index
│  ├─login
│  └─sharemenu
├─store-----------vuex
└─ld.keystore-----安卓打包的文件

其他说明

api:项目中所有api（这块根据项目情况，大小进行细分）

basic.js:里面放一些公共api,字典项...
login.js:注册，登录，授权...，所用的api
product.js:所有商品相关联的api
userInfo.js:用户信息，设置，修改资料等。。。
share.js 微信，朋友圈分享

common:项目公共js，css文件

request：请求封装js
style：公共样式
graceChecker.js：表单验证js
html-parser.js：富文本转换
util.js：全局封装的常用的js方法

components：组件 ）公用

config：全局配置文件

assets.config.js：静态图片配置文件
formRule.config.js ：全局表单验证，配置规则以及提示
global.config.js：全局常量，url，apiurl，版本号等信息配置

pages：页面文件

index：入口tabbar的文件目录
order：订单分包文件目录
product：产品分包文件目录
user：用户分包文件目录
public：公共复用的页面目录

static：静态图片，icon （里面如果图片过多，可以细分目录）

delImg：布局时引用的产品，banner，avatar等 上线需要删除的图
uni.ttf：icon文件

store：vuex文件

pages：页面路由配置

如果当前板块页面功能不多的情况下，没有必要单独分包

分包规则：根据项目大小情况来定，有需要分包的，在package.json 里面subPackages数组添加路由在pages里面单独新建分包文件夹，

关于安卓打包

安卓的证书文件已经生成，在项目的根目录里面，如果打正式的包，需要在manifest.json基础灭之里面，把应用版本名称和应用版本号修改一下，必须高于上一次设置的值，打包完成之后上传到后台管理系统，app每次重启时会自动提示需要更新版本

安卓云打包

安卓包名 com.songlanyun.ld 证书别名 ld 证书密钥 sly2020 证书文件在项目的根目录里面

pay_status/payment_status /**

     * 0未支付 1支付成功，但业务发生异常需要发起退款 2支付成功，但业务发生异常自款成功 3支付成功，但业务发生异常退款失败 4支付失败 5已支付(已支付成功)
     */
    NO_PAY(0, "未支付"),

    /**
     * 支付成功，但业务发生异常需要发起退款
     */
    SUCCESS_BUSINESS_ERROR_LAUNCH_REFUND(1, "支付成功，但业务发生异常需要发起退款"),
    /**
     * 支付成功，但业务发生异常自款成功
     */
    SUCCESS_BUSINESS_ERROR_REFUND_SUCCESS(2, "支付成功，但业务发生异常退款成功"),
    /**
     * 支付成功，但业务发生异常退款失败
     */
    SUCCESS_BUSINESS_ERROR_REFUND_FAIL(3, "支付成功，但业务发生异常退款失败"),
    /**
     * 支付失败
     */
    FAIL(4, "支付失败"),

    /**
     * 已支付(已支付成功)
     */
    SUCCESS(5, "已支付(已支付成功)"),
    /**
     * 支付过期
     */
    EXPIRE(6, "支付过期");

芦波 8-16 14:14:30 /**

 * 订单关闭原因
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum CloseMode implements IntegerEnum<Integer> {

    //未关闭
    NO(0, "未关闭"),

    //用户撤销关闭
    USER_CANCEL(1, "用户撤销关闭"),

    //商家撤销关闭
    BUSINESS_CANCEL(2, "商家撤销关闭"),

    //支付过期关闭
    PAY_EXPIRE(3, "支付过期关闭"),

    //退款成功信息
    REFUND_SUCCESS(4, "退款成功"),

    //支付成功,但条件已经不允许购买,发生自动退款关闭
    PAY_SUCCESS_CONDITION_REFUND(5, "支付成功,但条件已经不允许购买,发生自动退款关闭"),
    //自提过期
    PICKUP_EXPIRE(6, "自提过期");

芦波 8-16 14:14:46 @JsonFormat(shape = JsonFormat.Shape.OBJECT)

public static enum TransactionStatus implements IntegerEnum<Integer> {
    //已下单,待支付
    WAIT_PAYMENT(0, "已下单,待支付"),

    //待发货（待备货）
    WAIT_SHIP(1, "待发货（待备货"),

    //只有子订单才有部分发货（部分备货）（1、至少一个子订单待收货（已发货），同时存在待发货的其它子订单）
    //当一个子订单未发货，同时另外的子订单或包裹已收货时 主订单状态还是部分发货
    PART_SHIP(2, "部分发货"),

    //待收货（待自提）
    // 1、所有子订单都是待收货主订单才算待收货
    // 2、至少一个子订单待收货，其它子订单为交易关闭，也算待收货，否则为部分发货）
    WAIT_RECEIPT(3, "待收货（待自提（自提订单）,待使用（服务订单））"),

    //只有子订单才有部分收货(1、至少一个子订单交易完成,同时其它子订单还是待收货或PART_RECEIPT)
    PART_RECEIPT(4, "部分收货（待使用（服务订单））"),

    //交易完成（1、所有子订单关易交易完成才算完成，2、至少一个子订单交易完成，其它子订单为交易关闭或进入退货状态，才交易完成）
    COMPLETE(5, "交易完成"),

    //交易关闭
    // 1、所有子订单交易关闭才算关闭
    // 2、支付后订单退款完成
    // 3、下单后用户取消订单
    CLOSE(6, "交易关闭");

芦波 8-16 14:15:11 /**

 * 0未发货，1部分发货，2已发货
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum ShipStatus implements IntegerEnum<Integer> {

    /**
     * 未发货(未备货)
     */
    NO_SHIP(0, "未发货(未备货)"),
    /**
     * 部分已发货（部分已备货）
     */
    PART_SHIP(1, "部分已发货（部分已备货）"),
    /**
     * 已发货（已完成备货）
     */
    ALREADY_SHIP(2, "已发货（已完成备货）");

芦波 8-16 14:15:37

/**
 * 0，未收货，1部分收货，2已收货
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum ReceiptStatus implements IntegerEnum<Integer> {

    NO(0, "未收货"),

    PART(1, "部分已收货"),

    COMPLETE(2, "已收货");

芦波 8-16 14:15:49 /**

 * 0用户未评，1用户部分已评，2全部已评
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum CommentStatus implements IntegerEnum<Integer> {

    NO(0, "用户未评"),

    PART(1, "部分收货"),

    COMPLETE(2, "全部已评");

芦波 8-16 14:16:04 /**

 * 订单的维权状态（0没有，1维权中，2完成,3失败）
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum RightsStatus implements IntegerEnum<Integer> {

    NO(0, "没有"),

    BEING(1, "维权中"),

    COMPLETE(2, "完成"),

    FAIL(3, "失败");


            * 出货方式（0物流，1自提，2预约）
 */
@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public static enum ShipmentMode implements IntegerEnum<Integer> {
    EXPRESS(0, "快递"),
    PICK_UP(1, "自提"),
    APPOINTMENT(2, "预约");

团详情： 0建团中（店长还没有支付），1建团成功，成团中（店长支付完成），2组团完成，3建团失败（店长未支付）4组团失败（时间到了人员不足）

##不能加入购物车的商品
1、积分兑换商品 2、免费领商品 3、服务礼包商品

area_feature（商品详情属性）

GENERAL(0,"普通商品"),

GIFT_BAG(1, "服务体系礼包"),
NEWCOMER_WELFARE(2, "新人惠选区"),
PUBLIC_WELFARE(3, "公益申领"),

service_package_area（“服务体系礼包”的商品详情属性）

MAKER(1, "创客"), COMMUNITY(2, "爱心小屋"), STREET(3, "服务驿站"), AREA(4, "服务中心"), CITY(5, "市级"), PROVINCE(6, "省级公司"), MUL_PROVINCE(7, "大区公司"),

service_package_area: 【7】 可选择多个省，精确到省。 【6】 仅可选择1个省，精确到省。 【5】 仅可选择1个市，精确到市。 【4】 仅可选择1个区，精确到区。 【3】 仅可选择1个街道，精确到街道。 【2】 仅可选择1个社区，精确到社区。 【1】 正常购买。