# ceshi

**Repository Path**: nelson_Q/ceshi

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 军旅倒计时小程序 - 说明文档

## 一、项目规划

### 1.1 项目概述
本项目是一款面向军人或军事爱好者的时间管理小程序，主要功能包括退役倒计时和在役时长统计，采用军旅主题设计风格，提供直观的时间数据展示。

### 1.2 功能规划
- **自定义退役时间设置**：允许用户输入或选择具体的退役日期和时间
- **退役倒计时显示**：精确到天、小时、分钟的实时倒计时
- **入伍时间设置**：支持用户设置入伍日期
- **在役时长计算**：基于入伍时间和当前时间，精确到天的累计在役时长
- **数据本地存储**：保存用户设置的时间信息，下次打开自动恢复
- **军旅风格界面**：符合军事主题的UI设计，清晰易读

### 1.3 技术栈
- 开发语言：Python
- GUI框架：Tkinter（内置库，无需额外安装）
- 数据存储：JSON文件本地存储
- 时间处理：Python datetime库

### 1.4 开发计划
- **2025-10-27**：项目初始化，创建目录结构和说明文档
- **2025-10-27**：实现核心时间计算模块
- **2025-10-27**：开发数据存储和读取功能
- **2025-10-27**：设计并实现军旅风格用户界面
- **2025-10-27**：完成测试和功能整合
- **2025-10-27**：优化用户体验和性能

## 二、实施方案

### 2.1 模块划分
- **utils/time_utils.py**：时间计算核心模块
- **data/storage_manager.py**：数据存储管理模块
- **ui/main_window.py**：主界面设计和交互逻辑
- **ui/style_config.py**：界面样式配置（军旅主题）
- **main.py**：程序入口和初始化

### 2.2 核心算法
- **倒计时计算**：使用datetime模块计算当前时间与退役时间的差值
- **在役时长计算**：计算入伍时间到当前时间的天数差
- **实时更新**：使用Tkinter的after方法实现周期性更新

### 2.3 数据存储设计
- 使用JSON格式保存用户设置
- 存储字段：入伍日期、退役日期和时间、用户偏好设置
- 文件位置：程序目录下的data文件夹

### 2.4 界面设计
- **主色调**：军绿色、深蓝色为主色调
- **字体**：选用清晰易读的等宽字体，类似军事文档风格
- **布局**：简洁明了，突出显示倒计时和在役时长
- **交互**：直观的日期选择器，清晰的按钮和输入框

## 三、进度记录

### 3.1 已完成工作
- [x] 2023-05-20：创建项目目录结构
- [x] 2023-05-20：实现time_utils.py中的时间计算功能
- [x] 2023-05-20：实现storage_manager.py中的存储管理功能
- [x] 2023-05-20：实现style_config.py和main_window.py界面设计
- [x] 2023-05-20：创建app.py入口脚本
- [x] 2023-05-20：创建requirements.txt配置文件
- [x] 2024-10-28：修复窗口样式错误 - 成功解决"unknown option '-font'"错误，移除了所有apply_style调用，改为直接配置组件样式
- [x] 2025-10-27：创建微信小程序版本 - wx_miniapp目录及所有核心文件

### 3.2 项目进度记录

| 时间节点       | 完成任务                 | 结果说明                                 |
|----------------|--------------------------|------------------------------------------|
| 2024-10-28     | 项目文件基本创建完成     | 完成核心功能模块实现，正在进行最终整合与测试 |
| 2024-10-28     | 修复窗口样式错误         | 成功解决"unknown option '-font'"错误，移除了所有apply_style调用，改为直接配置组件样式 |
| 2025-10-27     | 微信小程序版本开发完成   | 实现了所有核心功能，包括自定义时间设置、在役天数计算和退役倒计时 |

### 3.3 备注
本项目同时提供Python桌面版和微信小程序版。微信小程序版位于wx_miniapp目录，已实现所有要求的功能。使用前请确保在wx_miniapp/images目录添加国旗图片(flag.png)。