# bincoo-app

**Repository Path**: douyinai/bincoo-app

## Basic Information

- **Project Name**: bincoo-app
- **Description**: App端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## ios安装失败的问题
[](https://www.pgyer.com/doc/app/iOSFailureReasons#%E6%9C%AA%E5%90%AF%E7%94%A8%E5%BC%80%E5%8F%91%E8%80%85%E6%A8%A1%E5%BC%8F)
# 项目文档中心
	const instance = getCurrentInstance()!
uni.setNavigationBarTitle({
			title: instance.proxy!.$t('myRepice.title')
		})


欢迎来到 Bincoo App 项目文档中心! 这里包含了项目开发所需的所有规范和最佳实践。

---

## 📚 文档列表

### 🔥 核心文档 (必读)

#### 1. [UTS-RULES.md](./UTS-RULES.md)
**优先级: ⭐⭐⭐⭐⭐ (最高)**

UniApp X (UTS) 编程规范和注意事项,包含:
- 类型系统使用规范
- 运算符限制和替代方案
- 字符串/数字/布尔值比较规则
- JSON 对象操作方法
- 定时器与闭包处理
- CSS 限制说明
- 常见错误和解决方案
- 检查清单和记忆口诀

**关键规则速记:**
- ✅ 值比较用 `==`,不用 `===`
- ✅ 对象访问用 `['key']`,不用 `.key`
- ✅ 字符串访问用 `charAt()`,不用 `[index]`
- ✅ 使用 `if/else`,不用 `||` 运算符

#### 2. [MVP.md](./MVP.md)
**优先级: ⭐⭐⭐⭐⭐ (最高)**

Minimum Viable Process - 项目工作流程规范:
- 标准工作流程说明
- 文档驱动开发原则
- 实际案例分析
- 检查清单和最佳实践
- 自动化配置说明

**核心原则:** 先阅读文档,再执行任务

---

### 📖 专项文档

#### 3. [request-loading.md](./request-loading.md)
**优先级: ⭐⭐⭐⭐**

API 请求封装和加载提示使用规范:
- 统一请求方法封装
- 加载提示配置方法
- 错误处理标准
- 使用场景说明
- 迁移指南

**适用场景:** 所有 API 请求相关开发

#### 4. [lime-i18n.md](./lime-i18n.md)
**优先级: ⭐⭐⭐**

lime-i18n 国际化组件文档:
- 基础用法和配置
- 语言切换方法
- 文本格式化
- 复数处理
- 日期时间和数字格式化
- API 文档

**适用场景:** 多语言功能开发

---

## 🔄 使用流程

### 新手入门
1. 📖 通读 [MVP.md](./MVP.md) 了解工作流程
2. 📖 通读 [UTS-RULES.md](./UTS-RULES.md) 了解编程规范
3. 📝 记住关键规则和检查清单
4. 💻 开始编码,遇到问题查阅相关文档

### 日常开发
```
接到任务 → 判断类型 → 查阅对应文档 → 执行任务 → 更新文档
```

**示例:**
- 修复编译错误 → 查阅 `UTS-RULES.md`
- 实现 API 调用 → 查阅 `request-loading.md`
- 添加多语言 → 查阅 `lime-i18n.md`

---

## ⚙️ 自动化配置

### SessionStart Hook

项目已配置 Claude Code 的 `SessionStart` hook,位于 `.claude/settings.local.json`:

```json
{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "自动提醒 Claude Code 先阅读文档..."
          }
        ]
      }
    ]
  }
}
```

**作用:**
- ✅ 每次新会话自动加载项目规则
- ✅ 提醒关键文档位置和规则
- ✅ 强化 MVP 工作流程
- ✅ 确保 AI 助手遵循项目规范

**测试方法:**
1. 关闭当前 Claude Code 会话
2. 重新打开项目
3. 查看会话开始时是否有文档提醒

---

## 📋 快速查找

### 按问题类型查找

| 问题 | 查阅文档 | 章节 |
|------|---------|------|
| 编译警告: `Identity equality can be unstable` | UTS-RULES.md | 数字比较 |
| 编译警告: `Condition is always 'true'` | UTS-RULES.md | 字符串操作 |
| 如何发起 API 请求? | request-loading.md | 基本用法 |
| 如何添加加载提示? | request-loading.md | 配置选项 |
| 如何切换语言? | lime-i18n.md | 切换语言 |
| 如何处理复数? | lime-i18n.md | 复数处理 |
| 工作流程不清楚? | MVP.md | 标准工作流程 |

### 按关键词查找

- **类型系统**: UTS-RULES.md → 类型系统
- **`===` vs `==`**: UTS-RULES.md → 字符串操作、数字比较
- **对象访问**: UTS-RULES.md → JSON 对象
- **闭包问题**: UTS-RULES.md → 定时器与闭包
- **CSS 限制**: UTS-RULES.md → CSS 限制
- **加载提示**: request-loading.md → 使用方法
- **错误处理**: request-loading.md → 实现原理
- **多语言**: lime-i18n.md → 基础用法
- **MVP 流程**: MVP.md → 标准工作流程

---

## 🎯 文档维护

### 更新原则
- 发现新规则 → 立即记录
- 遇到新问题 → 补充案例
- 规则变更 → 及时更新
- 文档过时 → 删除或修正

### 更新流程
1. 确认问题或新规则
2. 查找对应文档位置
3. 添加/修改内容
4. 更新"最后更新"日期
5. 通知团队成员

### 文档规范
- 使用 Markdown 格式
- 包含清晰的目录
- 提供正确/错误示例对比
- 添加实际案例说明
- 保持更新日期

---

## ✅ 检查清单

### 开始新任务前
- [ ] 确定任务类型 (UTS/API/国际化等)
- [ ] 查阅对应文档
- [ ] 理解相关规则
- [ ] 准备开始编码

### 完成任务后
- [ ] 代码是否符合文档规范?
- [ ] 是否发现新规则?
- [ ] 是否需要更新文档?
- [ ] 是否需要补充案例?

### 代码审查时
- [ ] 对照 UTS-RULES.md 检查清单
- [ ] 检查是否使用 `===` 进行值比较
- [ ] 检查对象访问方式
- [ ] 检查 API 请求是否使用统一封装

---

## 🎓 学习路径

### 第一周: 基础规范
- Day 1-2: 通读 MVP.md 和 UTS-RULES.md
- Day 3-4: 记忆关键规则和检查清单
- Day 5: 对照规范审查现有代码

### 第二周: 深入理解
- Day 1-2: 理解每条规则背后的原因
- Day 3-4: 实践应用,编写符合规范的代码
- Day 5: 总结个人经验和心得

### 第三周: 融会贯通
- Day 1-3: 参与文档完善和案例补充
- Day 4-5: 帮助团队成员解答规范问题

---

## 💡 最佳实践

### 1. 文档优先
```
遇到问题 → 先查文档 → 再问人 → 最后试错
```

### 2. 持续学习
- 定期复习文档
- 记录自己的经验
- 分享踩过的坑

### 3. 积极贡献
- 发现问题立即反馈
- 主动补充文档
- 帮助新人成长

---

## 📞 反馈机制

### 文档问题
- 规则不清楚 → 在文档中添加说明
- 案例不足 → 补充实际案例
- 发现错误 → 立即修正

### 规则建议
- 发现新规则 → 更新 UTS-RULES.md
- 流程优化 → 更新 MVP.md
- 工具改进 → 更新对应文档

---

## 🌟 成功标志

### 个人层面
- ✅ 遇到问题首先想到查文档
- ✅ 写代码前习惯性检查规则
- ✅ 主动更新和完善文档

### 团队层面
- ✅ 代码风格统一
- ✅ 重复问题减少
- ✅ 新人上手更快

### 项目层面
- ✅ 编译警告大幅减少
- ✅ 代码质量提升
- ✅ 维护成本降低

---

## 📊 文档统计

| 文档名称 | 优先级 | 页数 | 最后更新 |
|---------|--------|------|----------|
| UTS-RULES.md | ⭐⭐⭐⭐⭐ | 长 | 2025-10-31 |
| MVP.md | ⭐⭐⭐⭐⭐ | 中 | 2025-11-01 |
| request-loading.md | ⭐⭐⭐⭐ | 中 | 2025-11-01 |
| lime-i18n.md | ⭐⭐⭐ | 长 | - |

---

## 🔗 相关链接

- [UTS 官方文档](https://doc.dcloud.net.cn/uni-app-x/uts/)
- [UniApp X 组件规范](https://doc.dcloud.net.cn/uni-app-x/component/)
- [Claude Code 文档](https://docs.claude.com/en/docs/claude-code)

---

*文档中心创建日期: 2025-11-01*
*最后更新: 2025-11-01*

**记住: 文档是活的,需要持续维护和更新!**

## 关于CooPopup组件
import CooPopup from "@/components/coo-popup/coo-popup.uvue"
<CooPopup 
		v-model="showPopup" 
		title="已分享至咖啡机" 
		text="配方名：埃塞耶加雪菲 浅烘 20250418专属于您的美味，已准备就绪~"
		leftBtnText="关闭"
		rightBtnText="开始冲煮"
		@rightBtnClick="startHandle">
		<template #rightBtnIcon>
			<text style="font-family: iconfont; font-size: 12px; color: #ffffff; margin-right: 3px;">{{'&#xe628;'}}</text>
		</template>
	</CooPopup>