# time-guard

**Repository Path**: littleluoCode/time-guard

## Basic Information

- **Project Name**: time-guard
- **Description**: 让时间管理回归本质 - 一款专注隐私安全的跨平台工时记录工具，助您精准掌控工作节奏，智能规划生活安排。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-03
- **Last Updated**: 2025-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🕰️ TimeGuard 智能工时管理系统

![开发状态](https://img.shields.io/badge/status-α版开发中-orange)
![技术栈](https://img.shields.io/badge/stack-Vue3%2BElectron%2BCapacitor-blue)

## 📖 项目简介
**TimeGuard** 是一款面向现代职场人的隐私优先型工时管理工具，致力于解决以下核心问题：
- 🔐 **数据隐私焦虑**：本地加密存储 + 零云端传输
- ⏰ **工时统计模糊**：智能识别有效工作时间
- 📱 **多端体验割裂**：一套代码实现六大平台覆盖
- 🧠 **规划建议缺失**：基于工作时长的智能休闲推荐

---

## 🛠 技术栈全景

### 核心架构
```mermaid
pie
    title 技术栈分布
    "Vue3生态" : 45
    "Electron" : 25
    "Capacitor" : 15
    "安全体系" : 10
    "构建工具" : 5
```

### 技术矩阵
| 分类         | 技术选型                 | 版本     | 状态       |
|--------------|-------------------------|---------|-----------|
| **前端框架** | Vue3 + Composition API  | 3.5.13  | ✅ 稳定    |
| **状态管理** | Pinia                   | 3.0.1   | 🚧 开发中  |
| **桌面端**   | Electron                | 28.3.2  | ✅ 稳定    |
| **移动端**   | Capacitor               | 7.0.1   | 🚧 调试中  |
| **数据库**   | SQLCipher               | 4.5.4   | ✅ 完成    |
| **安全加密** | CryptoJS                | 4.1.1   | ✅ 完成    |
| **构建工具** | Vite                    | 6.2.0   | ✅ 稳定    |

---

## 🌳 项目结构树（开发版）

```mermaid
graph TD
    A[📦 time-guard] --> B[📂 src]
    A --> C[📂 electron]
    A --> D[📂 capacitor]
    A --> E[📂 config]
    
    B --> F[📁 core]
    F --> F1[📄 countdown.ts]
    F --> F2[📄 encryption.ts]
    
    B --> G[📁 modules]
    G --> G1[📁 shift]
    G --> G2[📁 stats]
    G --> G3[📁 settings]
    
    C --> H[📄 main.ts]
    C --> I[📄 preload.ts]
    
    D --> J[📁 android]
    D --> K[📁 ios]
    
    E --> L[📁 env]
    E --> M[📁 build]
    
    classDef dev fill:#fff3cd,stroke:#ffe69c;
    class G1,G3,J,K dev;
```

### 开发进度标记
- 🟢 绿色：已完成模块（SQLCipher集成、核心计时器）
- 🟡 黄色：开发中模块（移动端适配、设置模块）
- 🔴 红色：待开发模块（数据同步引擎、多语言支持）

---

## 📂 完整目录结构

```bash
time-guard/
├── 📂 src/                 # 主代码库
│   ├── 📁 core/            # 核心逻辑
│   │   ├── scheduler/      # 排班算法 🟡
│   │   └── security/       # 加密模块 🟢
│   ├── 📁 native/          # 原生适配
│   │   ├── electron/       # 桌面功能 🟢
│   │   └── mobile/         # 移动功能 🟡
│   └── 📁 web/             # 前端核心
│       ├── api/            # 接口管理 🟢
│       └── hooks/          # 组合式API 🟢
│
├── 📂 electron/            # 桌面端代码
│   ├── main.ts             # 主进程 🟢
│   └── preload/            # 桥接模块 🟡
│
├── 📂 capacitor/           # 移动端配置
│   ├── android/            # Android工程 🟡
│   └── ios/                # iOS工程 🔴
│
├── 📂 config/              # 项目配置
│   ├── vite/               # 构建配置 🟢
│   └── electron/           # 打包配置 🟡
│
└── 📂 docs/                # 项目文档
    ├── ARCHITECTURE.md     # 架构设计 🟢
    └── CONTRIBUTING.md     # 贡献指南 🟡
```

---

## 🚧 开发注意事项

### 环境配置
```bash
# 解决Electron安装问题
ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" \
yarn config set electron_mirror ${ELECTRON_MIRROR}
```

### 代码规范
```bash
# 提交前自动修复
npx lint-staged

# 标准化提交示例
git commit -m "feat(core): 实现动态倒计时算法 [WIP]"
```

---

## 🌟 核心优势
```mermaid
graph LR
    A[零数据上传] --> B[隐私安全]
    C[原生性能] --> D[流畅体验]
    E[智能算法] --> F[精准统计]
    B --> G{用户信任}
    D --> G
    F --> G
```
---

_让每一次敲击都产生价值，让每一分钟都值得记录_ 💻⏳