🥝 Kiwi's Schedule

一个现代化、可爱风格的日程管理系统，专为Kiwi设计，支持移动端优化。

✨ 主要功能

• 🎯 用户认证 - 安全的登录系统
• 📝 申请提交 - 用户可以提交包含时间、地址、介绍的日程申请
• 👑 审核系统 - Kiwi（管理员）可以批准或拒绝申请
• 📅 日历视图 - 美观的日历展示所有已批准的日程
• 📱 移动优化 - 完美适配手机和平板设备
• 🎨 现代设计 - 使用Tailwind CSS和HeroIcons的可爱界面

🚀 快速开始

环境要求

• Ruby 3.x
• Rails 8.x
• PostgreSQL
• Node.js (for asset compilation)

安装步骤

1. 克隆仓库

git clone <repository-url>
cd hikiwiz

2. 安装依赖

bundle install

3. 数据库设置

rails db:create
rails db:migrate
rails db:seed

4. 启动服务器

rails server

5. 访问应用 打开浏览器访问 http://localhost:3000

👥 默认用户账户

种子数据会创建以下测试账户：

管理员账户 (Kiwi)

• 邮箱: [email protected]
• 密码: password
• 权限: 可以审核所有申请

普通用户账户

• 小明: [email protected] / password
• 小红: [email protected] / password
• 权限: 可以提交和管理自己的申请

📋 使用指南

对于普通用户

1. 登录系统

   • 使用邮箱和密码登录

2. 提交申请

   • 点击"提交新申请"
   • 填写活动标题、详细介绍、地点和时间
   • 提交后等待Kiwi审核

3. 查看我的申请

   • 在"我的申请"页面查看所有申请状态
   • 可以编辑待审核的申请
   • 查看详细信息

4. 浏览日历

   • 查看所有已批准的活动
   • 日历视图清晰展示时间安排

对于管理员 (Kiwi)

1. 审核申请

   • 访问"审核面板"
   • 查看所有待审核申请的详细信息
   • 批准或拒绝申请

2. 管理所有申请

   • 查看所有用户的申请记录
   • 按状态筛选申请

🎨 界面特色

• 可爱动画 - 🥝 图标会可爱地弹跳
• 渐变背景 - 从粉色到紫色的美丽渐变
• 玻璃效果 - 半透明的毛玻璃视觉效果
• 响应式设计 - 完美适配所有设备尺寸
• HeroIcons图标 - 现代化的图标系统
• 状态颜色 - 直观的颜色编码显示申请状态

🔧 技术栈

• 后端: Ruby on Rails 8.0
• 前端: Tailwind CSS, Stimulus
• 数据库: PostgreSQL
• 认证: Rails内置的has_secure_password
• 图标: HeroIcons
• 部署: 支持Docker和Kamal

📱 移动端优化

• 响应式导航菜单
• 触摸友好的按钮和链接
• 优化的表单输入
• 移动端日历视图
• 快速操作按钮

🛡️ 安全特性

• 密码加密存储
• CSRF保护
• 用户权限验证
• SQL注入防护
• XSS攻击防护

📈 申请状态流程

用户提交申请 → 待审核 (pending)
                    ↓
            Kiwi审核决定
                ↙      ↘
        批准 (approved)  拒绝 (rejected)

🎯 核心功能说明

申请管理

• 用户只能编辑和删除自己的申请
• 已批准/拒绝的申请编辑后会重置为待审核状态
• 申请包含标题、描述、地点、开始时间、结束时间

审核系统

• 只有管理员可以批准/拒绝申请
• 批准的申请会显示在公共日历中
• 支持快速批量操作

日历功能

• 只显示已批准的申请
• 支持月视图
• 点击事件查看详情
• 时间冲突提示

🌟 未来规划

• 邮件通知系统
• 批量操作功能
• 导出日历功能
• 移动端App
• 多语言支持
• 主题定制

🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🎉 特别鸣谢

感谢所有为这个可爱的Kiwi日程系统做出贡献的开发者！

---

💝 为Kiwi特别制作，带着爱与关怀 🥝