# kidsmind

**Repository Path**: china_darksheep/kidsmind

## Basic Information

- **Project Name**: kidsmind
- **Description**: 使用cursor开发的儿童思维训练网站（不完整版）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-09
- **Last Updated**: 2025-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KidsMind - 儿童思维训练平台

## 项目概述

KidsMind是一个专为3-8岁儿童设计的思维训练平台，提供认知能力、记忆力和逻辑思维训练游戏。该平台采用PHP开发，使用了简洁的模板结构，便于维护和扩展。

## 系统要求

- PHP 7.0+
- Nginx
- MySQL 5.6+

## Nginx伪静态配置

为了支持干净URL（不带.php后缀的URL），需要在Nginx配置中添加以下伪静态规则。这些规则将确保类似`http://domain.com/index`的URL能够正确地映射到`index.php`文件。

```nginx
# Nginx配置示例
server {
    listen 80;
    server_name your-domain.com;  # 替换为您的域名
    root /path/to/phpts/data/wwwroot;  # 替换为您的网站根目录
    index index.php index.html;

    # 日志配置
    access_log /path/to/logs/access.log;
    error_log /path/to/logs/error.log;

    # 伪静态规则
    location / {
        try_files $uri $uri/ @rewrite;
    }

    location @rewrite {
        # 处理主页请求
        rewrite ^/$ /index.php last;
        
        # 处理没有扩展名的URL，映射到对应的PHP文件
        rewrite ^/([^/]+)/?$ /$1.php last;
    }

    # 处理PHP文件
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;  # 更改为您的PHP-FPM socket
        # 或者使用TCP连接：
        # fastcgi_pass 127.0.0.1:9000;
        
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 禁止访问隐藏文件
    location ~ /\. {
        deny all;
    }
}
```

## PHPTS环境特殊配置

如果您使用的是PHPTS虚拟环境，您可以采用以下方法之一：

### 方法一：修改PHPTS中的Nginx配置

PHPTS环境中的Nginx配置文件通常位于如下位置之一：
- `C:\phpts\nginx\conf\nginx.conf`（主配置文件）
- `C:\phpts\nginx\conf\vhost\*.conf`（虚拟主机配置文件）

找到您网站对应的server块配置，然后添加以下规则：

```nginx
# 伪静态规则 - 添加到server块中
location / {
    try_files $uri $uri/ @rewrite;
}

location @rewrite {
    # 处理主页请求
    rewrite ^/$ /index.php last;
    
    # 处理没有扩展名的URL，映射到对应的PHP文件
    rewrite ^/([^/]+)/?$ /$1.php last;
}
```

### 方法二：使用独立的伪静态规则文件

如果您不想修改主配置文件，可以创建一个独立的规则文件并在主配置中引用它：

1. 将项目根目录中的`nginx_rewrite.conf`文件放在网站根目录下
2. 在server块中添加：
```nginx
include /path/to/nginx_rewrite.conf;
```

### 方法三：使用PHPTS控制面板（如果有）

如果PHPTS提供了控制面板，通常会有"伪静态"设置选项，您可以直接粘贴以下规则：

```
location / {
    try_files $uri $uri/ @rewrite;
}

location @rewrite {
    rewrite ^/$ /index.php last;
    rewrite ^/([^/]+)/?$ /$1.php last;
}
```

完成配置后，重启Nginx服务：

```bash
# 在PHPTS环境中，通常可以通过控制面板重启
# 或者使用命令行：
C:\phpts\nginx\nginx.exe -s reload
```

## 项目结构

```
/
├── config/               # 配置文件
├── includes/             # 公共包含文件
│   ├── header.php        # 网站头部
│   ├── footer.php        # 网站底部
│   └── init.php          # 初始化文件
├── pages/                # 页面文件
├── assets/               # 静态资源
│   ├── css/              # 样式文件
│   ├── js/               # JavaScript文件
│   └── images/           # 图片资源
├── index.php             # 入口文件
└── router.php            # 用于PHP内置服务器的路由文件
```

## 本地开发环境

