项目迁移

.dockerignore

@@ -0,0 +1,21 @@
+.git
+.agents
+.codex
+node_modules
+tests
+
+.env
+.env.*
+!.env.example
+!.env.docker.example
+
+data/*
+!data/.gitkeep
+
+*.log
+npm-debug.log*
+Dockerfile*
+compose*.yml
+compose*.yaml
+README.md
+LICENSE

.env.docker.example

@@ -0,0 +1,27 @@
+# 首次启动前请复制为 .env.docker，并替换下面三个值。
+# 两项密钥必须至少 32 个字符、彼此独立，部署后不得随意更换。
+TOTP_ENCRYPTION_KEY=replace-with-a-random-secret-of-at-least-32-characters
+DOCUMENT_VERIFICATION_SECRET=replace-with-an-independent-random-secret-of-at-least-32-characters
+
+INITIAL_ADMIN_USERNAME=admin
+INITIAL_ADMIN_PASSWORD=replace-with-a-strong-admin-password
+INITIAL_ADMIN_DISPLAY_NAME=系统管理员
+
+# 下列公开站点信息可按需修改。
+PUBLIC_SITE_NAME=海州市教育考试中心
+PUBLIC_SITE_CODE=HZ-EDU-032
+PUBLIC_SITE_PHONE=0518-8602 3158
+PUBLIC_SITE_ADDRESS=江苏省连云港市海州区文教路 18 号
+PUBLIC_SITE_EMAIL=
+PUBLIC_SITE_HERO_EYEBROW=HAIZHOU EXAMINATION SERVICE
+PUBLIC_SITE_HERO_TITLE=一个报名号，
+PUBLIC_SITE_HERO_HIGHLIGHT=贯穿每一次考试。
+PUBLIC_SITE_HERO_DESCRIPTION=使用学校下发的报名号登录，完成密码更新和个人信息核验后，即可办理所有考试事项。
+PUBLIC_SITE_FOOTER_NOTICE=本平台展示数据仅用于系统演示
+
+# 可选 Redis；容器外的 Redis 不应填写 127.0.0.1。
+# 普通接口缓存使用 DB 0，认证状态会自动使用独立 DB 1。
+# REDIS_URL=redis://redis-host:6379/0
+# REDIS_SESSION_DB=1
+# 也可让认证状态使用另一台 Redis（此时 URL 中可指定自己的逻辑 DB）。
+# REDIS_SESSION_URL=rediss://session-redis-host:6379/1

.env.example

@@ -0,0 +1,60 @@
+# 本地开发（默认）
+NODE_ENV=development
+DATABASE_CLIENT=sqlite
+SQLITE_PATH=./data/exam.sqlite
+HOST=127.0.0.1
+PORT=4173
+
+# 可选 Redis。普通接口缓存使用 DB 0；配置 REDIS_URL 后，登录状态默认自动使用独立的 DB 1。
+# 未设置任何 Redis 地址时，接口缓存和认证状态均使用本机内存模式。
+# REDIS_URL=redis://127.0.0.1:6379/0
+# REDIS_CACHE_PREFIX=exam-information
+# REDIS_CACHE_TTL_SECONDS=60
+# REDIS_RESULTS_CACHE_TTL_SECONDS=86400
+# REDIS_CONNECT_TIMEOUT_MS=1500
+# REDIS_SESSION_DB=1
+# REDIS_SESSION_PREFIX=exam-information:auth
+# AUTH_SESSION_TTL_SECONDS=28800
+# 如需让认证状态使用另一台 Redis，可设置独立地址；URL 中可直接指定逻辑 DB。
+# REDIS_SESSION_URL=rediss://session-redis.example.com:6379/1
+
+# 仅在首次创建空数据库时使用。部署前务必修改初始密码。
+INITIAL_ADMIN_USERNAME=admin
+INITIAL_ADMIN_PASSWORD=Admin123!
+INITIAL_ADMIN_DISPLAY_NAME=系统管理员
+
+# TOTP 密钥加密主密钥。生产环境必填且至少 32 个字符；修改后已绑定的 TOTP 将无法解密。
+# TOTP_ENCRYPTION_KEY=replace-with-a-random-secret-of-at-least-32-characters
+
+# 成绩单与录取通知书防伪码签名密钥。生产环境必须独立设置并长期稳定保存。
+# DOCUMENT_VERIFICATION_SECRET=replace-with-an-independent-random-secret-of-at-least-32-characters
+
+# 公开首页文案与联系方式（修改后重启应用生效）
+PUBLIC_SITE_NAME=海州市教育考试中心
+PUBLIC_SITE_CODE=HZ-EDU-032
+PUBLIC_SITE_PHONE=0518-8602 3158
+PUBLIC_SITE_ADDRESS=江苏省连云港市海州区文教路 18 号
+PUBLIC_SITE_EMAIL=
+PUBLIC_SITE_HERO_EYEBROW=HAIZHOU EXAMINATION SERVICE
+PUBLIC_SITE_HERO_TITLE=一个报名号，
+PUBLIC_SITE_HERO_HIGHLIGHT=贯穿每一次考试。
+PUBLIC_SITE_HERO_DESCRIPTION=使用学校下发的报名号登录，完成密码更新和个人信息核验后，即可办理所有考试事项。
+PUBLIC_SITE_FOOTER_NOTICE=本平台展示数据仅用于系统演示
+
+# MySQL 8.4 生产环境：将 DATABASE_CLIENT 改为 mysql，并配置以下变量。
+# NODE_ENV=production
+# DATABASE_CLIENT=mysql
+# MYSQL_HOST=127.0.0.1
+# MYSQL_PORT=3306
+# MYSQL_USER=exam_app
+# MYSQL_PASSWORD=replace-with-a-strong-password
+# MYSQL_DATABASE=exam_information
+# MYSQL_CONNECTION_LIMIT=10
+# HOST=0.0.0.0
+
+# 也可以用单个连接地址替代全部 MYSQL_* 连接参数：
+# DATABASE_URL=mysql://exam_app:password@127.0.0.1:3306/exam_information
+# 全量数据库状态快照的最长复用时间（毫秒）。应用内写入会立即失效；MySQL 外部直写最长延迟此时间可见。
+DATABASE_STATE_CACHE_TTL_MS=30000
+# Redis 未配置或暂不可用时，本机响应缓存的最大条目数。
+LOCAL_CACHE_MAX_ENTRIES=200