ciit-checkin 0.1.0__tar.gz

ciit_checkin-0.1.0/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2025 Yongshun Song
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

ciit_checkin-0.1.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: ciit-checkin
+Version: 0.1.0
+Summary: 简易签到系统：提供基于 HTTP 的签到表单、管理页面与导出 CSV 功能，适合教室点名与记录。
+Author-email: Yongshun Song <ys_song@foxmail.com>
+Maintainer-email: Yongshun Song <ys_song@foxmail.com>
+License-Expression: MIT
+Keywords: ciit,checkin,attendance,csv,admin
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 项目说明
+简要说明项目用途：一个用于签到的轻量服务，提供前端签到页面和管理员页面，用于管理名单、保存签到记录（CSV）与重置数据。
+
+# 运行方法
+1. 进入项目根目录（包含 `server.py`）。
+2. 推荐创建虚拟环境并安装依赖：
+    ```bash
+    python -m venv venv
+    source venv/Scripts/activate   # Windows: venv\Scripts\activate
+    pip install -r requirements.txt
+    ```
+3. 启动服务（任选其一）：
+    - 直接运行脚本：
+      ```bash
+      python server.py
+      ```
+    - 或使用 Flask（若适用）：
+      ```bash
+      export FLASK_APP=server.py
+      flask run --host=0.0.0.0 --port=5000
+      ```
+4. 默认访问地址（按实际日志或配置调整）：
+    - 签到页面（前端）：http://localhost:5000/  或 http://localhost:5000/checkin
+    - 管理页面： http://localhost:5000/admin  或 http://localhost:5000/manage
+
+# 配置说明
+- 工作目录：服务以启动时的当前工作目录为基准读取/写入文件。建议从项目根目录启动。
+- 配置文件（示例路径，可根据代码调整）：
+  - data/name.txt — 名单
+  - data/checkins.csv — 签到记录（CSV）
+  - data/room_info.txt — 房间或活动相关配置
+
+# 文件位置与格式
+- data/name.txt
+  - 路径示例：./data/name.txt
+  - 格式：UTF-8，逐行一个姓名或记录。示例：
+     ```
+     张三
+     李四
+     王五
+     ```
+  - 如需额外字段（例如 id 或工号），可采用逗号分隔：`name,id`（需与代码解析方式一致）。
+
+- data/checkins.csv
+  - 路径示例：./data/checkins.csv
+  - 推荐字段（CSV首行头部）：timestamp,name,room,notes
+  - 示例内容：
+     ```
+     timestamp,name,room,notes
+     2025-11-11T09:02:15,张三,RoomA,第一次签到
+     2025-11-11T09:10:40,李四,RoomB,
+     ```
+
+- data/room_info.txt
+  - 路径示例：./data/room_info.txt
+  - 常见格式（选择与代码匹配的格式）：
+     - CSV 格式（room_id,display_name,capacity）：
+        ```
+        RoomA,一号教室,30
+        RoomB,二号教室,25
+        ```
+     - 或 key=value 风格：
+        ```
+        RoomA.name=一号教室
+        RoomA.capacity=30
+        RoomB.name=二号教室
+        RoomB.capacity=25
+        ```
+
+# 启动后常用操作
+- 访问签到页面：在浏览器打开签到 URL，输入姓名或选择名单进行签到，界面操作通常会将记录追加到 `data/checkins.csv`。
+- 访问管理页面：打开管理 URL，可查看/编辑名单、导出 CSV、或执行重置操作（具体按钮/功能与实现相关）。
+- 保存操作：在管理页面点击“保存”时，名单应写入 `data/name.txt`，签到记录写入 `data/checkins.csv`。确认服务器进程有写权限。
+- 重置操作：管理页面“重置”通常会清空或重命名当天的 CSV。若无界面，手动操作可：
+  ```bash
+  # 清空签到记录
+  > data/checkins.csv
+  # 或备份再清空
+  mv data/checkins.csv data/checkins-$(date +%F).csv
+  ```
+
+# 示例 room_info.txt 片段
+CSV 风格：
+```
+RoomA,主会场,100
+RoomB,分会场1,40
+RoomC,分会场2,40
+```
+key=value 风格：
+```
+RoomA.name=主会场
+RoomA.capacity=100
+RoomB.name=分会场1
+RoomB.capacity=40
+```
+
+# 常见故障排查
+- 页面无法访问
+  - 检查 server.py 是否在运行、控制台是否报错。
+  - 检查端口是否被占用或防火墙阻挡。
+- 依赖缺失或导入错误
+  - 确认已安装 requirements.txt 中的包，使用正确的 Python 版本。
+- 文件读写失败
+  - 检查 data 目录是否存在、服务器用户是否有读写权限。
+  - Windows 路径注意反斜杠和工作目录；以项目根目录启动服务。
+- 中文/编码问题
+  - 确保所有文本文件使用 UTF-8 编码，避免 BOM 或其它编码导致解析错误。
+- 名单/CSV 格式不生效
+  - 与代码中解析逻辑保持一致（是否期望逗号分隔、是否跳过空行、首行是否为头部）。
+- 无法保存/重置
+  - 确认管理页面的按钮触发的 API 没有返回错误（检查浏览器开发者工具的网络请求和服务器日志）。
+- 日志与调试
+  - 查看控制台日志以获取异常栈信息；可在开发环境开启更详细的日志级别。
+
+如需将以上路径或字段名与代码严格对齐，请提供 server.py 或配置片段以便精确修改 README。

