# pivot-continew-uni

**Repository Path**: fuqiangcode/pivot-continew-uni

## Basic Information

- **Project Name**: pivot-continew-uni
- **Description**: 基于unibest的i18n版本，优化了路由拦截，集成了开源项目Continew-Admin的功能，增加了Continew-Admin对于微信小程序/支付宝小程序、抖音小程序的支持，利用continew-admin的插件化优势，将常用场景（支付、会员等作为单独的插件进行管理）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-20
- **Last Updated**: 2025-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pivot-Continew-uni 开发文档

欢迎使用 Pivot-Continew-uni 开发文档！这里包含了项目开发所需的全部规范和指南。

## 📚 文档列表

### 核心规范文档
- [开发规范 (中文)](../docs/DEVELOPMENT_STANDARDS.md) - 详细的中文开发规范
- [Development Standards (English)](../docs/DEVELOPMENT_STANDARDS.md) - 完整的英文开发规范

### 快速开始

1. **环境准备**
   ```bash
   # 安装依赖
   pnpm install
   
   # 启动开发服务器
   pnpm dev
   
   # 微信小程序开发
   pnpm dev:mp-weixin
   
   # H5开发
   pnpm dev:h5
   ```

2. **代码规范检查**
   ```bash
   # 代码检查
   pnpm lint
   
   # 自动修复
   pnpm lint:fix
   
   # 类型检查
   pnpm type-check
   ```

3. **构建部署**
   ```bash
   # 微信小程序构建
   pnpm build:mp-weixin
   
   # H5构建
   pnpm build:h5
   
   # App构建
   pnpm build:app
   ```

## 🎯 开发指南

### 新建页面

1. 在 `src/pages/` 或 `src/pages-sub/` 目录下创建页面文件夹
2. 创建 `index.vue` 文件作为页面主组件
3. 在 `pages.config.ts` 中配置路由
4. 根据需要创建相关类型和工具函数

### 新建组件

1. 在 `src/components/` 目录下创建组件文件夹
2. 组件文件命名使用大驼峰，如 `UserCard.vue`
3. 使用 `<script setup lang="ts">` 语法
4. 定义清晰的 Props 和 Emits 接口

### 状态管理

1. 在 `src/store/` 目录下创建对应的 store 文件
2. 使用 `defineStore` 定义 store
3. 合理划分模块，避免 store 过大
4. 使用持久化存储时注意敏感信息加密

## 🔧 技术栈

- **前端框架**: UniApp Vue3
- **编程语言**: TypeScript
- **构建工具**: Vite
- **状态管理**: Pinia
- **样式方案**: UnoCSS + SCSS
- **组件库**: Sard-Uniapp
- **网络请求**: Alova + TanStack Vue Query
- **代码规范**: ESLint + Prettier

## 📁 项目结构

```
pivot-ui/
├── src/                    # 源代码目录
│   ├── api/               # API接口定义
│   ├── components/        # 全局组件
│   ├── hooks/             # 自定义hooks
│   ├── http/              # 网络请求配置
│   ├── layouts/           # 布局组件
│   ├── pages/             # 主包页面
│   ├── pages-sub/         # 分包页面
│   ├── service/           # 业务逻辑服务
│   ├── static/            # 静态资源
│   ├── store/             # 状态管理
│   ├── style/             # 全局样式
│   └── utils/             # 工具函数
├── docs/                  # 开发文档
├── env/                   # 环境配置
└── ...
```

## 🚨 注意事项

### 环境变量

项目使用环境变量进行配置，主要文件：
- `.env` - 基础配置
- `.env.development` - 开发环境
- `.env.production` - 生产环境
- `.env.test` - 测试环境

### 平台差异

- **微信小程序**: 注意微信特有的API和限制
- **H5**: 可以使用更多的Web API
- **App**: 注意原生功能的权限申请

### 性能优化

- 合理使用分包加载
- 图片资源使用CDN
- 避免大文件打包到主包
- 使用懒加载和虚拟滚动

## 📞 支持

如果在开发过程中遇到问题：

1. 首先查阅 [开发规范](开发规范.md) 或 [Development Standards](DEVELOPMENT_STANDARDS.md)
2. 检查项目中的示例代码
3. 查看相关技术文档
4. 联系项目维护者

## 🔄 更新日志

### 2025-08-01
- 初始化开发规范文档
- 添加中英文双语规范
- 完善项目结构和最佳实践

---

**Happy Coding! 🚀**