# luye-app-cargo

**Repository Path**: jluj/luye-app-cargo

## Basic Information

- **Project Name**: luye-app-cargo
- **Description**: 开工啦-货主小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开工啦货主端（luye-app-cargo）

开工啦「找活」功能的**甲方 / 货主发布端**（uni-app-x，支持 H5 / 微信小程序 / Android / iOS）。货主在手机上发布工程、运输、租赁需求，自动进入开工啦「找活」频道，被周边车队 / 司机浏览并接活。

> ⚠️ 本仓库早期曾误做成「乙方找活浏览端」，并已纠正为**货主发布端**。

---

## 一、产品定位

| 项 | 说明 |
|---|---|
| 目标用户 | 工程方、项目方、土方 / 租赁需求方（货主 / 甲方） |
| 核心价值 | 3 分钟发布一条工程需求 → 同步到开工啦「找活」→ 被车队 / 司机看到并接活 |
| 运行平台 | H5、微信小程序（货主版 AppID：`wx526cb49db2475de7`）、Android、iOS |
| 数据架构 | **后端优先**：调用 `http://bmain.jluj.com/admin` 真实接口（列表 / 详情 / 新增 / 修改 / 删除 / 我的发布）；仅登录态手机号、个人资料、草稿与跨页编辑缓存存本地 |

## 二、信息架构

```
闲置设备（首页 tab）
 ├─ 数据看板：累计发布 / 进行中 / 已下架
 ├─ 快捷发布（+ 发布找活）
 ├─ 最近发布（点击进详情）
 └─ 未登录时点击发布跳转登录页
我的（tab）
 ├─ 筛选：全部 / 进行中 / 已下架（带计数）
 └─ 列表项：上架/下架切换、编辑、删除
发布找活（表单，自定义 tabBar 中部 ＋ 悬浮入口）
 ├─ 基础信息：工程标题* 车型 工种* 作业方式* 数量* 结算价* 计价单位*
 ├─ 工期：开始 / 结束日期（picker）
 ├─ 作业地点：起点* 终点 运距
 ├─ 联系方式：联系人* 电话* 公司 性质
 ├─ 特色标签（多选：可开发票 / 现金结算 / 长期合作 …）
 └─ 需求描述 + 存草稿 / 立即发布
发布详情
 └─ 查看 + 编辑 / 上架下架 / 删除 + 交易安全提示
登录页
 └─ 手机号登录，成功后进入发布页（或被 redirect 目标页）
```

> 状态语义：`up = 进行中`、`down = 已下架`；App 以 `status` 表达，落库时映射后端 `enabled`（true=进行中）。

## 三、实现要点

- **后端优先**：`store/offer.uts` 调用真实后端接口（`fetchOffers / fetchOffer / saveOffer / setOfferStatus / removeOffer / fetchMyOffers`），增改通过 `POST / PUT /transport/offers` 持久化；仅登录态手机号、个人资料、草稿与跨页编辑缓存存本地。
- **自定义 tabBar**：`components/AppTabBar.uvue` 用 `reLaunch` 切换「货源 / 我的」两个 tab，中部悬浮 `＋` FAB 跳转发布（未登录时先进登录页）。`pages.json` 已移除原生 `tabBar` 配置。
- **表单强校验**：必填项、手机号格式、日期先后、数字格式（`common/types.uts:validateOffer`）。
- **本地草稿**：发布表单实时存本地（仅草稿态，非已发布数据），重进可续填 / 恢复。
- **跨页编辑**：详情 / 我的 → 发布页通过 `setEditOffer / takeEditOffer` 内存缓存带完整对象，带入表单。
- **交易安全提示 + 防骚扰提示**，降低纠纷与诈骗风险。

## 四、高保真原型与验证

- 高保真交互原型：`prototype/index.html`（单文件 SPA，开工啦主题，localStorage 持久化）。
- 功能已由 Playwright 驱动浏览器跑通 **14 项交互验证**（登录拦截、表单校验、发布跳详情、我的列表、下架、筛选、编辑带入、草稿恢复、删除、刷新持久化等）全部 PASS。
- 本 uni-app-x 工程严格对齐原型视觉与字段语义，逻辑与已验证原型一致。

## 五、运行方式

用 **HBuilderX** 打开本目录 `luye-app-cargo`，菜单「运行」：

- **运行到浏览器（H5）**：实时预览，最快验证视觉与交互。
- **运行到微信开发者工具（微信小程序）**：已配置货主版 AppID，需本机安装微信开发者工具并扫码。
- **运行到手机 / 模拟器（Android / iOS）**：需对应平台环境。

> HBuilderX CLI 仅支持 `app-android / app-harmony / app-ios` 的 `launch`（原生 App），H5 / 微信小程序需通过图形界面「运行」触发编译。

## 六、目录

```
common/types.uts        领域模型 + 枚举 + 校验（validateOffer / isValidPhone / statusText）
store/offer.uts         登录态 / 草稿 / 后端 CRUD 封装 / 跨页传参
components/AppTabBar.uvue 自定义底部栏（reLaunch + 中部 FAB）
pages/index             闲置设备（首页）
pages/my               我的
pages/login            手机号登录页
pages/publish           发布找活表单
pages/detail            发布详情 / 编辑
prototype/index.html    高保真交互原型（Playwright 验证用）
```