# 圣旦POS

**Repository Path**: htsing/pos

## Basic Information

- **Project Name**: 圣旦POS
- **Description**: 新版POS项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-07-08
- **Last Updated**: 2025-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 圣旦POS

#### 介绍
圣旦收银项目

#### 软件架构
##### MVP架构模式
- M层：model实体，通过实现了BaseRepository接口的仓库，向P层提供数据，数据包含网络数据和本地数据（sp、文件、数据库），M层包含全部获取数据的逻辑
- P层：核心业务层，需实现BasePresenter接口（项目中通常继承自抽象类AbsPresenter），P层获取M层和V层的引用，通过接口形式与View层交互，原则上所有业务都在P层处理
- V层：UI处理层，需实现BaseView接口，主要负责实现P层业务处理中UI层变化的回调。原则上V层只负责控制页面逻辑，不负责具体业务处理。

#### 项目目录

```Java

app
 - src/main/java //项目代码目录
    - cn.mumzone.pos
     - api //项目网络请求目录
       - service //各个模块网络请求接口
     - dialog //pos基础dialog样式及逻辑封装
     - event //RxBus 消息传输相关event
     - model //项目实体类目录
       - source //项目Repository
     - presenter //项目Presenter
       - contract //项目Contract
     - ui //项目ui相关类
       - activity //项目Activity
       - adapter //项目Adapter
       - dialog //部分业务Dialog
       - fragment //项目Fragment
       - widgets //封装ui控件
     - util //工具类
     AppConstants //项目常量类
     MyApplication //项目入口
 - src/main/res //项目资源目录
   - drawable //xml相关资源及svg图片资源
   - mipmap-xhdpi //项目图片资源
basic // 顶层封装代码module
 - src/main/java //项目代码目录
  - cn.mumzone.basic
    - adapter //对ListView及RecyclerView的Adapter实现做了进一步封装
    - base //封装了Activity、Fragment的基类
    - dialog //对AlertDialog的进一步封装
    - event //
    - loading //对Loading弹窗和Loading按钮的封装
    - mvp //mvp架构顶层设计
    - net // Retrofit及后端返回数据结构的封装
    - netstatus//网络状态监控工具
    - util //其他工具类
    BaseApplication
 - src/main/res //项目资源目录


build //编译目录

local.properties //配置App签名

settings.gradle // 导入module模块配置文件

```


#### 开发说明

MVP架构使用步骤
1. 在model目录下创建数据实体，并在api->service下，创建相关接口
2. 在model -> source下，创建相关的Repository
3. 在项目contract目录下，定义V和P层的相关接口，可参考项目中LoginContract类的实现
4. 在项目presenter目录下，创建该Presenter，并关联View和Repository
5. 创建View层，关联Presenter，并实现Contract中定义的View层接口


#### 渠道说明

项目分为普通版本和商米版本，不同版本不同环境均互相独立，详见gradle文件中配置的productFlavors

beta：测试环境安装包
pre：预发布环境安装包
pro：正式环境安装包

sunmibeta: 商米测试环境安装包
sunmipre: 商米预发布环境安装包
sunmipro: 商米正式环境安装包


#### 版本说明

每个版本项目上线，都通过git的tag命令，打tag并push到远程，可通过git tag命令查看历史版本

目前git分支情况：
master分支 2.3版本（线上版本）
dev分支 2.4版本相关内容（未上线，放弃上线）
dev2.5分支 2.5版本相关内容（未上线，暂停开发）