# james-cashier

**Repository Path**: jamesying/james-cashier

## Basic Information

- **Project Name**: james-cashier
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 门店收银系统

面向**预付费服务门店**（美发、美容、健身、足浴、洗车等）的轻量收银系统，以 **会员 + 充值卡（储值卡）** 为核心，消费使用卡内余额，**资金流水闭环可对账**。

## 核心亮点

- 💳 **会员 + 充值卡**：开卡、充值（线下收款后手动入账）、挂失、冻结
- 💰 **资金流水闭环**：充值/消费/退款/赠送/调账每笔都有完整流水，余额由流水推导，不可篡改、可对账、支持日结
- 📱 **扫码收银**：客户出示动态会员码，商家扫码核验后扣款（防截图盗用）；客户扫门店码直接进入小程序
- 🧩 **三端完整**：PC 后台 + 商家小程序 + 客户小程序（两个独立小程序）
- ✨ **界面简约**，业务逻辑完整

## 技术栈

| 端 | 技术 |
|---|---|
| 后端接口 | ASP.NET Core 8 + EF Core 8 + Serilog + JWT（基于"最简后台"框架扩展） |
| 数据库 | SQLite（默认，可切换 MySQL） |
| PC 后台 | Vue 3 + Vite + Element Plus + Pinia + axios |
| 商家小程序 | 微信小程序（原生 / Taro） |
| 客户小程序 | 微信小程序（原生 / Taro） |

> 说明：本项目在 [最简后台 (ZJAdmin)](../最简后台/) 基础上扩展业务模块，复用其用户/角色/权限/操作日志/系统配置能力。

## 目录结构

```
cashier/
├── README.md                    # 项目说明（本文件）
├── docs/                        # 设计文档
│   ├── 收银系统产品需求文档(PRD).md
│   ├── 收银系统技术设计文档.md
│   └── 收银系统开发计划.md
├── change_logs/                 # 变更记录（CLAUDE.md 规范：日期-主题.md）
├── server/                      # 后端 API（ASP.NET Core 8，ZJAdmin 扩展）
├── admin/                       # PC 后台（Vue3 + Element Plus）
├── merchant-miniapp/            # 商家收银小程序
└── customer-miniapp/            # 客户会员小程序
```

> 注：`server/`、`admin/`、`merchant-miniapp/`、`customer-miniapp/` 为后续开发目录，当前尚未创建。

## 本地启动（后续开发完成后）

### 后端接口

```bash
cd server
dotnet restore
dotnet run
# 默认监听 https://localhost:7001，API 前缀 /api/v1
```

### PC 后台

```bash
cd admin
npm install
npm run dev
# 默认 http://localhost:5173
```

### 小程序端

用微信开发者工具分别导入 `merchant-miniapp/`、`customer-miniapp/`，填入各自的 AppID 后编译预览。

## 环境配置

- 数据库连接串：`server/appsettings.json` 中配置 SQLite（默认）或 MySQL
- 小程序 AppID / AppSecret：`server/appsettings.json` 中配置，用于微信登录（openid 换取）
- 会员码签名密钥：`appsettings.json` 中配置 `MemberCode:Secret`（HMAC 签名用）

## 文档索引

| 文档 | 说明 |
|---|---|
| [PRD 产品需求文档](docs/收银系统产品需求文档(PRD).md) | 产品定位、功能需求、验收标准 |
| [技术设计文档](docs/收银系统技术设计文档.md) | 架构、数据库、资金流水、扫码方案、接口设计 |
| [开发计划](docs/收银系统开发计划.md) | 分阶段开发计划、里程碑、验收 |

## 状态

- [x] 设计文档（2026-08-12）
- [ ] 开发中