parent
fe87d62a23
commit
607199557a
@ -0,0 +1,431 @@
|
||||
---
|
||||
id: property-dev
|
||||
name: 物业功能开发 Skill
|
||||
description: UniApp 物业功能开发规范,包含接口定义、页面开发、样式规范等
|
||||
tags: [uniapp, property, vue2, miniprogram]
|
||||
version: 1.0.0
|
||||
author: CodeBuddy
|
||||
---
|
||||
|
||||
# 物业功能开发 Skill
|
||||
|
||||
## 项目概述
|
||||
|
||||
这是一个基于 UniApp 开发的物业管理小程序项目,兼容 H5 和微信小程序。项目位于 `app/` 目录下,采用 Vue 2 语法风格。
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
app/
|
||||
├── api/ # API 接口文件
|
||||
│ └── property.js # 物业相关接口
|
||||
├── pages/
|
||||
│ └── supply_chain/ # 物业管理功能页面
|
||||
│ ├── day_menu/ # 每日菜单
|
||||
│ ├── repair/ # 报修管理
|
||||
│ ├── complaint/ # 投诉建议
|
||||
│ ├── stock/ # 物资领用
|
||||
│ ├── wish_menu/ # 祈愿菜单
|
||||
│ └── ...
|
||||
├── utils/
|
||||
│ └── request.js # 请求封装
|
||||
├── config/
|
||||
│ └── app.js # 全局配置
|
||||
└── components/ # 公共组件
|
||||
```
|
||||
|
||||
## 技术规范
|
||||
|
||||
### 1. 接口定义规范
|
||||
|
||||
接口文件位于 `app/api/property.js`,统一使用 `request` 对象:
|
||||
|
||||
```javascript
|
||||
import request from '@/utils/request.js';
|
||||
|
||||
// GET 请求示例
|
||||
export function listSomething(params) {
|
||||
return request.get(
|
||||
'autogencode/xxx/list',
|
||||
params,
|
||||
{ useAdminUrl: true }
|
||||
);
|
||||
}
|
||||
|
||||
// POST 请求示例
|
||||
export function createSomething(data) {
|
||||
return request.post(
|
||||
'autogencode/xxx/save',
|
||||
data,
|
||||
{ useAdminUrl: true }
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
**规范要点:**
|
||||
- 所有物业接口使用 `useAdminUrl: true`,前缀为 `autogencode/`
|
||||
- 列表查询用 `list` 后缀
|
||||
- 新增用 `save` 后缀
|
||||
- 删除用 `delete` 后缀
|
||||
- 详情用 `info/{id}` 后缀
|
||||
|
||||
### 2. 页面开发规范
|
||||
|
||||
#### 2.1 页面基础结构
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<z-paging ref="paging" v-model="records" @query="queryList">
|
||||
<template #top>
|
||||
<!-- 顶部区域 -->
|
||||
</template>
|
||||
|
||||
<!-- 内容区域 -->
|
||||
|
||||
<template #bottom>
|
||||
<!-- 底部区域 -->
|
||||
</template>
|
||||
</z-paging>
|
||||
</template>
|
||||
|
||||
<script>
|
||||
import { someApi } from '@/api/property.js';
|
||||
|
||||
export default {
|
||||
dicts: ['dict_key'], // 使用的字典
|
||||
data() {
|
||||
return {
|
||||
records: [],
|
||||
// 其他数据
|
||||
};
|
||||
},
|
||||
onLoad() {
|
||||
// 页面加载
|
||||
},
|
||||
methods: {
|
||||
async queryList(pageNo, pageSize) {
|
||||
try {
|
||||
const res = await someApi({ pageNo, pageSize });
|
||||
this.$refs.paging.complete(res?.data?.list || []);
|
||||
} catch (e) {
|
||||
this.$refs.paging.complete(false);
|
||||
}
|
||||
}
|
||||
}
|
||||
};
|
||||
</script>
|
||||
|
||||
<style lang="scss">
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background: #f6f7fb;
|
||||
}
|
||||
</style>
|
||||
```
|
||||
|
||||
#### 2.2 表单页面结构
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<z-paging ref="paging" v-model="records" @query="queryList" :layout-only="activeTab === 'form'">
|
||||
<template #top>
|
||||
<!-- 标签切换 -->
|
||||
<view class="tabs">
|
||||
<view class="tab" :class="activeTab === 'form' ? 'active' : ''" @click="activeTab = 'form'">
|
||||
表单标题
|
||||
</view>
|
||||
<view class="tab" :class="activeTab === 'list' ? 'active' : ''" @click="switchToList">
|
||||
记录列表
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<!-- 表单区域 -->
|
||||
<view class="tab-content" v-show="activeTab === 'form'">
|
||||
<view class="form-card">
|
||||
<!-- 表单项 -->
|
||||
</view>
|
||||
</view>
|
||||
</z-paging>
|
||||
</template>
|
||||
```
|
||||
|
||||
#### 2.3 字典使用
|
||||
|
||||
```javascript
|
||||
export default {
|
||||
dicts: ['fault_type', 'cs_type'], // 声明使用的字典
|
||||
|
||||
methods: {
|
||||
// 获取字典数据
|
||||
getDictLabel(dictKey, value) {
|
||||
const dict = this.dict.get(dictKey) || [];
|
||||
const item = dict.find(d => d.dictValue === value);
|
||||
return item?.dictLabel || value;
|
||||
}
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 3. 样式规范
|
||||
|
||||
#### 3.1 颜色变量
|
||||
|
||||
```scss
|
||||
// 主色调
|
||||
$primary: #3b82f6; // 蓝色主色
|
||||
$success: #16a34a; // 绿色成功
|
||||
$danger: #dc2626; // 红色危险/错误
|
||||
$warning: #f97316; // 橙色警告
|
||||
|
||||
// 背景色
|
||||
$bg-page: #f6f7fb; // 页面背景
|
||||
$bg-card: #ffffff; // 卡片背景
|
||||
$bg-gray: #f3f4f6; // 灰色背景
|
||||
|
||||
// 文字色
|
||||
$text-primary: #1f2937; // 主要文字
|
||||
$text-secondary: #6b7280; // 次要文字
|
||||
$text-muted: #9ca3af; // 弱化文字
|
||||
```
|
||||
|
||||
#### 3.2 常用样式类
|
||||
|
||||
```scss
|
||||
// 页面容器
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background: #f6f7fb;
|
||||
padding: 24rpx;
|
||||
}
|
||||
|
||||
// 卡片样式
|
||||
.card {
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 24rpx;
|
||||
margin-bottom: 20rpx;
|
||||
}
|
||||
|
||||
// 标签切换
|
||||
.tabs {
|
||||
display: flex;
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 8rpx;
|
||||
margin-bottom: 20rpx;
|
||||
|
||||
.tab {
|
||||
flex: 1;
|
||||
text-align: center;
|
||||
padding: 20rpx 0;
|
||||
font-size: 28rpx;
|
||||
color: #6b7280;
|
||||
border-radius: 12rpx;
|
||||
|
||||
&.active {
|
||||
background: #3b82f6;
|
||||
color: #fff;
|
||||
font-weight: 600;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 表单项
|
||||
.form-item {
|
||||
margin-bottom: 24rpx;
|
||||
|
||||
.label {
|
||||
font-size: 28rpx;
|
||||
color: #374151;
|
||||
margin-bottom: 12rpx;
|
||||
display: block;
|
||||
}
|
||||
|
||||
.input, .textarea {
|
||||
background: #f9fafb;
|
||||
border-radius: 12rpx;
|
||||
padding: 20rpx;
|
||||
font-size: 28rpx;
|
||||
}
|
||||
}
|
||||
|
||||
// 按钮样式
|
||||
.btn-primary {
|
||||
background: #3b82f6;
|
||||
color: #fff;
|
||||
border-radius: 12rpx;
|
||||
padding: 24rpx 0;
|
||||
text-align: center;
|
||||
font-size: 30rpx;
|
||||
font-weight: 600;
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 图片上传规范
|
||||
|
||||
```javascript
|
||||
methods: {
|
||||
// 选择图片
|
||||
chooseImage() {
|
||||
uni.chooseImage({
|
||||
count: 9 - this.images.length,
|
||||
success: (res) => {
|
||||
res.tempFilePaths.forEach(path => {
|
||||
this.uploadImage(path);
|
||||
});
|
||||
}
|
||||
});
|
||||
},
|
||||
|
||||
// 上传图片
|
||||
async uploadImage(filePath) {
|
||||
try {
|
||||
uni.showLoading({ title: '上传中...' });
|
||||
const result = await request.uploadFile(filePath, 'file');
|
||||
this.images.push({ url: result.url });
|
||||
} catch (e) {
|
||||
uni.showToast({ title: '上传失败', icon: 'none' });
|
||||
} finally {
|
||||
uni.hideLoading();
|
||||
}
|
||||
},
|
||||
|
||||
// 删除图片
|
||||
deleteImage(index) {
|
||||
this.images.splice(index, 1);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 5. 常用组件
|
||||
|
||||
#### 5.1 z-paging 分页组件
|
||||
|
||||
```vue
|
||||
<z-paging
|
||||
ref="paging"
|
||||
v-model="records"
|
||||
@query="queryList"
|
||||
:layout-only="false"
|
||||
:auto="true"
|
||||
>
|
||||
<template #top>
|
||||
<!-- 顶部固定区域 -->
|
||||
</template>
|
||||
|
||||
<!-- 列表内容 -->
|
||||
<view v-for="item in records" :key="item.id">
|
||||
<!-- 列表项 -->
|
||||
</view>
|
||||
|
||||
<template #bottom>
|
||||
<!-- 底部固定区域 -->
|
||||
</template>
|
||||
</z-paging>
|
||||
```
|
||||
|
||||
#### 5.2 uni-calendar 日历组件
|
||||
|
||||
```vue
|
||||
<uni-calendar
|
||||
ref="calendar"
|
||||
:insert="false"
|
||||
:range="false"
|
||||
:start-date="'2026-01-01'"
|
||||
:end-date="'2099-12-31'"
|
||||
@confirm="onDateConfirm"
|
||||
/>
|
||||
```
|
||||
|
||||
#### 5.3 picker 选择器
|
||||
|
||||
```vue
|
||||
<picker
|
||||
@change="onPickerChange"
|
||||
:value="index"
|
||||
:range="options"
|
||||
:range-key="'label'"
|
||||
>
|
||||
<view class="picker">
|
||||
{{ selectedLabel || '请选择' }}
|
||||
</view>
|
||||
</picker>
|
||||
```
|
||||
|
||||
## 现有功能模块
|
||||
|
||||
### 已开发模块
|
||||
|
||||
1. **每日菜单** (`day_menu/`)
|
||||
- 按日期查看菜单
|
||||
- 菜品点赞/点踩
|
||||
- 菜品排行
|
||||
- 食堂切换
|
||||
|
||||
2. **报修管理** (`repair/`)
|
||||
- 提交报修单
|
||||
- 报修记录列表
|
||||
- 图片上传
|
||||
- 房屋选择
|
||||
|
||||
3. **投诉建议** (`complaint/`)
|
||||
- 提交投诉/建议
|
||||
- 历史记录
|
||||
- 图片上传
|
||||
|
||||
4. **物资领用** (`stock/`)
|
||||
- 物资列表
|
||||
- 领用申请
|
||||
- 领用记录
|
||||
|
||||
5. **祈愿菜单** (`wish_menu/`)
|
||||
- 提交祈愿
|
||||
- 祈愿列表
|
||||
|
||||
6. **公告通知** (`notice/`)
|
||||
- 公告列表
|
||||
- 公告详情
|
||||
|
||||
## 开发建议
|
||||
|
||||
### 新增功能步骤
|
||||
|
||||
1. **创建 API 接口**
|
||||
- 在 `app/api/property.js` 中添加接口函数
|
||||
- 遵循命名规范:`listXxx`, `createXxx`, `updateXxx`, `deleteXxx`
|
||||
|
||||
2. **创建页面**
|
||||
- 在 `app/pages/supply_chain/` 下新建文件夹
|
||||
- 创建 `index.vue` 文件
|
||||
- 复制基础模板进行修改
|
||||
|
||||
3. **配置路由**
|
||||
- 在 `app/pages.json` 中添加页面配置
|
||||
- 设置页面标题和样式
|
||||
|
||||
4. **添加字典(如需要)**
|
||||
- 确认后端已配置字典
|
||||
- 在页面 `dicts` 中声明使用
|
||||
|
||||
### 代码复用
|
||||
|
||||
- **列表分页**:使用 `z-paging` 组件
|
||||
- **图片上传**:参考 `repair/index.vue` 中的实现
|
||||
- **表单验证**:使用 uni-app 表单验证或自定义验证
|
||||
- **日期处理**:使用 `uni-calendar` 组件
|
||||
|
||||
### 注意事项
|
||||
|
||||
1. 所有接口请求使用 `useAdminUrl: true`
|
||||
2. 图片上传使用 `request.uploadFile` 方法
|
||||
3. 字典数据通过 `this.dict.get(key)` 获取
|
||||
4. 页面背景统一使用 `#f6f7fb`
|
||||
5. 卡片圆角统一使用 `16rpx`
|
||||
6. 支持 H5 和微信小程序,注意平台差异处理
|
||||
|
||||
## 参考示例
|
||||
|
||||
- 表单+列表页面:参考 `repair/index.vue`
|
||||
- 纯列表页面:参考 `notice/index.vue`
|
||||
- 复杂交互页面:参考 `day_menu/index.vue`
|
||||
@ -0,0 +1,367 @@
|
||||
<template>
|
||||
<z-paging ref="paging" v-model="records" @query="queryList">
|
||||
|
||||
<!-- 故障列表 -->
|
||||
<view class="record-list">
|
||||
<view
|
||||
class="record-card"
|
||||
v-for="item in records"
|
||||
:key="item.id"
|
||||
>
|
||||
<view class="card-header">
|
||||
<view class="left">
|
||||
<text class="type">
|
||||
{{ item.houseName || '报修单' }}
|
||||
</text>
|
||||
<text
|
||||
class="status"
|
||||
:class="statusClassMap[item.status] || statusClassMap['__default__']"
|
||||
>
|
||||
{{ statusText(item.status, item.remark) }}
|
||||
</text>
|
||||
</view>
|
||||
<view class="header-right">
|
||||
<text class="time">
|
||||
{{ item.reportTime || item.createTime || '' }}
|
||||
</text>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<view class="card-body">
|
||||
<view class="row" v-if="item.faultType">
|
||||
<text class="label">故障类型</text>
|
||||
<text class="value">
|
||||
{{ getFaultTypeLabel(item.faultType) }}
|
||||
</text>
|
||||
</view>
|
||||
<view class="row" v-if="item.faultDesc">
|
||||
<text class="label">报修内容</text>
|
||||
<text class="value">
|
||||
{{ item.faultDesc }}
|
||||
</text>
|
||||
</view>
|
||||
|
||||
<view class="image-section" v-if="item.files && item.files.length">
|
||||
<text class="image-title">故障图片</text>
|
||||
<view class="image-grid">
|
||||
<view
|
||||
class="image-item"
|
||||
v-for="(file, imgIndex) in item.files"
|
||||
:key="imgIndex"
|
||||
@click="previewRecordImages(item.files, imgIndex)"
|
||||
>
|
||||
<image
|
||||
:src="HTTP_ADMIN_URL + '/' + (file.url || file.attDir)"
|
||||
mode="aspectFill"
|
||||
></image>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<view
|
||||
class="image-section"
|
||||
v-if="item.afterProcessFiles && item.afterProcessFiles.length"
|
||||
>
|
||||
<text class="image-title">处理结果图片</text>
|
||||
<view class="image-grid">
|
||||
<view
|
||||
class="image-item"
|
||||
v-for="(file, imgIndex) in item.afterProcessFiles"
|
||||
:key="imgIndex"
|
||||
@click="previewRecordImages(item.afterProcessFiles, imgIndex)"
|
||||
>
|
||||
<image
|
||||
:src="HTTP_ADMIN_URL + '/' + (file.url || file.attDir)"
|
||||
mode="aspectFill"
|
||||
></image>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
|
||||
<!-- 操作按钮 -->
|
||||
<view class="card-footer">
|
||||
<text class="action-btn dispatch-btn" @click="goDispatch(item.id)">查看派单</text>
|
||||
<text class="action-btn handle-btn" v-if="checkPermi('send_order') && item.status !== '99'" @click="openFinishPopup(item)">去办结</text>
|
||||
</view>
|
||||
</view>
|
||||
</view>
|
||||
</z-paging>
|
||||
</template>
|
||||
|
||||
<script>
|
||||
import { listMaintenanceOrder, updateMaintenanceOrderStatus } from '@/api/property.js';
|
||||
import { HTTP_ADMIN_URL } from '@/config/app';
|
||||
import { checkPermi } from '@/utils/auth/permission.js';
|
||||
|
||||
export default {
|
||||
dicts: ['fault_type'],
|
||||
data() {
|
||||
return {
|
||||
checkPermi,
|
||||
HTTP_ADMIN_URL,
|
||||
records: [],
|
||||
statusClassMap: {
|
||||
0: 'status-pending',
|
||||
1: 'status-doing',
|
||||
2: 'status-done',
|
||||
99: 'status-done',
|
||||
'__default__': 'status-pending'
|
||||
}
|
||||
};
|
||||
},
|
||||
onLoad() {
|
||||
// 页面加载时自动刷新列表
|
||||
},
|
||||
methods: {
|
||||
// 获取故障列表
|
||||
queryList(pageNo, pageSize) {
|
||||
listMaintenanceOrder({
|
||||
page: pageNo,
|
||||
limit: pageSize,
|
||||
uid: null,
|
||||
}).then((res) => {
|
||||
const list = res?.data?.list || [];
|
||||
this.$refs.paging.complete(list);
|
||||
}).catch((err) => {
|
||||
console.error('获取故障列表失败:', err);
|
||||
this.$refs.paging.complete(false);
|
||||
});
|
||||
},
|
||||
// 状态文本
|
||||
statusText(status, remark) {
|
||||
if (status === 0 || status === '0') return '待处理';
|
||||
if (status === 1 || status === '1') return '处理中';
|
||||
if (status === 2 || status === '2') return '已处理';
|
||||
if (status === 99 || status === '99') return remark || '已撤销';
|
||||
return '待处理';
|
||||
},
|
||||
// 获取故障类型标签
|
||||
getFaultTypeLabel(value) {
|
||||
const types = this.dict.get('fault_type');
|
||||
if (types) {
|
||||
const type = types.find(t => t.dictValue === value);
|
||||
return type ? type.dictLabel : value;
|
||||
}
|
||||
return value;
|
||||
},
|
||||
// 预览图片
|
||||
previewRecordImages(files, index) {
|
||||
if (!files || !files.length) return;
|
||||
const urls = files.map(file => {
|
||||
const path = file.url || file.attDir || file.filePath;
|
||||
return this.HTTP_ADMIN_URL + '/' + path;
|
||||
});
|
||||
uni.previewImage({
|
||||
current: index,
|
||||
urls
|
||||
});
|
||||
},
|
||||
// 跳转到派单页面
|
||||
goDispatch(item) {
|
||||
uni.navigateTo({
|
||||
url: `/pages/supply_chain/dispatch/index?orderId=${item.id}&status=${item.status}`
|
||||
});
|
||||
},
|
||||
// 打开办结弹窗
|
||||
openFinishPopup(item) {
|
||||
uni.showModal({
|
||||
title: '办结',
|
||||
editable: true,
|
||||
placeholderText: '已办结',
|
||||
content: '已办结',
|
||||
success: async (res) => {
|
||||
if (res.confirm) {
|
||||
const remark = res.content || '已办结';
|
||||
await this.handleFinish(item, remark);
|
||||
}
|
||||
}
|
||||
});
|
||||
},
|
||||
// 处理办结
|
||||
async handleFinish(item, remark) {
|
||||
try {
|
||||
uni.showLoading({ title: '提交中...', mask: true });
|
||||
await updateMaintenanceOrderStatus({
|
||||
id: item.id,
|
||||
status: '99',
|
||||
remark: remark
|
||||
});
|
||||
uni.showToast({ title: '办结成功', icon: 'success' });
|
||||
this.$refs.paging.reload();
|
||||
} catch (e) {
|
||||
console.error('办结失败:', e);
|
||||
uni.showToast({ title: typeof e === 'string' ? e : '办结失败', icon: 'none' });
|
||||
} finally {
|
||||
uni.hideLoading();
|
||||
}
|
||||
}
|
||||
}
|
||||
};
|
||||
</script>
|
||||
|
||||
<style lang="scss">
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background: #f6f7fb;
|
||||
padding: 24rpx;
|
||||
}
|
||||
|
||||
.tabs {
|
||||
display: flex;
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 8rpx;
|
||||
margin-bottom: 20rpx;
|
||||
|
||||
.tab {
|
||||
flex: 1;
|
||||
text-align: center;
|
||||
padding: 20rpx 0;
|
||||
font-size: 28rpx;
|
||||
color: #6b7280;
|
||||
border-radius: 12rpx;
|
||||
|
||||
&.active {
|
||||
background: #3b82f6;
|
||||
color: #fff;
|
||||
font-weight: 600;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.record-list {
|
||||
padding: 0 4rpx;
|
||||
}
|
||||
|
||||
.record-card {
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 24rpx;
|
||||
margin-bottom: 20rpx;
|
||||
box-shadow: 0 2rpx 10rpx rgba(0, 0, 0, 0.06);
|
||||
|
||||
.card-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
margin-bottom: 16rpx;
|
||||
|
||||
.left {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
|
||||
.type {
|
||||
font-size: 28rpx;
|
||||
font-weight: 600;
|
||||
color: #333;
|
||||
margin-right: 16rpx;
|
||||
max-width: 280rpx;
|
||||
}
|
||||
|
||||
.status {
|
||||
padding: 6rpx 18rpx;
|
||||
border-radius: 20rpx;
|
||||
font-size: 22rpx;
|
||||
}
|
||||
|
||||
.status-pending {
|
||||
background-color: #E6F7FF;
|
||||
color: #409EFF;
|
||||
}
|
||||
|
||||
.status-doing {
|
||||
background-color: #FFF7E6;
|
||||
color: #FA8C16;
|
||||
}
|
||||
|
||||
.status-done {
|
||||
background-color: #F6FFED;
|
||||
color: #52C41A;
|
||||
}
|
||||
}
|
||||
|
||||
.header-right {
|
||||
.time {
|
||||
font-size: 22rpx;
|
||||
color: #999;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.card-body {
|
||||
.row {
|
||||
display: flex;
|
||||
margin-bottom: 10rpx;
|
||||
|
||||
.label {
|
||||
width: 160rpx;
|
||||
font-size: 24rpx;
|
||||
color: #666;
|
||||
}
|
||||
|
||||
.value {
|
||||
flex: 1;
|
||||
font-size: 24rpx;
|
||||
color: #333;
|
||||
}
|
||||
}
|
||||
|
||||
.image-section {
|
||||
margin-top: 12rpx;
|
||||
|
||||
.image-title {
|
||||
display: block;
|
||||
font-size: 22rpx;
|
||||
color: #666;
|
||||
margin-bottom: 10rpx;
|
||||
}
|
||||
|
||||
.image-grid {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 12rpx;
|
||||
|
||||
.image-item {
|
||||
width: calc((100% - 24rpx) / 3);
|
||||
aspect-ratio: 1 / 1;
|
||||
border-radius: 8rpx;
|
||||
overflow: hidden;
|
||||
background-color: #f5f5f5;
|
||||
|
||||
image {
|
||||
width: 100%;
|
||||
height: 100%;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.card-footer {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
gap: 20rpx;
|
||||
margin-top: 20rpx;
|
||||
padding-top: 20rpx;
|
||||
border-top: 1rpx solid #f0f0f0;
|
||||
|
||||
.action-btn {
|
||||
padding: 12rpx 32rpx;
|
||||
border-radius: 24rpx;
|
||||
font-size: 26rpx;
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.dispatch-btn {
|
||||
background: #E6F7FF;
|
||||
color: #409EFF;
|
||||
}
|
||||
|
||||
.handle-btn {
|
||||
background: #F6FFED;
|
||||
color: #52C41A;
|
||||
}
|
||||
}
|
||||
}
|
||||
</style>
|
||||
@ -0,0 +1,431 @@
|
||||
---
|
||||
id: property-dev
|
||||
name: 物业功能开发 Skill
|
||||
description: UniApp 物业功能开发规范,包含接口定义、页面开发、样式规范等
|
||||
tags: [uniapp, property, vue2, miniprogram]
|
||||
version: 1.0.0
|
||||
author: CodeBuddy
|
||||
---
|
||||
|
||||
# 物业功能开发 Skill
|
||||
|
||||
## 项目概述
|
||||
|
||||
这是一个基于 UniApp 开发的物业管理小程序项目,兼容 H5 和微信小程序。项目位于 `app/` 目录下,采用 Vue 2 语法风格。
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
app/
|
||||
├── api/ # API 接口文件
|
||||
│ └── property.js # 物业相关接口
|
||||
├── pages/
|
||||
│ └── supply_chain/ # 物业管理功能页面
|
||||
│ ├── day_menu/ # 每日菜单
|
||||
│ ├── repair/ # 报修管理
|
||||
│ ├── complaint/ # 投诉建议
|
||||
│ ├── stock/ # 物资领用
|
||||
│ ├── wish_menu/ # 祈愿菜单
|
||||
│ └── ...
|
||||
├── utils/
|
||||
│ └── request.js # 请求封装
|
||||
├── config/
|
||||
│ └── app.js # 全局配置
|
||||
└── components/ # 公共组件
|
||||
```
|
||||
|
||||
## 技术规范
|
||||
|
||||
### 1. 接口定义规范
|
||||
|
||||
接口文件位于 `app/api/property.js`,统一使用 `request` 对象:
|
||||
|
||||
```javascript
|
||||
import request from '@/utils/request.js';
|
||||
|
||||
// GET 请求示例
|
||||
export function listSomething(params) {
|
||||
return request.get(
|
||||
'autogencode/xxx/list',
|
||||
params,
|
||||
{ useAdminUrl: true }
|
||||
);
|
||||
}
|
||||
|
||||
// POST 请求示例
|
||||
export function createSomething(data) {
|
||||
return request.post(
|
||||
'autogencode/xxx/save',
|
||||
data,
|
||||
{ useAdminUrl: true }
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
**规范要点:**
|
||||
- 所有物业接口使用 `useAdminUrl: true`,前缀为 `autogencode/`
|
||||
- 列表查询用 `list` 后缀
|
||||
- 新增用 `save` 后缀
|
||||
- 删除用 `delete` 后缀
|
||||
- 详情用 `info/{id}` 后缀
|
||||
|
||||
### 2. 页面开发规范
|
||||
|
||||
#### 2.1 页面基础结构
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<z-paging ref="paging" v-model="records" @query="queryList">
|
||||
<template #top>
|
||||
<!-- 顶部区域 -->
|
||||
</template>
|
||||
|
||||
<!-- 内容区域 -->
|
||||
|
||||
<template #bottom>
|
||||
<!-- 底部区域 -->
|
||||
</template>
|
||||
</z-paging>
|
||||
</template>
|
||||
|
||||
<script>
|
||||
import { someApi } from '@/api/property.js';
|
||||
|
||||
export default {
|
||||
dicts: ['dict_key'], // 使用的字典
|
||||
data() {
|
||||
return {
|
||||
records: [],
|
||||
// 其他数据
|
||||
};
|
||||
},
|
||||
onLoad() {
|
||||
// 页面加载
|
||||
},
|
||||
methods: {
|
||||
async queryList(pageNo, pageSize) {
|
||||
try {
|
||||
const res = await someApi({ pageNo, pageSize });
|
||||
this.$refs.paging.complete(res?.data?.list || []);
|
||||
} catch (e) {
|
||||
this.$refs.paging.complete(false);
|
||||
}
|
||||
}
|
||||
}
|
||||
};
|
||||
</script>
|
||||
|
||||
<style lang="scss">
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background: #f6f7fb;
|
||||
}
|
||||
</style>
|
||||
```
|
||||
|
||||
#### 2.2 表单页面结构
|
||||
|
||||
```vue
|
||||
<template>
|
||||
<z-paging ref="paging" v-model="records" @query="queryList" :layout-only="activeTab === 'form'">
|
||||
<template #top>
|
||||
<!-- 标签切换 -->
|
||||
<view class="tabs">
|
||||
<view class="tab" :class="activeTab === 'form' ? 'active' : ''" @click="activeTab = 'form'">
|
||||
表单标题
|
||||
</view>
|
||||
<view class="tab" :class="activeTab === 'list' ? 'active' : ''" @click="switchToList">
|
||||
记录列表
|
||||
</view>
|
||||
</view>
|
||||
</template>
|
||||
|
||||
<!-- 表单区域 -->
|
||||
<view class="tab-content" v-show="activeTab === 'form'">
|
||||
<view class="form-card">
|
||||
<!-- 表单项 -->
|
||||
</view>
|
||||
</view>
|
||||
</z-paging>
|
||||
</template>
|
||||
```
|
||||
|
||||
#### 2.3 字典使用
|
||||
|
||||
```javascript
|
||||
export default {
|
||||
dicts: ['fault_type', 'cs_type'], // 声明使用的字典
|
||||
|
||||
methods: {
|
||||
// 获取字典数据
|
||||
getDictLabel(dictKey, value) {
|
||||
const dict = this.dict.get(dictKey) || [];
|
||||
const item = dict.find(d => d.dictValue === value);
|
||||
return item?.dictLabel || value;
|
||||
}
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
### 3. 样式规范
|
||||
|
||||
#### 3.1 颜色变量
|
||||
|
||||
```scss
|
||||
// 主色调
|
||||
$primary: #3b82f6; // 蓝色主色
|
||||
$success: #16a34a; // 绿色成功
|
||||
$danger: #dc2626; // 红色危险/错误
|
||||
$warning: #f97316; // 橙色警告
|
||||
|
||||
// 背景色
|
||||
$bg-page: #f6f7fb; // 页面背景
|
||||
$bg-card: #ffffff; // 卡片背景
|
||||
$bg-gray: #f3f4f6; // 灰色背景
|
||||
|
||||
// 文字色
|
||||
$text-primary: #1f2937; // 主要文字
|
||||
$text-secondary: #6b7280; // 次要文字
|
||||
$text-muted: #9ca3af; // 弱化文字
|
||||
```
|
||||
|
||||
#### 3.2 常用样式类
|
||||
|
||||
```scss
|
||||
// 页面容器
|
||||
.page {
|
||||
min-height: 100vh;
|
||||
background: #f6f7fb;
|
||||
padding: 24rpx;
|
||||
}
|
||||
|
||||
// 卡片样式
|
||||
.card {
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 24rpx;
|
||||
margin-bottom: 20rpx;
|
||||
}
|
||||
|
||||
// 标签切换
|
||||
.tabs {
|
||||
display: flex;
|
||||
background: #fff;
|
||||
border-radius: 16rpx;
|
||||
padding: 8rpx;
|
||||
margin-bottom: 20rpx;
|
||||
|
||||
.tab {
|
||||
flex: 1;
|
||||
text-align: center;
|
||||
padding: 20rpx 0;
|
||||
font-size: 28rpx;
|
||||
color: #6b7280;
|
||||
border-radius: 12rpx;
|
||||
|
||||
&.active {
|
||||
background: #3b82f6;
|
||||
color: #fff;
|
||||
font-weight: 600;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 表单项
|
||||
.form-item {
|
||||
margin-bottom: 24rpx;
|
||||
|
||||
.label {
|
||||
font-size: 28rpx;
|
||||
color: #374151;
|
||||
margin-bottom: 12rpx;
|
||||
display: block;
|
||||
}
|
||||
|
||||
.input, .textarea {
|
||||
background: #f9fafb;
|
||||
border-radius: 12rpx;
|
||||
padding: 20rpx;
|
||||
font-size: 28rpx;
|
||||
}
|
||||
}
|
||||
|
||||
// 按钮样式
|
||||
.btn-primary {
|
||||
background: #3b82f6;
|
||||
color: #fff;
|
||||
border-radius: 12rpx;
|
||||
padding: 24rpx 0;
|
||||
text-align: center;
|
||||
font-size: 30rpx;
|
||||
font-weight: 600;
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 图片上传规范
|
||||
|
||||
```javascript
|
||||
methods: {
|
||||
// 选择图片
|
||||
chooseImage() {
|
||||
uni.chooseImage({
|
||||
count: 9 - this.images.length,
|
||||
success: (res) => {
|
||||
res.tempFilePaths.forEach(path => {
|
||||
this.uploadImage(path);
|
||||
});
|
||||
}
|
||||
});
|
||||
},
|
||||
|
||||
// 上传图片
|
||||
async uploadImage(filePath) {
|
||||
try {
|
||||
uni.showLoading({ title: '上传中...' });
|
||||
const result = await request.uploadFile(filePath, 'file');
|
||||
this.images.push({ url: result.url });
|
||||
} catch (e) {
|
||||
uni.showToast({ title: '上传失败', icon: 'none' });
|
||||
} finally {
|
||||
uni.hideLoading();
|
||||
}
|
||||
},
|
||||
|
||||
// 删除图片
|
||||
deleteImage(index) {
|
||||
this.images.splice(index, 1);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 5. 常用组件
|
||||
|
||||
#### 5.1 z-paging 分页组件
|
||||
|
||||
```vue
|
||||
<z-paging
|
||||
ref="paging"
|
||||
v-model="records"
|
||||
@query="queryList"
|
||||
:layout-only="false"
|
||||
:auto="true"
|
||||
>
|
||||
<template #top>
|
||||
<!-- 顶部固定区域 -->
|
||||
</template>
|
||||
|
||||
<!-- 列表内容 -->
|
||||
<view v-for="item in records" :key="item.id">
|
||||
<!-- 列表项 -->
|
||||
</view>
|
||||
|
||||
<template #bottom>
|
||||
<!-- 底部固定区域 -->
|
||||
</template>
|
||||
</z-paging>
|
||||
```
|
||||
|
||||
#### 5.2 uni-calendar 日历组件
|
||||
|
||||
```vue
|
||||
<uni-calendar
|
||||
ref="calendar"
|
||||
:insert="false"
|
||||
:range="false"
|
||||
:start-date="'2026-01-01'"
|
||||
:end-date="'2099-12-31'"
|
||||
@confirm="onDateConfirm"
|
||||
/>
|
||||
```
|
||||
|
||||
#### 5.3 picker 选择器
|
||||
|
||||
```vue
|
||||
<picker
|
||||
@change="onPickerChange"
|
||||
:value="index"
|
||||
:range="options"
|
||||
:range-key="'label'"
|
||||
>
|
||||
<view class="picker">
|
||||
{{ selectedLabel || '请选择' }}
|
||||
</view>
|
||||
</picker>
|
||||
```
|
||||
|
||||
## 现有功能模块
|
||||
|
||||
### 已开发模块
|
||||
|
||||
1. **每日菜单** (`day_menu/`)
|
||||
- 按日期查看菜单
|
||||
- 菜品点赞/点踩
|
||||
- 菜品排行
|
||||
- 食堂切换
|
||||
|
||||
2. **报修管理** (`repair/`)
|
||||
- 提交报修单
|
||||
- 报修记录列表
|
||||
- 图片上传
|
||||
- 房屋选择
|
||||
|
||||
3. **投诉建议** (`complaint/`)
|
||||
- 提交投诉/建议
|
||||
- 历史记录
|
||||
- 图片上传
|
||||
|
||||
4. **物资领用** (`stock/`)
|
||||
- 物资列表
|
||||
- 领用申请
|
||||
- 领用记录
|
||||
|
||||
5. **祈愿菜单** (`wish_menu/`)
|
||||
- 提交祈愿
|
||||
- 祈愿列表
|
||||
|
||||
6. **公告通知** (`notice/`)
|
||||
- 公告列表
|
||||
- 公告详情
|
||||
|
||||
## 开发建议
|
||||
|
||||
### 新增功能步骤
|
||||
|
||||
1. **创建 API 接口**
|
||||
- 在 `app/api/property.js` 中添加接口函数
|
||||
- 遵循命名规范:`listXxx`, `createXxx`, `updateXxx`, `deleteXxx`
|
||||
|
||||
2. **创建页面**
|
||||
- 在 `app/pages/supply_chain/` 下新建文件夹
|
||||
- 创建 `index.vue` 文件
|
||||
- 复制基础模板进行修改
|
||||
|
||||
3. **配置路由**
|
||||
- 在 `app/pages.json` 中添加页面配置
|
||||
- 设置页面标题和样式
|
||||
|
||||
4. **添加字典(如需要)**
|
||||
- 确认后端已配置字典
|
||||
- 在页面 `dicts` 中声明使用
|
||||
|
||||
### 代码复用
|
||||
|
||||
- **列表分页**:使用 `z-paging` 组件
|
||||
- **图片上传**:参考 `repair/index.vue` 中的实现
|
||||
- **表单验证**:使用 uni-app 表单验证或自定义验证
|
||||
- **日期处理**:使用 `uni-calendar` 组件
|
||||
|
||||
### 注意事项
|
||||
|
||||
1. 所有接口请求使用 `useAdminUrl: true`
|
||||
2. 图片上传使用 `request.uploadFile` 方法
|
||||
3. 字典数据通过 `this.dict.get(key)` 获取
|
||||
4. 页面背景统一使用 `#f6f7fb`
|
||||
5. 卡片圆角统一使用 `16rpx`
|
||||
6. 支持 H5 和微信小程序,注意平台差异处理
|
||||
|
||||
## 参考示例
|
||||
|
||||
- 表单+列表页面:参考 `repair/index.vue`
|
||||
- 纯列表页面:参考 `notice/index.vue`
|
||||
- 复杂交互页面:参考 `day_menu/index.vue`
|
||||
|
After Width: | Height: | Size: 1.2 KiB |
Loading…
Reference in new issue