# 智慧教室-RowSeat智能排座Web端 **Repository Path**: nllg2002/RowSeat-Web ## Basic Information - **Project Name**: 智慧教室-RowSeat智能排座Web端 - **Description**: 面向班主任和教师的开源排座工具。按实际教室布置座位,并结合学生身高、黑板视线。免登录即可使用,工作区保存在当前浏览器。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RowSeat · 智慧教室 简体中文 · [繁體中文](README.zh-TW.md) · [English](README.en.md) · [日本語](README.ja.md) · [한국어](README.ko.md) RowSeat 是给班主任和教师使用的排座工具。它结合教室布局、学生身高、座位约束和历史轮换生成候选方案,方便教师比较视线遮挡、手动调整座位,并保留采用记录。 [在线使用 RowSeat](https://app.rowseat.nllg2026.xyz/) · [产品官网](https://rowseat.nllg2026.xyz/) ## 能做什么 - 管理班级、学生和教室,按实际布局设置桌椅、过道和黑板位置。 - 根据前后排遮挡、座位锁定、间距、同桌规则和历史轮换搜索座次,比较方案并手动换座。 - 在 Web 端导入 Excel 名单,查看视线示意,打印或导出已经采用的座次。 - Web 可免登录保存到当前浏览器。自建 Node.js 服务后可配置邮箱认证和云备份。微信小程序支持本机排座流程,当前功能以小程序说明为准。 视线模型使用估算的坐姿眼点和头部几何,适合辅助比较座次方案。算法与平台共享逻辑见[排座说明](packages/product/src/seating-guide.ts)。 ## 源码布局 | 路径 | 用途 | | --- | --- | | [`RowSeat/`](RowSeat/README.md) | React Web 客户端、Node.js 账号与存储服务 | | `packages/` | 共享排座算法、数据契约、产品定义及界面翻译 | | [`doc/`](doc/web/README.md) | 开发、部署和设计资料 | 这里维护 Web 应用、服务端和共享包。微信小程序和产品官网各有独立仓库。产品版本统一记录于 [`packages/product/versions.json`](packages/product/versions.json)。 ## 开始开发 需要 Node.js 24+、npm 和 Git。在主仓库根目录运行以下命令。Windows PowerShell 可将 `npm` 换成 `npm.cmd`。 ```sh npm ci npm --prefix RowSeat ci npm run dev:web ``` 打开 [本地 Web 应用](http://127.0.0.1:5173/)。账户、邮件和云备份的配置见[服务端启动说明](doc/web/部署.md)。 ## 检查与贡献 运行 `npm run check` 检查共享包、运行 Web 与服务端测试并构建应用。开发约定见 [CONTRIBUTING](doc/web/CONTRIBUTING.md),翻译维护见[语言说明](packages/i18n/README.md)。 服务端 IP 地理数据来源为 [DB-IP](https://db-ip.com/)。 ## 许可证与署名 本仓库的原创 Web 源代码和技术文档采用 [Apache-2.0](LICENSE)。再分发时按许可保留原版权、许可和 [NOTICE](NOTICE) 中的适用署名,修改过的文件须标明变更。引用排座实现时,可标注「王硕斌(逆旅流光),RowSeat Web」并附来源。 第三方依赖、素材和品牌标识适用各自的权利与许可。