# zezebaby

**Repository Path**: hb123214/zezebaby

## Basic Information

- **Project Name**: zezebaby
- **Description**: 模仿美柚【喂养记录】做的一个app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宝宝记（Zezebaby）

宝宝成长记录应用，支持喂养、护理、睡眠、生长曲线、家庭共享等功能。参考美柚「宝宝记」产品能力，自研实现。

## 项目结构

```
zezebaby/
├── zezebaby-server/     # Spring Boot 后端 API
├── zezebaby-web/        # React + Vite 前端（PWA / Android Capacitor）
├── zezebaby-miniapp/    # Taro 微信小程序
├── docs/                # 规范与功能文档（入口见 docs/README.md）
├── CLAUDE.md            # AI 开发指引（构建命令、架构摘要）
└── AGENTS.md            # Cursor Agent 工作规范
```

## 技术栈

| 层 | 技术 |
|---|---|
| 后端 | Java 17 · Spring Boot 3.2 · MyBatis-Plus · MySQL 8 · Redis · Flyway · JWT |
| Web 前端 | React 19 · Vite 8 · antd-mobile · TanStack Query · Zustand · Capacitor |
| 小程序 | Taro 4 · React 18 · NutUI · TypeScript |
| 图表 | Recharts（WHO 生长百分位曲线） |

## 快速开始

### 1. 基础设施

启动 MySQL（端口 3306）和 Redis（端口 6379）。开发环境默认：`root` / 无密码，数据库名 `zezebaby`。

### 2. 后端

```bash
cd zezebaby-server
mvn spring-boot:run -Dspring-boot.run.profiles=dev
```

- 服务地址：http://localhost:8081
- Swagger UI：http://localhost:8081/swagger-ui/index.html
- 首次启动 Flyway 自动建表

### 3. Web 前端

```bash
cd zezebaby-web
npm install
npm run dev
```

- 开发地址：http://localhost:5173（API 代理至 8081）

### 4. 微信小程序

```bash
cd zezebaby-miniapp
npm install
npm run dev:weapp
```

用微信开发者工具打开 `dist/` 目录预览。

## 文档索引

| 文档 | 说明 |
|------|------|
| [docs/README.md](docs/README.md) | 文档总览与维护规则 |
| [docs/features.md](docs/features.md) | 系统功能说明书 |
| [docs/architecture.md](docs/architecture.md) | 系统架构设计 |
| [docs/api-conventions.md](docs/api-conventions.md) | API 设计规范 |
| [docs/backend-conventions.md](docs/backend-conventions.md) | 后端代码规范 |
| [docs/tech-stack.md](docs/tech-stack.md) | 前端技术栈详情 |
| [zezebaby-web/CONVENTIONS.md](zezebaby-web/CONVENTIONS.md) | Web 前端代码规范 |
| [docs/progress.md](docs/progress.md) | 开发进度 |
| [zezebaby.md](zezebaby.md) | 原始需求参考文档 |

## 开发规范要点

- **API 统一前缀**：`/api/v1`，响应格式 `{ code, message, data }`
- **权限控制**：所有宝宝数据接口须 `@CheckBabyAccess` 校验家庭成员身份
- **功能变更**：新增或修改功能逻辑时同步更新 `docs/features.md`
- **数据库变更**：通过 Flyway 迁移脚本，禁止手动改表
- **前端日期格式**：禁止 `toISOString()`，统一用 dayjs（详见 CONVENTIONS.md）

## 许可证

私有项目，未开源。