ciit_checkin-0.1.0/README.md

@@ -0,0 +1,115 @@
+# 项目说明
+简要说明项目用途：一个用于签到的轻量服务，提供前端签到页面和管理员页面，用于管理名单、保存签到记录（CSV）与重置数据。
+
+# 运行方法
+1. 进入项目根目录（包含 `server.py`）。
+2. 推荐创建虚拟环境并安装依赖：
+    ```bash
+    python -m venv venv
+    source venv/Scripts/activate   # Windows: venv\Scripts\activate
+    pip install -r requirements.txt
+    ```
+3. 启动服务（任选其一）：
+    - 直接运行脚本：
+      ```bash
+      python server.py
+      ```
+    - 或使用 Flask（若适用）：
+      ```bash
+      export FLASK_APP=server.py
+      flask run --host=0.0.0.0 --port=5000
+      ```
+4. 默认访问地址（按实际日志或配置调整）：
+    - 签到页面（前端）：http://localhost:5000/  或 http://localhost:5000/checkin
+    - 管理页面： http://localhost:5000/admin  或 http://localhost:5000/manage
+
+# 配置说明
+- 工作目录：服务以启动时的当前工作目录为基准读取/写入文件。建议从项目根目录启动。
+- 配置文件（示例路径，可根据代码调整）：
+  - data/name.txt — 名单
+  - data/checkins.csv — 签到记录（CSV）
+  - data/room_info.txt — 房间或活动相关配置
+
+# 文件位置与格式
+- data/name.txt
+  - 路径示例：./data/name.txt
+  - 格式：UTF-8，逐行一个姓名或记录。示例：
+     ```
+     张三
+     李四
+     王五
+     ```
+  - 如需额外字段（例如 id 或工号），可采用逗号分隔：`name,id`（需与代码解析方式一致）。
+
+- data/checkins.csv
+  - 路径示例：./data/checkins.csv
+  - 推荐字段（CSV首行头部）：timestamp,name,room,notes
+  - 示例内容：
+     ```
+     timestamp,name,room,notes
+     2025-11-11T09:02:15,张三,RoomA,第一次签到
+     2025-11-11T09:10:40,李四,RoomB,
+     ```
+
+- data/room_info.txt
+  - 路径示例：./data/room_info.txt
+  - 常见格式（选择与代码匹配的格式）：
+     - CSV 格式（room_id,display_name,capacity）：
+        ```
+        RoomA,一号教室,30
+        RoomB,二号教室,25
+        ```
+     - 或 key=value 风格：
+        ```
+        RoomA.name=一号教室
+        RoomA.capacity=30
+        RoomB.name=二号教室
+        RoomB.capacity=25
+        ```
+
+# 启动后常用操作
+- 访问签到页面：在浏览器打开签到 URL，输入姓名或选择名单进行签到，界面操作通常会将记录追加到 `data/checkins.csv`。
+- 访问管理页面：打开管理 URL，可查看/编辑名单、导出 CSV、或执行重置操作（具体按钮/功能与实现相关）。
+- 保存操作：在管理页面点击“保存”时，名单应写入 `data/name.txt`，签到记录写入 `data/checkins.csv`。确认服务器进程有写权限。
+- 重置操作：管理页面“重置”通常会清空或重命名当天的 CSV。若无界面，手动操作可：
+  ```bash
+  # 清空签到记录
+  > data/checkins.csv
+  # 或备份再清空
+  mv data/checkins.csv data/checkins-$(date +%F).csv
+  ```
+
+# 示例 room_info.txt 片段
+CSV 风格：
+```
+RoomA,主会场,100
+RoomB,分会场1,40
+RoomC,分会场2,40
+```
+key=value 风格：
+```
+RoomA.name=主会场
+RoomA.capacity=100
+RoomB.name=分会场1
+RoomB.capacity=40
+```
+
+# 常见故障排查
+- 页面无法访问
+  - 检查 server.py 是否在运行、控制台是否报错。
+  - 检查端口是否被占用或防火墙阻挡。
+- 依赖缺失或导入错误
+  - 确认已安装 requirements.txt 中的包，使用正确的 Python 版本。
+- 文件读写失败
+  - 检查 data 目录是否存在、服务器用户是否有读写权限。
+  - Windows 路径注意反斜杠和工作目录；以项目根目录启动服务。
+- 中文/编码问题
+  - 确保所有文本文件使用 UTF-8 编码，避免 BOM 或其它编码导致解析错误。
+- 名单/CSV 格式不生效
+  - 与代码中解析逻辑保持一致（是否期望逗号分隔、是否跳过空行、首行是否为头部）。
+- 无法保存/重置
+  - 确认管理页面的按钮触发的 API 没有返回错误（检查浏览器开发者工具的网络请求和服务器日志）。
+- 日志与调试
+  - 查看控制台日志以获取异常栈信息；可在开发环境开启更详细的日志级别。
+
+如需将以上路径或字段名与代码严格对齐，请提供 server.py 或配置片段以便精确修改 README。

