# company

**Repository Path**: liuning-peace/company

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-29
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 偶町 ONE TOWN 全场景积分生态平台

> 娱乐赚积分,积分抵房租。短剧引流 → 看剧/消费产生积分 → 积分抵扣房租/商城/本地生活 → 分享裂变。
> 按《软件开发协议》及全套设计方案(2-9号文档)实现,**五端架构**。

## 项目结构(五端 + 后端)

```
G:\company\
├── server\    后端 API(Node.js + Koa2 + Sequelize + MySQL + Redis),64张表
├── mini\      ①C端用户应用(uni-app Vue3 → H5 + 微信小程序),24页
├── merchant\  ②商家端后台(Vue3 + Element Plus):商品/服务/房源/核销/订单/结算
├── provider\  ③渠道端后台(Vue3 + Element Plus):区域数据隔离看板/团队/收益/提现
├── admin\     ④平台总管理后台(Vue3 + Element Plus):全局管控+审核+财务
├── screen\    ⑤大屏监控端(Vue3 + ECharts 深色全屏):一屏观全域
├── env\       本地环境(MySQL数据 / Redis / 安装包)
├── docs\      设计文档对照、上线路线图、Nginx配置
└── scripts\   一键启动脚本
```

## 一键启动

双击 `G:\company\scripts\start-dev.bat`(自动开 7 个窗口),或分别启动:

| 端 | 地址 | 演示账号 |
|---|---|---|
| 运营后台 | http://localhost:5173 | admin / admin123(超管)、kefu / kefu123(客服) |
| C端H5 | http://localhost:5174 | 手机验证码登录,dev 万能码 888888 |
| 商家端 | http://localhost:5175 | 13900000001 / shop123(商城)、13900000002 / shop123(本地生活) |
| 渠道端 | http://localhost:5176 | 13800000001 + 短信验证码(dev 显示在响应/页面提示) |
| 大屏 | http://localhost:5177 | admin / admin123 |
| 小程序 | 微信开发者工具导入 `mini\dist\dev\mp-weixin` | AppID 选测试号,勾选"不校验合法域名" |
| 后端API | http://127.0.0.1:3000 | — |

测试用户链:13800000001(A,精英推荐官+深圳市级服务商)→ 13800000002(B,A的直推,待付房租账单)→ 13800000003(C,B的直推)。

## 常用命令(server 目录)

```
npm run init-db     首次建库(58表)
npm run migrate     增量迁移(幂等,已执行版本记录在 _migrations 表)
npm run seed        基础种子(-- --force 强制重建)
npm run seed:v2     v2种子(区域/等级制度/演示商家/渠道商)
npm run dev         开发模式启动(3000)
```

## 文档索引

- `docs/上线指南与路线图.md` —— 上线节奏、资质清单、待接入项、**分销合规提示(必读)**
- `docs/小程序上线部署教程.md` —— 从零到发布小程序的分步教程(怎么做/为什么/流程图/避坑/验收清单)
- `docs/数据库表名对照.md` —— 设计文档表名 ↔ 实际表名对照(验收用)
- `docs/订单评价与角标说明.md` —— 订单评价(先审后展)+「我的」页角标口径(待评价/新完成未读怎么清零)
- `docs/商家通知与自动刷新说明.md` —— 支付成功/申请退款如何通知商家与买家、商家端订单页 20s 自动发现新单
- `docs/消息中心与未读角标说明.md` —— C 端消息中心未读角标口径(进页即清)、已读接口 `all/ids` 契约、用户卡图标修复
- `docs/退款审核说明.md` —— 退款/放款口径(商家先审+平台兜底、超时自动流转、微信原路退铁律)
- `docs/售后与退货说明.md` —— 售后与退货全流程(仅退款/退货退款、寄回与验收、平台介入、三端接口与界面)
- `docs/商品多规格说明.md` —— 商品多规格(SKU):规格定义/SKU 图与编码/下单只认 SKU/库存回滚/导入导出
- `docs/nginx.conf.example` —— 生产部署 Nginx 参考

## 上线前必做

微信支付 / 阿里云短信 / OSS / 域名备案 / 更换 JWT 与 AES 密钥 —— 详见上线路线图。