Skip to content
NatsusomekeishiPublic

About

一款精心设计的情侣打卡奖励应用,旨在通过游戏化的方式帮助用户管理双方日常任务、培养良好习惯,并记录生活点滴。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Starlight (星光小宋)

Version License Python Flask

一个基于 Flask 的游戏化任务管理与生活记录系统

功能特性 • 安装指南 • 使用说明 • 技术栈 • 关于作者


📖 项目介绍

Starlight (星光小宋) 是一款精心设计的情侣打卡奖励应用,旨在通过游戏化的方式帮助用户管理双方日常任务、培养良好习惯,并记录生活点滴。系统采用积分奖励机制,将枯燥的待办事项转化为有趣的挑战,通过完成任务获取积分(星光),并在积分商城兑换心仪的奖励。

本项目目前版本为 v1.3.1,由 Keishi 开发,采用 GPL-3.0 开源许可证。

✨ 功能特性

🎯 任务管理系统 (Task System)

  • 多样化任务类型:支持普通任务、限时任务、重复任务(每日/每周特定日期)。
  • 积分激励:为每个任务设定奖励积分,完成即可获得;未完成重要任务会有惩罚扣分机制。
  • 打卡机制:支持图文打卡,记录任务完成瞬间。
  • 智能审核:支持自动通过或管理员人工审核打卡记录。
  • 时间管理:支持设置任务开始时间、截止时间、有效期范围。

🛍️ 积分商城 (Shop System)

  • 奖励兑换:用户可以使用赚取的积分兑换现实生活中的奖励(如“看电影”、“买零食”等)。
  • 订单管理:完整的订单提交、处理、完成流程。
  • 邮件通知:购买成功及订单完成时自动发送邮件通知。

📊 数据统计与看板 (Dashboard)

  • 个人中心:展示当前积分、等级、头像及近期动态。
  • 统计图表:直观展示任务完成情况、积分收支曲线。
  • 移动端适配:专门针对移动端优化的 UI 设计,支持手机随时随地访问。

🛡️ 管理员后台 (Admin Panel)

  • 用户管理:查看、管理注册用户。
  • 任务管理:创建、编辑、发布任务,设置重复规则。
  • 审核中心:审批用户的任务打卡申请。
  • 商城管理:上架商品、管理库存、处理订单。
  • 问候语配置:自定义不同时间段的温馨提示语。

📱 移动端体验

  • 自动检测移动端设备。
  • 专属移动端登录/注册页面。
  • 响应式布局,操作流畅。

🛠️ 技术栈

本项目基于 Python 生态开发,主要采用以下技术:

  • 后端框架: Flask (v2.3.3)
  • 数据库: SQLite + SQLAlchemy (ORM)
  • 用户认证: Flask-Login
  • 表单验证: Flask-WTF
  • 图像处理: Pillow (用于头像和打卡图片处理)
  • 前端技术: HTML5, CSS3, JavaScript, Bootstrap
  • 其他依赖: 详见 requirements.txt

🚀 安装指南

环境要求

  • Python 3.8 或更高版本
  • pip 包管理工具

快速开始

  1. 克隆项目

    git clone https://github.com/Natsusomekeishi/Starlight.git
    cd Starlight
  2. 创建虚拟环境 (可选但推荐)

    python -m venv venv
    # Windows
    venv\Scripts\activate
    # macOS/Linux
    source venv/bin/activate
  3. 安装依赖

    pip install -r requirements.txt
  4. 初始化配置

    • 项目会自动创建 SQLite 数据库 (starlight.db)。
    • 首次运行时会自动初始化数据库表结构。
  5. 运行应用

    python app.py

    应用将在 http://0.0.0.0:5000 启动。

📝 使用说明

默认管理员账号

首次启动时,系统会自动创建一个默认管理员账号:

  • 用户名: admin
  • 密码: admin123
  • 邮箱: abc@keishi.cn(建议查找替换全文该邮箱)

⚠️ 注意:请在首次登录后立即修改管理员密码以确保安全。

普通用户

  1. 访问首页注册账号。
  2. 登录后进入仪表盘查看今日任务。
  3. 点击任务进行打卡(支持上传图片)。
  4. 在积分商城查看并兑换商品。

管理员

  1. 使用管理员账号登录。
  2. 点击顶部导航栏进入“管理后台”。
  3. 在后台进行任务发布、商品上架、打卡审核等操作。

📄 许可证

本项目采用 GPL-3.0 许可证。详情请参阅 LICENSE 文件。

👤 作者

Keishi


Made with ❤️ by Keishi

About

一款精心设计的情侣打卡奖励应用,旨在通过游戏化的方式帮助用户管理双方日常任务、培养良好习惯,并记录生活点滴。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages