# MyTimeCaplsule

**Repository Path**: linuxoi/my-time-caplsule

## Basic Information

- **Project Name**: MyTimeCaplsule
- **Description**: No description available
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# My Time Capsule

A Flask-based time capsule web application that allows users to create, store, and receive personalized time capsule content at a future specific time.

## Features

- **User Authentication**: Registration, login
- **Time Capsule Creation**: Write text, select signature templates
- **Scheduled Delivery**: Set a future time point, the system will automatically send the time capsule content at the specified time
- **Email Notifications**: Receive time capsule content via email
- **Backend Management**: View and manage all time capsules (admin function)

## Technology Stack

- **Backend**: Python Flask
- **Authentication**: Flask-Login, Flask-Bcrypt
- **Scheduled Tasks**: APScheduler
- **Email Service**: SMTP Email Sending
- **Database**: SQLite

## Project Structure

```
my-time-caplsule/
├── main.py                
├── web_ui_se.py           
├── models.py              
├── scheduler.py           
├── mailer.py              
├── email_templates.py     
├── time_capsule.db        
├── email_config.enc.json  
├── admin_pass.hash        
└── requirements.txt       
```

## Installation and Running

### 1. Install Dependencies

```bash
pip install -r requirements.txt
```

### 2. Start Application Locally

```bash
python web_ui_se.py
```

Application will start at http://localhost:5000.

## Usage Instructions

### User Registration and Login
1. Visit the application homepage
2. Click "Register" button to create an account
3. Log in with the registered account

### Create Time Capsule
1. Click "Create Time Capsule" after logging in
2. Fill in the capsule content
3. Set the future opening time
4. Save the time capsule

### Receive Time Capsule
- When the set time is reached, the system will automatically send an email notification to the user
- The user can view the time capsule content via the link in the email

### Manage Time Capsules
- After logging in, you can view all time capsules you have created
- Admin can access the backend to manage all time capsules

### Database Models

Main data models include:
- User：User information
- TimeCapsule：Time capsule content and metadata

## Security Considerations

- Passwords are encrypted and stored using Flask-Bcrypt
- Email configuration files are saved in encrypted format
- Regularly backup the database file

## License

MIT License