# beauty-pos

**Repository Path**: nuolo/beauty-pos

## Basic Information

- **Project Name**: beauty-pos
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 美业收银

一套基于 `Vue 3 + TypeScript + Electron` 的美业门店收银与经营管理系统，适合美容院、美睫美甲、皮肤管理等门店场景使用。

项目已经把收银、预约、会员、次卡、员工、报表、库存和基础设置串成了一个完整闭环，支持单店直接使用，也方便二次开发成多门店版本。

## 主要功能

- 收银工作台
- 预约管理
- 订单记录与今日流水
- 会员管理、充值、积分、次卡
- 员工管理与业绩查看
- 商品管理与库存预警
- 套餐管理
- 报表中心
- 系统设置
  - 系统名称
  - 门店名称
  - 积分规则
  - 营业时间
  - 支付方式
  - 备注模板

## 技术栈

- Vue 3
- TypeScript
- Electron
- Pinia
- Vue Router
- Element Plus
- better-sqlite3

## 快速开始

### 环境要求

- Node.js 18+
- npm 9+
- Windows / macOS / Linux

### 安装依赖

```bash
npm install
```

### 开发运行

```bash
npm run dev
```

### 打包构建

```bash
npm run build
```

### 生成安装包

```bash
npm run dist
```

## 默认账号

首次启动会自动创建默认管理员账号：

- 用户名：`admin`
- 密码：`admin123`

建议首次登录后立即修改密码。

## 默认配置

项目首次启动时会写入一组默认系统信息：

- 系统名称：`美业收银`
- 门店名称：`示例门店`

这些信息可以在 `设置` 页面里修改，并会同步显示在：

- 登录页
- 顶部栏
- Electron 窗口标题

## 项目结构

- `src/`：前端页面、组件、状态管理、API 封装
- `electron/`：主进程、数据库、IPC 逻辑
- `public/`：静态资源

## 数据说明

项目使用本地 SQLite 数据库存储业务数据，适合单机部署或门店内局域网使用。

如需做多店、云同步或远程备份，建议基于现有数据库层继续扩展。

## 开源协议

本项目采用 [MIT License](./LICENSE) 开源协议。

你可以自由使用、修改、分发本项目，但请保留原始许可证声明。

## 贡献方式

欢迎通过 `Issue` 和 `Pull Request` 一起完善这个项目。

如果你准备做二次开发，建议优先关注这几个方向：

1. 品牌信息配置统一
2. 报表口径统一
3. 员工、预约、收银流程联动
4. 会员生命周期运营

## 说明

本项目为开源项目，适合门店自用和二次开发。
如果你在生产环境中使用，请结合自身业务流程进一步做权限、审计、备份和数据安全加固。