# poo-tracker

**Repository Path**: thomaslwq/poo-tracker

## Basic Information

- **Project Name**: poo-tracker
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-20
- **Last Updated**: 2026-02-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 💩 今天你屎了么

<div align="center">

一个有趣实用的如厕记录应用，帮助你追踪和改善肠道健康。

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Vue 3](https://img.shields.io/badge/Vue-3.0+-4FC08D?style=flat&logo=vue.js&logoColor=white)](https://vuejs.org/)
[![Vite](https://img.shields.io/badge/Vite-5.0+-646CFF?style=flat&logo=vite&logoColor=white)](https://vitejs.dev/)

</div>

## ✨ 功能特性

- 📝 **记录如厕情况**：记录时间、时长、类型、舒适度和备注
- 📊 **历史记录管理**：查看所有历史记录，支持删除操作
- 📈 **数据统计分析**：多维度数据分析，包括：
  - 总记录数统计
  - 平均如厕时长
  - 平均舒适度评分
  - 本周记录数
  - 类型分布图
- 👥 **分享功能**：生成精美的分享卡片，支持：
  - 保存为图片
  - 复制文本分享
- 💾 **本地存储**：数据安全存储在本地浏览器，无需联网
- 📱 **响应式设计**：完美适配手机、平板和电脑

## 🎯 适用场景

- 追踪肠道健康状况
- 监测饮食对消化系统的影响
- 记录如厕习惯，改善生活方式
- 与医生分享如厕记录
- 有趣的生活记录分享

## 🚀 快速开始

### 环境要求

- Node.js 16.x 或更高版本
- npm 或 yarn 或 pnpm

### 安装

```bash
# 克隆项目
git clone https://gitee.com/thomaslwq/poo-tracker.git
cd poo-tracker

# 安装依赖
npm install
```

### 运行

```bash
# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产版本
npm run preview
```

应用将在 `http://localhost:5173` 启动。

## 📸 功能预览

### 记录页面
- 选择如厕时间和时长
- 选择类型（正常、较硬、较软、腹泻、便秘）
- 评分舒适度（1-5星）
- 添加备注信息

### 统计页面
- 可视化数据展示
- 类型分布进度条
- 多维度统计指标

### 分享功能
- 精美的分享卡片设计
- 一键保存图片
- 快捷复制文本

## 🛠️ 技术栈

- **前端框架**：Vue 3.0+ (Composition API)
- **构建工具**：Vite 5.0+
- **UI 框架**：Bootstrap 5.3
- **图像处理**：html2canvas
- **数据存储**：LocalStorage

## 📁 项目结构

```
poo-tracker/
├── public/              # 静态资源
├── src/
│   ├── components/      # Vue 组件
│   │   ├── RecordForm.vue      # 记录表单组件
│   │   ├── HistoryList.vue     # 历史记录组件
│   │   ├── Statistics.vue      # 统计数据组件
│   │   └── ShareModal.vue      # 分享弹窗组件
│   ├── App.vue          # 根组件
│   ├── main.js          # 入口文件
│   └── style.css        # 全局样式
├── index.html           # HTML 模板
├── package.json         # 项目配置
└── vite.config.js       # Vite 配置
```

## 🎨 设计理念

- **简洁直观**：界面简洁，操作流畅
- **数据可视化**：通过图表直观展示数据
- **隐私保护**：数据仅存储在本地，不上传服务器
- **趣味性**：使用 emoji 增加趣味性，让记录不再枯燥

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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

## 📝 开发计划

- [ ] 添加数据导出功能（CSV/JSON）
- [ ] 支持多用户数据切换
- [ ] 添加提醒功能（定时提醒记录）
- [ ] 增加更多统计图表
- [ ] 支持主题切换（深色/浅色）
- [ ] 添加数据备份和恢复功能
- [ ] 国际化支持（英文、日文等）

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)

## 💬 反馈与建议

如果你有任何问题或建议，欢迎：

- 提交 [Issue](https://gitee.com/thomaslwq/poo-tracker/issues)
- 发送邮件至：your-email@example.com

## 🙏 致谢

感谢所有为本项目贡献代码和建议的开发者！

---

<div align="center">

**⭐ 如果这个项目对你有帮助，请给一个 Star 支持一下！**

Made with ❤️ by ThomasLWQ

</div>