# share-table

**Repository Path**: yldj-it/share-table

## Basic Information

- **Project Name**: share-table
- **Description**: 适配信息科技课程标准中在线协作要求
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2026-03-29
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Share Table (信息科技课标对标 · 在线协作实践平台)

![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)
![Next.js](https://img.shields.io/badge/Next.js-16.2-black.svg)
![AntDesign](https://img.shields.io/badge/Ant--Design-6.3.4-1890ff.svg)
![Curriculum](https://img.shields.io/badge/课标对标-在线生活与协作-orange.svg)

**Share Table** 是一款紧扣《义务教育信息科技课程标准》、专为信息科技教师设计的实时协作实践平台。它不仅是一个数据收集工具，更是引导学生理解**“在线协作原理”**、**“互联网应用架构”**及**“数字化安全意识”**的理想教学样本。

本项目针对**校内实验机房（物理隔绝内网）**环境进行了深度优化，确保在内网的状态下依然能提供稳定、丝滑的协同办公体验。

---

## 🎯 课标对标说明 (信息科技 2022 版)

本项目深度契合“在线生活与协作”模块，可作为以下知识点的教学实践载体：

| 课标知识点 | 教学实践场景 |
| :--- | :--- |
| **在线协作原理** | 通过 WebSocket 技术实现的“毫秒级同步”，让学生直观感知网络数据的实时传输与状态追平。 |
| **协同办公实践** | 模拟真实的云端协作环境，开展多人同时填写、任务拆解与进度实时汇总的实验活动。 |
| **数字化安全意识** | 通过设置访问密码、链接有效期及字段编辑权限，在实践中渗透网络安全与隐私保护教育。 |
| **数字化数据处理** | 利用自动查重、必填校验等功能，引导学生理解数据一致性与规范性在数字化社会中的重要性。 |

---

## ✨ 核心特性

- 🚀 **毫秒级实时同步**: 基于 WebSocket + Redis 双层热路径架构，支持 50+ 人同时高频编辑，无延迟反馈。
- 📊 **智能汇总分析**: 自动生成提交比例、重复项检测报告，让学生在实验课后即刻看到数字化处理的威力。
- 🔒 **精细权限管控**: 教师可一键锁定表格、设置截止日期，模拟互联网应用的生命周期管理。
- 🌍 **100% 本地化部署**: 零外部依赖，静态资源、字体及语言包均已本地化，完美适配断网教学机房。
- 🛠️ **多端适配方案**: 适配 Windows/Linux/Docker 部署，支持自备数据库或一键容器化交付。

---

## 📖 教学核心使用流程

只需简单四步，即可在课堂上开启高效的在线协作实验：

1. **实验准备**: 教师使用预设账号登录后台，点击“新建表格”。
2. **任务发布**: 选择模板（如“传感器数据收集”）或自定义表头，设置状态为“进行中”。
3. **协作开展**: 在“分享管理”中生成链接分发给学生，学生免登录即刻进入协同编辑状态。
4. **归纳总结**: 利用“统计报表”功能，师生共同分析数据准确性，完成教学评价。

---

## 📸 系统预览

> **提示**：为获得最佳预览效果，建议在 `docs/screenshots/` 目录下放置以下截图。

### 1. 教师管理端
![教师管理后台](docs/screenshots/dashboard.png)

### 2. 多人实时协作
![桌面端编辑](docs/screenshots/desktop-edit.png)

### 3. 智能教学统计报表
![统计与异常检测](docs/screenshots/stats-panel.png)

---

## 🚀 快速启动

### 1. 安装依赖
```bash
npm install
```

### 2. 配置文件
```bash
cp .env.example .env
```

### 3. 初始化数据库
- **Windows**: `.\scripts\setup-db.ps1`
- **Linux**: `chmod +x ./scripts/setup-db.sh && ./scripts/setup-db.sh`

### 4. 运行项目
- **开发模式**: `npm run dev`
- **生产模式**: `npm run build && npm run start`

---

## 📦 内网部署指南(必读)

对于教育内网，请参考 [内网离线部署手册](docs/DEPLOYMENT.md)。支持 Docker 镜像离线导出与加载。

---

## 🧱 技术栈

本项目当前采用的核心技术栈如下：

| 类别 | 技术方案 |
| :--- | :--- |
| 前端框架 | Next.js 16.2.1（App Router） + React 19.2.4 |
| UI 组件 | Ant Design 6.3.4 + `@ant-design/nextjs-registry` |
| 时间与本地化 | Day.js + `zh-CN` 本地化 |
| 服务端 | Next.js Route Handlers + 自定义 Node.js HTTP Server |
| 实时协作 | WebSocket（`ws`） + Redis（`ioredis`） |
| 数据访问 | Prisma 7.6.0 + `@prisma/adapter-mariadb` |
| 数据库 | MySQL 8.0 |
| 鉴权与安全 | `next/headers` Cookie 鉴权 + `bcryptjs` 密码哈希 |
| 工程化 | ESLint 9 |
| 部署方式 | Windows / Linux / Docker / Docker Compose |

补充说明：

- 表格编辑与协同状态同步通过 `WebSocket + Redis` 实现，服务端使用自定义 `server.js` 挂载 WebSocket 通道，而不是仅依赖 `next start`。
- 数据模型由 Prisma 管理，当前落地到 MySQL，并通过 MariaDB Adapter 连接数据库。
- 管理端与公开填写端均基于 Next.js App Router 构建，接口层使用 Route Handlers。
- 项目同时提供 `npm` / `pnpm` 依赖锁文件，默认脚本可直接用于本地开发、构建和离线部署。

---

## 🛠️ 技术支持与私有化部署

如果您在校内机房部署过程中遇到国产系统适配或特定网络环境难题，我提供以下**有偿技术服务**：

- **复杂环境一键交付**: 针对物理隔绝机房的专业优化与上门/远程部署，也支持对云服务器或域名的配置服务。
- **校园白标定制**: 替换系统 Logo、校徽，并提供校内统一身份认证 (SSO) 对接。
- **特定教学场景扩展**: 根据您的教学实验需求进行二次开发。

如有需求，欢迎咨询。

---

## 👨‍🏫 初始账号

- **系统管理员**: `admin` / `admin`
- **演示教师**: `teacher` / `teacher`

---

## ☕ 赞赏与支持

如果您认可本项目的开源精神，欢迎通过赞赏来支持持续开发。

<div align="center">
  <img src="docs/screenshots/wechat-reward.jpg" width="200" title="微信赞赏码">
  <br />
  <small>微信扫码赞赏</small>
</div>

---

## 📄 开源协议

本项目基于 **[GPL-3.0 License](LICENSE)** 协议开源。

- **自由授权**: 您可以自由地使用、学习、修改及分发本项目。
- **开源延续**: 如果您修改并分发本项目，您的修改版本必须同样以 GPL-3.0 协议开源。
- **署名尊重**: 在使用或修改分发时，**请务必保留原作者（彭望@雅礼丁江信息组）的署名信息**。