在本地开发环境中，您可以使用PHP内置服务器配合router.php文件来模拟Nginx的URL重写功能：

```bash
php -S localhost:8000 router.php
```

这样就可以在不配置完整Nginx服务器的情况下测试干净URL。

## 功能特点

- **分龄段训练**：根据3-4岁、5-6岁、7-8岁不同年龄段儿童的认知特点，提供对应的题型和难度。
- **多样化题型**：形状识别、记忆卡牌、拼图游戏、连线游戏等多种互动题型。
- **即时反馈**：每道题完成后提供即时反馈，包括动画效果和星星奖励。
- **成就系统**：记录学习统计、技能进度、徽章成就和活动记录。
- **会员权益**：不同级别会员享受不同的使用权限和学习资源。
- **家长管理**：家长可查看孩子的学习进度和成就，获取针对性的学习建议。
- **管理后台**：全面的管理员后台，支持用户管理、游戏管理、成就管理和数据统计。

## 技术栈

- 前端: HTML5, CSS3, JavaScript, Bootstrap 5
- 后端: PHP 7.4+
- 数据库: MySQL 5.7+
- 服务器: Nginx/Apache

## 当前进度

- ✅ 主页和导航系统
- ✅ 3-4岁专区（完整实现）
- ✅ 用户登录和注册系统
- ✅ 成就展示系统
- ✅ 会员中心
- ✅ 管理员后台（已完成）
- 🚧 5-6岁专区（开发中）
- 🚧 7-8岁专区（开发中）
- 🚧 家长监控面板（计划中）

## 系统安装与配置

### 1. 环境要求

- PHP 7.4 或更高版本
- MySQL 5.7 或更高版本
- Web服务器 (Apache, Nginx)
- PHP扩展: MySQLi, GD, JSON

### 2. 数据库配置

1. 创建MySQL数据库:

```sql
CREATE DATABASE kidsmind CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'kidsmind_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON kidsmind.* TO 'kidsmind_user'@'localhost';
FLUSH PRIVILEGES;
```

2. 导入基础数据表:

```bash
# 导入数据库表结构和初始数据
mysql -u kidsmind_user -p kidsmind < database/kidsmind.sql
```

3. 配置数据库连接:

编辑 `include/config.php` 文件:

```php
// 数据库连接信息
define('DB_HOST', 'localhost');
define('DB_USER', 'kidsmind_user');
define('DB_PASS', 'your_password');
define('DB_NAME', 'kidsmind');
define('DB_PREFIX', 'km_');
```

### 3. 文件权限设置

确保以下目录可写:

```bash
chmod -R 755 uploads/
chmod -R 755 cache/
chmod -R 755 logs/
```

### 4. 管理员账户

#### 默认管理员账户:
- **用户名**: admin
- **密码**: KidsMind@2023
- **访问地址**: http://yourdomain.com/admin/login.php

> **重要提示**: 首次登录后请立即修改默认密码!

#### 管理员权限:
- 用户管理 (创建、编辑、禁用用户)
- 内容管理 (题目、游戏、学习内容)
- 数据统计 (用户行为、学习进度分析)
- 系统配置 (网站参数、邮件设置)

## 管理后台功能

管理后台提供以下主要功能:

1. **控制台**: 显示系统概览和关键统计数据
2. **用户管理**: 用户列表、添加/编辑用户、禁用/启用账户
3. **游戏管理**: 游戏列表、添加/编辑游戏、设置游戏状态
4. **成就管理**: 成就列表、添加/编辑成就、管理成就解锁条件
5. **数据统计**: 用户注册、游戏活跃度、成就解锁等统计分析
6. **系统设置**: 网站基本设置、邮件设置、游戏参数等配置


## 贡献指南

欢迎对 KidsMind 项目做出贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交您的更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 开启一个 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详情请见 [LICENSE](LICENSE) 文件

## 联系方式

项目维护者 - [your-email@example.com](mailto:your-email@example.com)

项目链接：[https://github.com/yourusername/kidsmind](https://github.com/yourusername/kidsmind)