# 宠王来了

**Repository Path**: whstruts/pet

## Basic Information

- **Project Name**: 宠王来了
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宠王来了 - 一站式宠物全生命周期智能服务平台

## 项目简介

"宠王来了"是国内首个一站式宠物全生命周期信息服务平台，聚焦宠物主"服务分散、健康管理复杂、专业资源稀缺"核心痛点，整合领养寄养、AI健康、知识科普、内容社区、职业教育五大核心模块，构建"服务-健康-成长-交流"一体化生态。

## 核心亮点

### 技术与产品创新
- **AI智能问诊**: 多模态宠物AI大模型，诊断准确率达90%以上
- **健康管理工具**: 五大工具矩阵，实现科学养宠数字化
- **一站式服务生态**: 覆盖领养寄养、托运、寻宠、美容、殡葬全场景

### 行业领先性
- 国内首个整合宠物服务、AI健康、内容社区、职业教育的综合型平台
- 在AI问诊精准度、健康工具场景化、服务生态完整性三方面处于行业领先水平

## 技术架构

### 技术栈

**前端**
- 移动端: React Native / Flutter
- Web端: React 18 + TypeScript + Vite
- 状态管理: Redux Toolkit / Zustand
- UI组件: Ant Design Mobile / Ant Design

**后端**
- 主框架: Node.js + NestJS (TypeScript)
- API网关: Kong / Nginx
- 认证授权: JWT + OAuth2.0
- 实时通信: Socket.io
- 消息队列: RabbitMQ / Apache Kafka

**AI服务**
- AI框架: PyTorch / TensorFlow
- 大模型: GPT-4 / Claude API / 自研多模态模型
- 向量数据库: Milvus / Pinecone
- 图像处理: OpenCV / Pillow
- 语音识别: Whisper / Azure Speech

**数据库**
- 关系型: PostgreSQL 15+
- NoSQL: MongoDB
- 缓存: Redis 7+
- 时序: InfluxDB
- 搜索: Elasticsearch 8+
- 向量: Milvus

**基础设施**
- 容器化: Docker + Kubernetes
- CI/CD: GitHub Actions / GitLab CI
- 监控: Prometheus + Grafana
- 日志: ELK Stack
- 存储: AWS S3 / 阿里云OSS

### 系统架构

```
客户端层 → CDN/WAF → API网关 → 业务服务层/AI服务层/基础服务层
    ↓
数据访问层 → 数据存储层/缓存层/消息队列层 → 外部服务层
```

详细架构设计请参考:
- [技术架构文档](./TECHNICAL_ARCHITECTURE.md)
- [架构图文档](./ARCHITECTURE_DIAGRAMS.md)

## 项目结构

```
pet/
├── docs/                      # 文档目录
│   ├── TECHNICAL_ARCHITECTURE.md
│   └── ARCHITECTURE_DIAGRAMS.md
├── mobile/                    # 移动端应用
│   ├── ios/                   # iOS应用
│   └── android/               # Android应用
├── web/                       # Web应用
│   ├── src/
│   │   ├── components/        # 组件
│   │   ├── pages/            # 页面
│   │   ├── services/         # API服务
│   │   ├── store/            # 状态管理
│   │   └── utils/            # 工具函数
│   ├── package.json
│   └── vite.config.ts
├── backend/                   # 后端服务
│   ├── src/
│   │   ├── modules/          # 业务模块
│   │   │   ├── user/         # 用户模块
│   │   │   ├── pet/          # 宠物模块
│   │   │   ├── ai/           # AI模块
│   │   │   ├── health/       # 健康管理模块
│   │   │   ├── service/      # 服务模块
│   │   │   ├── content/      # 内容模块
│   │   │   ├── community/    # 社区模块
│   │   │   └── education/    # 教育模块
│   │   ├── common/           # 公共模块
│   │   │   ├── auth/         # 认证
│   │   │   ├── database/     # 数据库
│   │   │   ├── cache/        # 缓存
│   │   │   └── queue/        # 消息队列
│   │   └── main.ts
│   ├── package.json
│   └── nest-cli.json
├── ai-service/                # AI服务
│   ├── src/
│   │   ├── models/           # 模型
│   │   ├── services/         # AI服务
│   │   └── utils/            # 工具
│   ├── requirements.txt
│   └── Dockerfile
├── infrastructure/            # 基础设施
│   ├── kubernetes/           # K8s配置
│   ├── docker/               # Docker配置
│   └── terraform/            # 基础设施即代码
├── scripts/                   # 脚本
│   ├── deploy.sh
│   └── test.sh
└── README.md
```

## 快速开始

### 环境要求

- Node.js >= 18.x
- Python >= 3.9
- PostgreSQL >= 15
- Redis >= 7
- Docker & Docker Compose

### 安装依赖

```bash
# 安装后端依赖
cd backend
npm install

# 安装前端依赖
cd ../web
npm install

# 安装AI服务依赖
cd ../ai-service
pip install -r requirements.txt
```

### 配置环境变量

```bash
# 复制环境变量模板
cp backend/.env.example backend/.env
cp web/.env.example web/.env

# 编辑环境变量
vim backend/.env
vim web/.env
```

### 启动服务

```bash
# 启动数据库和缓存
docker-compose up -d

# 启动后端服务
cd backend
npm run start:dev

# 启动前端服务
cd web
npm run dev

# 启动AI服务
cd ai-service
python main.py
```

### 运行测试

```bash
# 后端测试
cd backend
npm run test

# 前端测试
cd web
npm run test
```

## 开发指南

### 代码规范

- 使用ESLint和Prettier进行代码格式化
- 遵循TypeScript严格模式
- 使用Husky进行Git hooks

### 提交规范

遵循Conventional Commits规范:

```
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 重构
test: 测试相关
chore: 构建/工具链相关
```

### 分支策略

- `main`: 主分支，用于生产环境
- `develop`: 开发分支
- `feature/*`: 功能分支
- `bugfix/*`: 修复分支
- `hotfix/*`: 紧急修复分支

## 部署

### Docker部署

```bash
# 构建镜像
docker-compose build

# 启动所有服务
docker-compose up -d
```

### Kubernetes部署

```bash
# 应用配置
kubectl apply -f infrastructure/kubernetes/

# 查看状态
kubectl get pods
```

## 监控

- **应用监控**: http://localhost:3000 (Grafana)
- **日志查看**: http://localhost:5601 (Kibana)
- **链路追踪**: http://localhost:16686 (Jaeger)

## 贡献指南

1. Fork本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启Pull Request

## 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

## 联系我们

- 项目主页: https://www.petking.com
- 技术支持: support@petking.com
- 商务合作: business@petking.com

## 致谢

感谢所有为"宠王来了"项目做出贡献的开发者和合作伙伴。