ciit_checkin-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ciit-checkin"
+version = "0.1.0"
+
+authors = [
+  {name = "Yongshun Song", email = "ys_song@foxmail.com"}
+]
+maintainers = [
+  {name = "Yongshun Song", email = "ys_song@foxmail.com"}
+]
+
+description = "简易签到系统：提供基于 HTTP 的签到表单、管理页面与导出 CSV 功能，适合教室点名与记录。"
+
+readme = "README.md"
+
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["ciit", "checkin", "attendance", "csv", "admin"]
+
+[project.scripts]
+checkin = "checkin:checkin_server"
+
+[tool.setuptools.package-data]
+checkin = ["*.html"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

ciit_checkin-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ciit_checkin-0.1.0/src/checkin/__init__.py

@@ -0,0 +1,22 @@
+import argparse
+from . import server
+from typing import Optional
+
+def checkin_server(host: str = "0.0.0.0", port: int = 8000, config: Optional[str] = None):
+    """Start the checkin HTTP server (blocking)."""
+    # ✅ 解析命令行参数（当通过 'checkin' 命令调用时）
+    parser = argparse.ArgumentParser(description="Start the CIIT check-in server.")
+    parser.add_argument("-c", "--config", type=str, help="Path to room_info.yaml (default: src/checkin/room_info.yaml)")
+    parser.add_argument("--host", type=str, default="0.0.0.0", help="Server host (default: 0.0.0.0)")
+    parser.add_argument("--port", type=int, default=8000, help="Server port (default: 8000)")
+    
+    # 解析命令行参数（如果被作为脚本调用）
+    args = parser.parse_args()
+
+    # 覆盖默认参数
+    host = args.host
+    port = args.port
+    config = args.config or config  # 允许传入 config 参数覆盖
+
+    print(f"Starting checkin server on {host}:{port} with config: {config}")
+    return server.run_server(host=host, port=port, room_info_path=config)

ciit_checkin-0.1.0/src/checkin/admin.html

@@ -0,0 +1,84 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>姓名记录管理</title>
+  <style>
+  body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  margin: 0;
+  padding: 20px;
+  background-color: #f5f5f5;
+  }
+  .container {
+  max-width: 800px;
+  margin: 0 auto;
+  background-color: white;
+  padding: 20px;
+  border-radius: 8px;
+  box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+  }
+  h2 {
+  text-align: center;
+  color: #333;
+  margin-bottom: 20px;
+  }
+  table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-top: 10px;
+  }
+  td {
+  padding: 8px;
+  text-align: center;
+  border: 1px solid #ddd;
+  }
+  .btn {
+  display: block;
+  width: 200px;
+  margin: 10px auto;
+  padding: 10px;
+  background-color: #4CAF50;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 16px;
+  text-decoration: none;
+  text-align: center;
+  }
+  .btn:hover {
+  background-color: #45a049;
+  }
+  .btn-reset {
+  background-color: #f44336;
+  }
+  .btn-reset:hover {
+  background-color: #da190b;
+  }
+  .label {
+  text-align: center;
+  margin-top: 15px;
+  font-weight: bold;
+  color: #666;
+  font-size: 18px;
+  }
+  </style>
+</head>
+<body>
+  <div class="container">
+  <h2>签到情况</h2>
+  {{table_html}}
+  <div class="label">讲台</div>
+  <form method="POST" action="/{{room_number}}/save">
+  <input type="hidden" name="action" value="save">
+  <button type="submit" class="btn">保存为 CSV</button>
+  </form>
+  <form method="POST" action="/{{room_number}}/reset" onsubmit="return confirm('确定要重置所有数据吗？此操作不可恢复！');">
+  <input type="hidden" name="action" value="reset">
+  <button type="submit" class="btn btn-reset">重置</button>
+  </form>
+  </div>
+</body>
+</html>

