# life

**Repository Path**: seeeyoume/life

## Basic Information

- **Project Name**: life
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-18
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 活着么 - 每日打卡应用

一个基于uniapp开发的跨平台打卡应用，帮助用户记录每日生活状态，设置打卡提醒，防止忘记打卡。

## 功能特性

### 🔐 用户认证
- 用户登录/退出功能
- 简单的用户名密码验证
- 登录状态持久化

### 📅 打卡功能
- 每日打卡记录
- 实时打卡状态显示
- 打卡时间记录
- 今日打卡状态提醒

### 📊 数据统计
- 累计打卡天数统计
- 连续打卡天数统计
- 月度打卡日历视图
- 打卡趋势图表
- 详细打卡记录查看

### ⚙️ 智能提醒
- 连续未打卡报警设置
- 自定义报警天数（1-10天）
- 每日提醒时间设置
- 提醒功能开关控制

## 技术栈

- **前端框架**: Vue 3 + Composition API
- **开发框架**: uniapp (支持多端发布)
- **UI组件**: 原生uniapp组件 + 自定义样式
- **状态管理**: Vue 3响应式API
- **数据存储**: 本地存储(localStorage)
- **构建工具**: Vite

## 项目结构

```
huozheme-app/
├── pages/                 # 页面文件
│   ├── index/            # 首页（打卡页面）
│   ├── login/            # 登录页面
│   ├── statistics/       # 统计页面
│   └── settings/         # 设置页面
├── static/               # 静态资源
│   └── tabbar/          # 底部导航图标
├── App.vue              # 应用入口
├── main.js              # 主入口文件
├── manifest.json        # 应用配置文件
├── pages.json           # 页面路由配置
├── uni.scss             # 全局样式变量
└── package.json         # 项目依赖配置
```

## 快速开始

### 环境要求

- Node.js >= 16.0.0
- npm >= 8.0.0
- HBuilderX (推荐) 或 命令行工具

### 安装依赖

```bash
npm install
```

### 开发运行

```bash
# 微信小程序开发
npm run dev:mp-weixin

# H5开发
npm run dev:h5

# App开发
npm run dev:app
```

### 构建发布

```bash
# 构建生产版本
npm run build

# 构建指定平台
npm run build:mp-weixin
npm run build:h5
npm run build:app
```

## 页面功能说明

### 登录页面 (`/pages/login/login`)
- 用户登录界面
- 简单的用户名密码验证
- 登录状态检查
- 注册功能提示

### 首页 (`/pages/index/index`)
- 用户信息显示
- 今日打卡状态
- 快速打卡按钮
- 打卡统计概览
- 最近打卡记录
- 退出登录功能

### 统计页面 (`/pages/statistics/statistics`)
- 打卡数据概览
- 月度打卡日历
- 打卡趋势图表
- 详细记录列表

### 设置页面 (`/pages/settings/settings`)
- 打卡提醒设置
- 报警天数配置
- 提醒时间设置
- 数据管理功能
- 应用信息显示

## 核心功能实现

### 打卡记录管理
- 使用本地存储保存打卡记录
- 支持30天内的打卡数据
- 自动初始化最近30天的记录
- 实时更新打卡状态

### 连续打卡计算
- 基于日期顺序计算连续打卡
- 支持跨月连续打卡统计
- 实时更新连续天数

### 报警提醒机制
- 基于连续未打卡天数触发报警
- 可配置报警阈值
- 应用启动时自动检查
- 支持提醒功能开关

## 数据存储结构

### 用户信息
```javascript
{
  username: '用户名',
  loginTime: 时间戳
}
```

### 打卡记录
```javascript
[
  {
    date: '日期字符串',
    punched: true/false,
    time: '打卡时间'
  }
]
```

### 应用设置
```javascript
{
  alertDays: 3,           // 报警天数
  remindTime: '20:00',    // 提醒时间
  remindEnabled: true     // 提醒开关
}
```

## 自定义配置

### 修改主题颜色
在 `uni.scss` 中修改颜色变量：

```scss
$uni-primary: #你的主色;
$uni-success: #你的成功色;
$uni-warning: #你的警告色;
$uni-error: #你的错误色;
```

### 修改底部导航
在 `pages.json` 中配置tabBar：

```json
"tabBar": {
  "color": "#7A7E83",
  "selectedColor": "#3cc51f",
  "list": [
    {
      "pagePath": "pages/index/index",
      "text": "打卡"
    }
  ]
}
```

## 多端适配

应用基于uniapp开发，支持以下平台：

- ✅ 微信小程序
- ✅ H5网页
- ✅ App (iOS/Android)
- ✅ 支付宝小程序
- ✅ 百度小程序
- ✅ 字节跳动小程序

## 开发注意事项

1. **数据持久化**: 当前使用本地存储，生产环境建议接入后端API
2. **用户认证**: 当前为简单验证，生产环境需要接入正式认证系统
3. **推送通知**: 报警提醒目前为应用内提醒，可扩展为推送通知
4. **数据备份**: 建议增加云端备份功能
5. **多用户支持**: 当前为单用户版本，可扩展为多用户

## 版本计划

### v1.0.0 (当前版本)
- 基础打卡功能
- 数据统计展示
- 报警提醒设置
- 本地数据存储

### v1.1.0 (规划中)
- 云端数据同步
- 多设备支持
- 推送通知
- 数据导出功能

### v1.2.0 (规划中)
- 社交功能
- 打卡排行榜
- 自定义打卡目标
- 更多统计图表

## 贡献指南

欢迎提交Issue和Pull Request来帮助改进这个项目。

## 许可证

MIT License

## 联系方式

- 项目主页: [GitHub Repository]
- 问题反馈: [Issues]
- 邮箱: support@huozheme.com

---

**活着么** - 记录生活，提醒活着 💪