Vue 前端工程
Vue 3 + TypeScript + Vite + Element Plus，使用 Vue Router 与 Pinia。 登录、已发布题库、题面、提交与个人成绩页面使用真实 API。训练、比赛、社区等 本轮以外页面仍为明确的开发预览，不提供这些尚未实现的业务能力。
pnpm install --frozen-lockfile
pnpm dev
pnpm typecheck
pnpm test
pnpm build
开发服务在 http://127.0.0.1:5173，/api 代理到 http://127.0.0.1:8000。
复制 .env.example 为 .env 可调整代理和 API 地址。
生产部署须配置 SPA 路由回退及 /api 反向代理；开发代理不进入生产产物。
views/：路由页面；layouts/：页面框架；components/：可复用界面组件。api/：HTTP 客户端和业务 API 封装；api/generated/：从 OpenAPI 生成的类型。composables/：带生命周期的交互逻辑；stores/：跨页面共享状态。router/：路由；styles/：全局样式。
已有代码按实际需要落位；components/ 和 stores/ 是后续扩展位置，不放空状态实现。
API 类型更新执行根目录 make contracts；前端通过 pnpm check:api 拒绝过期类型。
登录凭据、模型密钥和数据库连接不能进入 VITE_ 环境变量。
已有账号登录使用 HttpOnly/Strict cookie 与单独 CSRF cookie；401清除内存身份，
保护页面重新登录后继续。自助注册暂不开放。密码/会话不存入 localStorage。
浏览器与 API 使用同一 origin 的 /api，明确配置 KF_OJ_BROWSER_ORIGINS；
生产必须使用 HTTPS、安全 cookie 与独立部署的反向代理。
编辑器按题目版本和语言保留本地草稿，新增 Java 并保留原 C17/C++/Python/Rust 草稿。 可提交语言由服务端已发布版本的能力与语言配置决定，支持 C17/C++20、固定 CPython 3.13.16 的单文件 main.py/标准库，以及固定 OpenJDK 21.0.12.1+1-LTS 的默认包 Main.java/Main；Java 可包含受控的辅助、内部和匿名类。缺失或无效配置不能提交， Rust 当前保留草稿且不可提交。Python 准备阶段只检查语法，不执行顶层代码； Java 编译错误显示真实诊断，语言版本与预算取自服务端。请求不在线安装依赖。 提交凭据按账号/版本/内容 SHA-256 绑定， POST前先保存 UUID，双击共用请求，网络超时/刷新重试复用原键；内容变化产生新键。 草稿和已保存凭据不因失败/退出而清除，本地存储不可用时拒绝发起无法稳定重试的提交。
详情和列表查询每2秒一次，每轮最多240次/10分钟；终态、错误或离页停止，隐藏页面
取消当前查询，恢复可见时继续原预算。路由变化/会话变化后的旧响应不能覆盖当前视图。
耗尽后可手动刷新；不会用预览成绩填补错误。取消受理与最终停止分别展示。
运行指标仅来自完整持久化报告，null显示“—”；诊断和源码按纯文本显示。
pnpm test 覆盖草稿、幂等重试、轮询期限/隐藏/终态/失效响应和401处理，
已纳入 make check-frontend；真实浏览器编译/判题另在受限独立 VM 验收。
管理入口 /admin/index.html#/problems 共用同源 Cookie、CSRF 与实时权限 API。
admin/ 管理路由和维护页面，api/adminProblems.ts 使用生成 DTO；普通用户进入明确
403 页，权限失效或离页终止请求。题目、版本历史、本人导入和审计采用服务端游标分页。
题包只接受有界单层 ZIP，导入 UUID 在上传前绑定当前账号、SHA-256 和字节数。 浏览器只持久保存 UUID/摘要等重试信息，不保存文件正文、密码或管理员能力。 状态查询每 2 秒一次，最多 90 次/3 分钟；错误、终态、离页停止，可核对原操作。 发布、下架和恢复使用独立稳定 UUID 与版本/状态前置条件；409 后重新读取当前状态， 网络不确定时核对原回执。候选题面、公开样例与预算按安全文本预览，隐藏工件不下发。 发布产生新不可变版本；下架的受理任务与本人历史保留。其他管理业务区明确未实现。 事件测试验证本地凭据与生命周期，不代替独立 VM 中的真实 Cookie/HTTP/浏览器验收。