ciit_checkin-0.1.0/src/checkin/admin.py

@@ -0,0 +1,173 @@
+import os
+import html
+import csv
+import yaml
+from datetime import datetime
+
+def load_classroom_config(path=None, classroom_id=None):
+    """
+    Load classroom config from YAML file.
+    If classroom_id is provided, return its config; else return first one.
+    Returns: (room_number, row, column) or (None, None, None) if not found.
+    """
+    p = path or os.path.join(os.path.dirname(__file__), 'room_info.yaml')
+    try:
+        with open(p, 'r', encoding='utf-8') as f:
+            data = yaml.safe_load(f)
+        classrooms = data.get('classrooms', [])
+        if classroom_id:
+            for room in classrooms:
+                if room.get('id') == classroom_id:
+                    return (
+                        room.get('room_number', classroom_id),
+                        room.get('row', 4),
+                        room.get('column', 12)
+                    )
+            return None, None, None
+        else:
+            # Return first classroom if no ID specified
+            if classrooms:
+                room = classrooms[0]
+                return (
+                    room.get('room_number', room.get('id', '1058')),
+                    room.get('row', 4),
+                    room.get('column', 12)
+                )
+            return '1058', 4, 12
+    except Exception:
+        return '1058', 4, 12
+
+def build_table_html_from_namefile(name_file="name.txt", classroom_id=None, room_info_path=None):
+    """
+    Build HTML table for a specific classroom.
+    """
+    room_number, row, column = load_classroom_config(room_info_path, classroom_id)
+    if room_number is None:
+        return "<h2>教室配置未找到</h2>"
+
+    # Ensure row and column are integers with defaults
+    row = row or 4
+    column = column or 12
+
+    # ✅ 如果传入了 classroom_id，自动使用 name-{id}.txt
+    if classroom_id and not name_file.startswith("name-"):
+        name_file = f"name-{classroom_id}.txt"
+
+    # ✅ 所有文件路径统一加 data/ 前缀
+    data_dir = "data"
+    os.makedirs(data_dir, exist_ok=True)
+    name_file = os.path.join(data_dir, name_file)
+
+    entries = {}
+    if os.path.exists(name_file):
+        with open(name_file, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                parts = line.split(",", 1)
+                if len(parts) == 2:
+                    prefix, name = parts[0], parts[1]
+                    entries[prefix] = name
+
+    # Build table (inverted row order for display)
+    table = [["" for _ in range(column)] for _ in range(row)]
+    for prefix_str, name in entries.items():
+        try:
+            prefix = int(prefix_str)
+            r_idx = (prefix - 1) // column
+            c_idx = (prefix - 1) % column
+            if 0 <= r_idx < row and 0 <= c_idx < column:
+                table[row - 1 - r_idx][c_idx] = name
+        except ValueError:
+            continue
+
+    table_html = "<table border='1' style='width:100%; border-collapse: collapse;'>\n"
+    for tr in table:
+        table_html += "  <tr>\n"
+        for cell in tr:
+            escaped_cell = html.escape(cell) if cell else "&nbsp;"
+            table_html += f"    <td style='padding:8px; text-align:center;'>{escaped_cell}</td>\n"
+        table_html += "  </tr>\n"
+    table_html += "</table>"
+    return table_html
+
+def save_csv_to_dir(name_file="name.txt", out_dir=None, classroom_id=None, room_info_path=None):
+    """
+    Save CSV for a specific classroom.
+    """
+    room_number, row, column = load_classroom_config(room_info_path, classroom_id)
+    if room_number is None:
+        return "ERROR: Classroom config not found"
+
+    # Ensure row and column are integers with defaults
+    row = row or 4
+    column = column or 12
+
+    # ✅ 如果传入了 classroom_id，自动使用 name-{id}.txt
+    if classroom_id and not name_file.startswith("name-"):
+        name_file = f"name-{classroom_id}.txt"
+
+    # ✅ 所有文件路径统一加 data/ 前缀
+    data_dir = "data"
+    os.makedirs(data_dir, exist_ok=True)
+    name_file = os.path.join(data_dir, name_file)
+
+    entries = {}
+    if os.path.exists(name_file):
+        with open(name_file, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                parts = line.split(",", 1)
+                if len(parts) == 2:
+                    prefix, name = parts[0], parts[1]
+                    entries[prefix] = name
+
+    table = [["" for _ in range(column)] for _ in range(row)]
+    for prefix_str, name in entries.items():
+        try:
+            prefix = int(prefix_str)
+            r_idx = (prefix - 1) // column
+            c_idx = (prefix - 1) % column
+            if 0 <= r_idx < row and 0 <= c_idx < column:
+                table[r_idx][c_idx] = name
+        except ValueError:
+            continue
+
+    timestamp = datetime.now().strftime("%Y%m%d%H%M")
+    csv_filename = f"checkin-{room_number}-{timestamp}.csv"
+    out_dir = out_dir or data_dir  # ✅ 默认输出到 data/ 目录
+    csv_path = os.path.join(out_dir, csv_filename)
+
+    with open(csv_path, "w", encoding="utf-8", newline='') as csvfile:
+        writer = csv.writer(csvfile)
+        writer.writerows(table)
+
+    return csv_filename
+
+def reset_namefile(name_file="name.txt", classroom_id=None):
+    # ✅ 如果传入了 classroom_id，自动使用 data/name-{id}.txt
+    if classroom_id:
+        name_file = f"name-{classroom_id}.txt"
+
+    # ✅ 所有文件路径统一加 data/ 前缀
+    data_dir = "data"
+    os.makedirs(data_dir, exist_ok=True)
+    name_file = os.path.join(data_dir, name_file)
+
+    if os.path.exists(name_file):
+        try:
+            print(f"Deleting: {name_file}")  # ✅ 调试用
+            os.remove(name_file)
+            return True
+        except Exception as e:
+            print(f"Failed to delete {name_file}: {e}")
+            return False
+    return True
+
+if __name__ == "__main__":
+    # Test: save CSV using default room_info.yaml and first classroom
+    fn = save_csv_to_dir(classroom_id=None, room_info_path=None)
+    print("Saved:", fn)

ciit_checkin-0.1.0/src/checkin/checkin.html

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>请输入姓名</title>
+  <style>
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; padding: 20px; background-color: #f5f5f5; }
+  .container { max-width: 600px; margin: 0 auto; background-color: white; padding: 20px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
+  h2 { text-align: center; color: #333; margin-bottom: 20px; }
+  input[type="text"] { width: 100%; padding: 12px; border: 1px solid #ddd; border-radius: 4px; font-size: 16px; box-sizing: border-box; }
+  input[type="submit"] { width: 100%; padding: 12px; background-color: #007bff; color: white; border: none; border-radius: 4px; font-size: 16px; margin-top: 10px; cursor: pointer; }
+  input[type="submit"]:hover { background-color: #0056b3; }
+  </style>
+</head>
+<body>
+  <div class="container">
+  <h2>请输入你的姓名</h2>
+  {{message}}
+  <form method="POST">
+    <input type="text" name="name" placeholder="输入姓名" required>
+    <input type="submit" value="提交">
+  </form>
+  </div>
+</body>
+</html>

ciit_checkin-0.1.0/src/checkin/server.py

@@ -0,0 +1,192 @@
+import importlib.resources
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json
+import os
+import re
+import urllib.parse
+from . import admin
+
+class CheckinHandler(BaseHTTPRequestHandler):
+    # Class-level variable to hold the config file path passed from run_server()
+    room_info_path = None
+
+    def _render_form(self, message=''):
+        try:
+            # ✅ 使用 importlib.resources 从包内读取文件
+            html_content = importlib.resources.read_text('checkin', 'checkin.html', encoding='utf-8')
+        except FileNotFoundError:
+            html_content = "<html><body><h2>页面丢失</h2></body></html>"
+        except Exception:
+            html_content = "<html><body><h2>模板加载失败</h2></body></html>"
+
+        msg_html = f'<p style="color:green">{message}</p>' if message else ''
+        html_content = html_content.replace('{{message}}', msg_html)
+        return html_content.encode('utf-8')
+
+    def _render_admin(self, table_html='', room_number=''):
+        try:
+            # ✅ 同样方式读取 admin.html
+            tpl_content = importlib.resources.read_text('checkin', 'admin.html', encoding='utf-8')
+        except FileNotFoundError:
+            tpl_content = "<html><body><h2>admin 模板丢失</h2></body></html>"
+        except Exception:
+            tpl_content = "<html><body><h2>模板加载失败</h2></body></html>"
+
+        rendered = tpl_content.replace('{{table_html}}', table_html).replace('{{room_number}}', room_number)
+        return rendered.encode('utf-8')
+
+    def do_GET(self):
+        path = urllib.parse.urlparse(self.path).path
+
+        # Extract classroom ID from path: e.g., /1056/admin.html → id="1056"
+        match = re.match(r'^/(\d{3,4})/(admin\.html|checkin-\d{2}\.html)$', path)
+        if match:
+            classroom_id = match.group(1)
+            page_type = match.group(2)
+
+            # Load config for this classroom
+            room_number, _, _ = admin.load_classroom_config(self.room_info_path, classroom_id)
+            if room_number is None:
+                self.send_response(404)
+                self.send_header('Content-Type', 'text/html; charset=utf-8')
+                self.end_headers()
+                self.wfile.write("<h2>教室配置未找到</h2>".encode('utf-8'))
+                return
+
+            if page_type == "admin.html":
+                table_html = admin.build_table_html_from_namefile(classroom_id=classroom_id, room_info_path=self.room_info_path)
+                self.send_response(200)
+                self.send_header('Content-Type', 'text/html; charset=utf-8')
+                self.end_headers()
+                self.wfile.write(self._render_admin(table_html=table_html, room_number=room_number or "未知教室"))
+                return
+
+            elif page_type.startswith("checkin-"):
+                # For checkin pages, just show the form
+                self.send_response(200)
+                self.send_header('Content-Type', 'text/html; charset=utf-8')
+                self.end_headers()
+                self.wfile.write(self._render_form())
+                return
+
+        # ❌ 删除：不再支持 /admin.html 默认页（必须通过 /{id}/admin.html 访问）
+        # 所有访问必须带 classroom_id
+        self.send_response(404)
+        self.send_header('Content-Type', 'text/html; charset=utf-8')
+        self.end_headers()
+        self.wfile.write("<h2>无效路径，请通过 /{教室ID}/admin.html 访问</h2>".encode('utf-8'))
+
+    def do_POST(self):
+        path = urllib.parse.urlparse(self.path).path
+
+        # ✅ 仅支持教室专属路径：/1056/save 和 /1056/reset
+        save_match = re.match(r'^/(\d{3,4})/save$', path)
+        reset_match = re.match(r'^/(\d{3,4})/reset$', path)
+
+        if save_match:
+            classroom_id = save_match.group(1)
+            csv_filename = admin.save_csv_to_dir(classroom_id=classroom_id, room_info_path=self.room_info_path)
+            redirect_url = f"/{classroom_id}/admin.html"
+            html_resp = f"""<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>保存成功</title>
+<meta http-equiv="refresh" content="2;url={redirect_url}"></head>
+<body><p>签到记录已保存为 <code>{csv_filename}</code>，2秒后返回...</p></body></html>"""
+            self.send_response(200)
+            self.send_header('Content-Type', 'text/html; charset=utf-8')
+            self.end_headers()
+            self.wfile.write(html_resp.encode('utf-8'))
+            return
+
+        if reset_match:
+            classroom_id = reset_match.group(1)
+            admin.reset_namefile(classroom_id=classroom_id)
+            redirect_url = f"/{classroom_id}/admin.html"
+            html_resp = f"""<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>重置成功</title>
+<meta http-equiv="refresh" content="1;url={redirect_url}"></head>
+<body><p>数据已重置，1秒后返回...</p></body></html>"""
+            self.send_response(200)
+            self.send_header('Content-Type', 'text/html; charset=utf-8')
+            self.end_headers()
+            self.wfile.write(html_resp.encode('utf-8'))
+            return
+
+        # ❌ 删除：不再支持 /save 或 /reset 全局路径
+        # ❌ 删除：不再支持从 Referer 推断教室 ID
+
+        # Handle check-in POST (name submission) —— 仅允许 /{id}/checkin-XX.html
+        content_length = int(self.headers.get('Content-Length', 0))
+        body = self.rfile.read(content_length) if content_length > 0 else b''
+        content_type = self.headers.get('Content-Type', '')
+
+        name = None
+        if 'application/json' in content_type:
+            try:
+                data = json.loads(body.decode('utf-8'))
+                name = data.get('name') or data.get('user_id')
+            except json.JSONDecodeError:
+                name = None
+        else:
+            try:
+                parsed = urllib.parse.parse_qs(body.decode('utf-8'))
+                name = parsed.get('name', [None])[0]
+            except Exception:
+                name = None
+
+        if name:
+            # ✅ 1. 从路径提取 classroom_id（决定写入哪个文件）
+            class_match = re.match(r'^/(\d{3,4})/checkin-\d{2}\.html$', path)
+            classroom_id = class_match.group(1) if class_match else None
+
+            # ✅ 2. 从路径提取签到序号（写入文件的第一列）
+            seq_match = re.match(r'^.*/checkin-(\d{2})\.html$', path)
+            seq = seq_match.group(1) if seq_match else '00'
+
+            if not classroom_id:
+                # ❌ 不再允许 fallback 到默认教室
+                # 所有 checkin 请求必须来自 /{id}/checkin-XX.html
+                self.send_response(400)
+                self.send_header('Content-Type', 'text/html; charset=utf-8')
+                self.end_headers()
+                self.wfile.write("<h2>签到请求路径无效，请通过 /{教室ID}/checkin-XX.html 提交</h2>".encode('utf-8'))
+                return
+
+            # ✅ 3. 构造文件名：data/name-1056.txt
+            data_dir = "data"
+            os.makedirs(data_dir, exist_ok=True)
+            name_file = os.path.join(data_dir, f"name-{classroom_id}.txt")
+
+            # ✅ 4. 写入：签到序号,姓名 → 如 "01,张三"
+            with open(name_file, 'a', encoding='utf-8') as f:
+                f.write(f"{seq},{name}\n")
+
+            message = f"已保存: {name}"
+            status = 200
+        else:
+            message = "Missing name or invalid data."
+            status = 400
+
+        self.send_response(status)
+        self.send_header('Content-Type', 'text/html; charset=utf-8')
+        self.end_headers()
+        self.wfile.write(self._render_form(message=message))
+
+
+def run_server(host: str = "0.0.0.0", port: int = 8000, room_info_path=None):
+    """Start the checkin HTTP server (blocking)."""
+    # ✅ Set the room_info_path on the handler class
+    CheckinHandler.room_info_path = room_info_path
+
+    addr = (host, int(port))
+    server = HTTPServer(addr, CheckinHandler)
+    print(f"Serving on http://{addr[0]}:{addr[1]}/")
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("Shutting down server...")
+        server.server_close()
+    return server
+
+
+if __name__ == "__main__":
+    run_server()  # keep CLI behavior

ciit_checkin-0.1.0/src/ciit_checkin.egg-info/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: ciit-checkin
+Version: 0.1.0
+Summary: 简易签到系统：提供基于 HTTP 的签到表单、管理页面与导出 CSV 功能，适合教室点名与记录。
+Author-email: Yongshun Song <ys_song@foxmail.com>
+Maintainer-email: Yongshun Song <ys_song@foxmail.com>
+License-Expression: MIT
+Keywords: ciit,checkin,attendance,csv,admin
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# 项目说明
+简要说明项目用途：一个用于签到的轻量服务，提供前端签到页面和管理员页面，用于管理名单、保存签到记录（CSV）与重置数据。
+
+# 运行方法
+1. 进入项目根目录（包含 `server.py`）。
+2. 推荐创建虚拟环境并安装依赖：
+    ```bash
+    python -m venv venv
+    source venv/Scripts/activate   # Windows: venv\Scripts\activate
+    pip install -r requirements.txt
+    ```
+3. 启动服务（任选其一）：
+    - 直接运行脚本：
+      ```bash
+      python server.py
+      ```
+    - 或使用 Flask（若适用）：
+      ```bash
+      export FLASK_APP=server.py
+      flask run --host=0.0.0.0 --port=5000
+      ```
+4. 默认访问地址（按实际日志或配置调整）：
+    - 签到页面（前端）：http://localhost:5000/  或 http://localhost:5000/checkin
+    - 管理页面： http://localhost:5000/admin  或 http://localhost:5000/manage
+
+# 配置说明
+- 工作目录：服务以启动时的当前工作目录为基准读取/写入文件。建议从项目根目录启动。
+- 配置文件（示例路径，可根据代码调整）：
+  - data/name.txt — 名单
+  - data/checkins.csv — 签到记录（CSV）
+  - data/room_info.txt — 房间或活动相关配置
+
+# 文件位置与格式
+- data/name.txt
+  - 路径示例：./data/name.txt
+  - 格式：UTF-8，逐行一个姓名或记录。示例：
+     ```
+     张三
+     李四
+     王五
+     ```
+  - 如需额外字段（例如 id 或工号），可采用逗号分隔：`name,id`（需与代码解析方式一致）。
+
+- data/checkins.csv
+  - 路径示例：./data/checkins.csv
+  - 推荐字段（CSV首行头部）：timestamp,name,room,notes
+  - 示例内容：
+     ```
+     timestamp,name,room,notes
+     2025-11-11T09:02:15,张三,RoomA,第一次签到
+     2025-11-11T09:10:40,李四,RoomB,
+     ```
+
+- data/room_info.txt
+  - 路径示例：./data/room_info.txt
+  - 常见格式（选择与代码匹配的格式）：
+     - CSV 格式（room_id,display_name,capacity）：
+        ```
+        RoomA,一号教室,30
+        RoomB,二号教室,25
+        ```
+     - 或 key=value 风格：
+        ```
+        RoomA.name=一号教室
+        RoomA.capacity=30
+        RoomB.name=二号教室
+        RoomB.capacity=25
+        ```
+
+# 启动后常用操作
+- 访问签到页面：在浏览器打开签到 URL，输入姓名或选择名单进行签到，界面操作通常会将记录追加到 `data/checkins.csv`。
+- 访问管理页面：打开管理 URL，可查看/编辑名单、导出 CSV、或执行重置操作（具体按钮/功能与实现相关）。
+- 保存操作：在管理页面点击“保存”时，名单应写入 `data/name.txt`，签到记录写入 `data/checkins.csv`。确认服务器进程有写权限。
+- 重置操作：管理页面“重置”通常会清空或重命名当天的 CSV。若无界面，手动操作可：
+  ```bash
+  # 清空签到记录
+  > data/checkins.csv
+  # 或备份再清空
+  mv data/checkins.csv data/checkins-$(date +%F).csv
+  ```
+
+# 示例 room_info.txt 片段
+CSV 风格：
+```
+RoomA,主会场,100
+RoomB,分会场1,40
+RoomC,分会场2,40
+```
+key=value 风格：
+```
+RoomA.name=主会场
+RoomA.capacity=100
+RoomB.name=分会场1
+RoomB.capacity=40
+```
+
+# 常见故障排查
+- 页面无法访问
+  - 检查 server.py 是否在运行、控制台是否报错。
+  - 检查端口是否被占用或防火墙阻挡。
+- 依赖缺失或导入错误
+  - 确认已安装 requirements.txt 中的包，使用正确的 Python 版本。
+- 文件读写失败
+  - 检查 data 目录是否存在、服务器用户是否有读写权限。
+  - Windows 路径注意反斜杠和工作目录；以项目根目录启动服务。
+- 中文/编码问题
+  - 确保所有文本文件使用 UTF-8 编码，避免 BOM 或其它编码导致解析错误。
+- 名单/CSV 格式不生效
+  - 与代码中解析逻辑保持一致（是否期望逗号分隔、是否跳过空行、首行是否为头部）。
+- 无法保存/重置
+  - 确认管理页面的按钮触发的 API 没有返回错误（检查浏览器开发者工具的网络请求和服务器日志）。
+- 日志与调试
+  - 查看控制台日志以获取异常栈信息；可在开发环境开启更详细的日志级别。
+
+如需将以上路径或字段名与代码严格对齐，请提供 server.py 或配置片段以便精确修改 README。

ciit_checkin-0.1.0/src/ciit_checkin.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/checkin/__init__.py
+src/checkin/admin.html
+src/checkin/admin.py
+src/checkin/checkin.html
+src/checkin/server.py
+src/ciit_checkin.egg-info/PKG-INFO
+src/ciit_checkin.egg-info/SOURCES.txt
+src/ciit_checkin.egg-info/dependency_links.txt
+src/ciit_checkin.egg-info/entry_points.txt
+src/ciit_checkin.egg-info/top_level.txt

ciit_checkin-0.1.0/src/ciit_checkin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ciit_checkin-0.1.0/src/ciit_checkin.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+checkin = checkin:checkin_server

ciit_checkin-0.1.0/src/ciit_checkin.egg-info/top_level.txt

@@ -0,0 +1 @@
+checkin