# ky_black

**Repository Path**: yanglinjun/ky_black

## Basic Information

- **Project Name**: ky_black
- **Description**: 马总，黑卡系统，高端储值，会员
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-06-09
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 旅游黑卡系统

## 项目概述
旅游黑卡系统是一个高端旅游服务平台，通过会员黑卡的方式为用户提供专属的高端旅游服务体验。系统集成了储值功能、会员管理、景区服务、管家服务等多个模块，为高端客户提供一站式旅游服务解决方案。

## 技术架构
- 后端框架：webman
- 后端模块：plugin/ky_heika
- 前端模块：black_ui

## 核心功能模块

### 1. 黑卡管理系统
#### 1.1 卡片类型
- 机构储值卡
  - 需要预付费
  - 与机构用户绑定
  - 可设置多个子卡
  - 支持大额储值
  - 可用于企业福利/商务接待

- 个人会员卡
  - 与个人用户绑定
  - 记名制
  - 支持消费记录追踪
  - 专属会员权益

#### 1.2 卡片功能
- 储值功能（支持大额储值，如10万元）
- 子卡分配功能
  - 支持将主卡金额分配给多个子卡
  - 子卡额度管理（固定额度/共享额度）
  - 子卡用户绑定
  - 子卡消费限额设置
- 企业账单管理
  - 月度对账单
  - 消费明细统计
  - 开票信息管理

### 2. 会员服务系统
#### 2.1 黑卡会员权益
- 专属私人管家24小时服务
- 高端用车服务（宝马/奔驰专车接送）
- 景区VIP专属通道
- 高端套餐选择（1980/1580等档位）
- 紧急服务优先响应
- 专属定制旅游方案
- 高端酒店优先预订
- 专属休息室使用权

#### 2.2 管家服务
- 专属旅行管家配置
- 行程定制服务
- 24小时在线服务
- 景区接待预约
- 出行计划安排

#### 2.3 紧急服务响应机制
- 7×24小时紧急热线
- 分级响应机制
  - 特急响应（1小时内）：意外事故、紧急医疗
  - 加急响应（2小时内）：行程变更、天气突发
  - 普通响应（4小时内）：一般咨询、服务调整
- 就近管家快速调派
- 紧急医疗绿色通道
- 突发事件应急预案
- 跨区域资源协调
- 紧急备用金支持

### 3. 消费管理系统
#### 3.1 消费方式
- 实体卡刷卡
- 手机号验证消费
- 电子卡支付
- 子卡独立消费

#### 3.2 额度管理
- 主卡总额度管理
- 子卡额度分配
- 共享额度管理
- 消费限额设置

### 4. 商家合作系统
#### 4.1 景区管理
- 合作景区管理
- 景区服务标准
- 景区管家管理
- 服务质量监控

#### 4.2 服务商管理
- 用车服务商
- 餐饮服务商
- 住宿服务商
- 导游服务商

### 5. 运营管理系统
#### 5.1 用户管理
- 会员信息管理
- 权益管理
- 消费记录
- 行为分析

#### 5.2 数据分析
- 消费数据统计
- 服务质量评估
- 会员满意度分析
- 运营报表生成

## 数据库设计（核心表）

### 用户表（user）
- 用户ID (user_id)
- 用户类型 (type) [ENUM: 'personal', 'organization']
- 用户状态 (status)
- 创建时间 (created_at)
- 更新时间 (updated_at)
- 专属管家ID (butler_id)
- 紧急联系人信息 (emergency_contact)

// 个人用户字段
- 姓名 (name)
- 手机号 (phone)
- 身份证号 (id_card)
- 性别 (gender)
- 出生日期 (birthday)
- 邮箱 (email)

// 机构用户字段
- 企业名称 (company_name)
- 营业执照号 (business_license)
- 法人姓名 (legal_representative)
- 企业地址 (company_address)
- 联系电话 (contact_phone)
- 企业邮箱 (company_email)
- 开票信息 (invoice_info)
  - 开票类型
  - 纳税人识别号
  - 开户行
  - 银行账号
  - 开票地址
  - 开票电话

### 黑卡表（black_card）
- 卡号 (card_no)
- 卡片类型 (card_type) [ENUM: 'organization_prepaid', 'personal_member']
- 用户ID (user_id)
- 卡片状态 (status)
- 绑定时间 (bind_time)
- 额度信息 (balance)
- 有效期 (valid_until)
- 是否为主卡 (is_primary)
- 主卡号 (primary_card_no)
- 可用额度 (available_balance)
- 冻结额度 (frozen_balance)
- 累计消费 (total_consumption)

### 企业子卡额度配置表（org_card_quota）
- 配置ID (config_id)
- 主卡号 (primary_card_no)
- 子卡号 (sub_card_no)
- 额度类型 (quota_type) [ENUM: 'fixed', 'shared']
- 固定额度值 (fixed_amount)
- 共享额度上限 (shared_limit)
- 每次消费上限 (single_consumption_limit)
- 月度消费上限 (monthly_consumption_limit)
- 创建时间 (created_at)
- 更新时间 (updated_at)

### 交易记录表（transaction）
- 交易ID
- 卡号
- 交易金额
- 交易类型
- 交易时间
- 交易地点

### 管家信息表（butler）
- 管家ID
- 所属景区
- 联系方式
- 服务评分
- 服务记录

### 景区信息表（scenic_spot）
- 景区ID
- 景区名称
- 服务等级
- 合作状态
- 服务项目

### 紧急服务记录表（emergency_service）
- 服务ID
- 会员ID
- 紧急类型
- 发生时间
- 响应时间
- 处理状态
- 处理方案
- 跟进记录
- 服务评价

## 接口设计规范
所有接口遵循RESTful API设计规范，具体接口文档将在后续开发中补充。

## 安全设计
- 支持数据加密传输
- 敏感信息脱敏处理
- 完整的操作日志记录
- 多级权限控制
- 交易安全保障机制

## 部署要求
- PHP >= 7.4
- MySQL >= 5.7
- Redis >= 6.0
- Nginx/Apache

## 开发规范
1. 代码规范遵循PSR-4自动加载规范
2. 后端代码统一放置在plugin/ky_heika目录
3. 前端代码统一放置在black_ui目录
4. 遵循模块化开发原则
5. 必须编写单元测试
6. 代码提交前必须经过代码审查