Starlight (星光小宋) 是一款精心设计的情侣打卡奖励应用,旨在通过游戏化的方式帮助用户管理双方日常任务、培养良好习惯,并记录生活点滴。系统采用积分奖励机制,将枯燥的待办事项转化为有趣的挑战,通过完成任务获取积分(星光),并在积分商城兑换心仪的奖励。
本项目目前版本为 v1.3.1,由 Keishi 开发,采用 GPL-3.0 开源许可证。
- 多样化任务类型:支持普通任务、限时任务、重复任务(每日/每周特定日期)。
- 积分激励:为每个任务设定奖励积分,完成即可获得;未完成重要任务会有惩罚扣分机制。
- 打卡机制:支持图文打卡,记录任务完成瞬间。
- 智能审核:支持自动通过或管理员人工审核打卡记录。
- 时间管理:支持设置任务开始时间、截止时间、有效期范围。
- 奖励兑换:用户可以使用赚取的积分兑换现实生活中的奖励(如“看电影”、“买零食”等)。
- 订单管理:完整的订单提交、处理、完成流程。
- 邮件通知:购买成功及订单完成时自动发送邮件通知。
- 个人中心:展示当前积分、等级、头像及近期动态。
- 统计图表:直观展示任务完成情况、积分收支曲线。
- 移动端适配:专门针对移动端优化的 UI 设计,支持手机随时随地访问。
- 用户管理:查看、管理注册用户。
- 任务管理:创建、编辑、发布任务,设置重复规则。
- 审核中心:审批用户的任务打卡申请。
- 商城管理:上架商品、管理库存、处理订单。
- 问候语配置:自定义不同时间段的温馨提示语。
- 自动检测移动端设备。
- 专属移动端登录/注册页面。
- 响应式布局,操作流畅。
本项目基于 Python 生态开发,主要采用以下技术:
- 后端框架: Flask (v2.3.3)
- 数据库: SQLite + SQLAlchemy (ORM)
- 用户认证: Flask-Login
- 表单验证: Flask-WTF
- 图像处理: Pillow (用于头像和打卡图片处理)
- 前端技术: HTML5, CSS3, JavaScript, Bootstrap
- 其他依赖: 详见
requirements.txt
- Python 3.8 或更高版本
- pip 包管理工具
-
克隆项目
git clone https://github.com/Natsusomekeishi/Starlight.git cd Starlight -
创建虚拟环境 (可选但推荐)
python -m venv venv # Windows venv\Scripts\activate # macOS/Linux source venv/bin/activate
-
安装依赖
pip install -r requirements.txt
-
初始化配置
- 项目会自动创建 SQLite 数据库 (
starlight.db)。 - 首次运行时会自动初始化数据库表结构。
- 项目会自动创建 SQLite 数据库 (
-
运行应用
python app.py
应用将在
http://0.0.0.0:5000启动。
首次启动时,系统会自动创建一个默认管理员账号:
- 用户名:
admin - 密码:
admin123 - 邮箱:
abc@keishi.cn(建议查找替换全文该邮箱)
⚠️ 注意:请在首次登录后立即修改管理员密码以确保安全。
- 访问首页注册账号。
- 登录后进入仪表盘查看今日任务。
- 点击任务进行打卡(支持上传图片)。
- 在积分商城查看并兑换商品。
- 使用管理员账号登录。
- 点击顶部导航栏进入“管理后台”。
- 在后台进行任务发布、商品上架、打卡审核等操作。
本项目采用 GPL-3.0 许可证。详情请参阅 LICENSE 文件。
Keishi
- GitHub: @Natsusomekeishi
- Email: hello@keishi.cn
Made with ❤️ by Keishi