证券投资模拟系统 · 管理员操作手册

一、管理端入口

二、管理员职责与赛前准备

1. 熟悉系统流程

• 所有管理员在 比赛开始前务必完整阅读本手册，并实际操作一遍各功能模块。
• 比赛过程中 务必确保参数配置正确，部分参数一旦配置可能无法更改或撤销（如“重新开始”），请谨慎操作。

2. 赛前配置清单（按顺序执行）

1. 用户账户类型调整：在“用户管理”模块中审批升级申请，或直接编辑用户类型（普通/专业/管理员）。
2. 初始资产设置：如需修改用户初始资产（如100,000元），需在数据库中修改 user_assets 表，或通过后台“编辑用户”功能（若已提供资产字段）。当前版本未提供前端直接修改资产，请使用数据库工具操作。
3. 新闻通知准备：提前发布比赛规则、注意事项等新闻，并酌情置顶。
4. 延迟时间配置：根据比赛规模和预期操作时间，在“延迟控制”中设置合理的每周延迟（建议 ≥ 30 秒）。
5. 事件参数设置：在“参数设置”中配置各周的行业事件（科技、消费等），比赛开始后可按需调整。
6. 通知用户：告知所有用户 比赛开始的具体时间，此时间一旦确定，尽量不要再更改，以免造成混乱。

3. 多轮比赛操作顺序

三、模拟控制面板

1. 控制按钮说明

• 启动：开始模拟，从当前周（或第0周）开始执行。若当前周为0，则从第1周开始。
• 暂停：暂停模拟，停止前进到下一周。当前周数据保留。
• 停止：完全停止模拟，状态变为“已停止”。
• 重新开始：清空所有 1～520 周的模拟结果数据，并将当前周重置为 0。此操作不可逆，请谨慎使用。

2. 延迟时间设置

• 在“延迟控制”子选项卡中，可为指定周设置延迟时间（秒）。系统会在该周开始前等待指定秒数。
• 建议设置为 ≥ 30 秒，确保管理员有足够时间调控参数、处理突发状况。
• 延迟时间支持批量设置（连续周）和单周设置，也可清除特定周的延迟。

3. 暂停与停止的响应机制

• 暂停/停止指令 不会立即中断正在计算中的某一周（市场模拟与结果保存过程不可中断），但会在当前周计算完成后生效。由于每轮计算极短（通常 < 1 秒），实际等待时间可忽略。
• 前端状态显示每 3 秒刷新一次，因此按钮状态可能与实际状态有 ≤ 3 秒的延迟，刷新页面即可获取最新状态。

四、参数设置模块

1. 事件参数（行业影响）

• 支持 8 个行业：科技、消费、农业、金融、能源、地产、黄金、债券。
• 每个行业可设置数值（-10 ~ 10，债券为 -50 ~ 50），代表该周对该行业的“事件冲击”强度。
• 保存单周：将当前表单中的数值保存到指定周。
• 批量设置：将当前表单数值应用到从指定周（或“从下一周开始”）到第 520 周的所有周。
• 重置表单：清空表单中的数值（不影响已保存数据）。
• 清除事件：将指定周范围内的所有事件值归零。

2. 参数配置表

• 展示所有 520 周的事件参数值，支持按周加载到表单进行修改。
• 表格中非零事件高亮显示，便于快速定位。

3. 延迟控制

• 可设置单周或连续周的延迟标志（是否延迟）和延迟时间（秒）。
• 延迟列表支持搜索、过滤、分页，可删除特定周的延迟设置或一键清除所有延迟。
• 顶部状态卡片显示当前周数、模拟状态、已设置延迟的周数。

4. 图表设置

• 右侧展示价值图和 PRP 图，可根据时间范围（预设或自定义）和系列选择（复选框）动态更新。
• 支持全选/取消全选资产系列。
• 图表数据来自 simulation_results 表，自动刷新间隔由延迟控制决定。

五、用户管理模块

1. 用户列表

• 展示所有注册用户，支持按用户名/邮箱搜索，按用户类型（普通/专业/管理员）和状态（正常/未激活/冻结）筛选。
• 每行提供“编辑”按钮，可修改用户类型、状态和信用分（0~1000）。
• 修改用户类型会影响其权限（如专业用户可查看更多数据，管理员可进入后台）。

2. 升级申请

• 普通用户可提交升级申请（申请成为专业用户或管理员）。
• 管理员可在此审批申请，批准后用户类型自动变更。
• 申请列表支持分页，状态可筛选（待处理/已批准/已拒绝）。
• 待处理申请数量会在选项卡上显示红点徽标。

六、竞赛管理模块

1. 排行榜

• 按总资产降序排列所有参赛用户，展示总资产、现金、持仓市值、总盈亏。
• 支持按用户名搜索，分页显示。
• 点击任意用户行，右侧详情区域会更新该用户的完整信息。

2. 用户详情（右侧面板）

• 用户摘要：显示用户名、排名、总资产、现金、持仓市值、总盈亏、信用分、状态。
• 持仓与资产：以饼图展示资产配置比例，下方列表显示持仓明细（资产代码、数量、均价、市值、盈亏）。
• 交易记录：分页展示该用户的历史交易（买入/卖出），包括时间、资产、数量、价格、金额、状态。
• 借贷记录：展示该用户的借贷订单（借款/出借），包括金额、利率、期限、对方用户、状态、到期周数。
• 基金投资：展示该用户持有的基金份额、市值、盈亏等信息（若系统启用了基金模块）。

七、新闻通知模块

1. 新闻列表

• 展示所有新闻，支持按标题/内容搜索，按分类筛选（市场/科技/金融/政策/公司/其他）。
• 列表显示标题、分类、来源、作者、发布时间（周数）、置顶标志。
• 每行提供编辑、删除、切换置顶操作按钮。

2. 添加/编辑新闻

• 点击“添加新闻”打开模态框，填写标题、摘要、内容、分类、来源、作者、置顶选项。
• 编辑新闻时，模态框会加载已有数据，修改后保存。
• 标题和内容为必填项。

3. 查看详情

• 点击新闻列表中的任意行，右侧详情区域会显示完整内容，并支持在该区域直接编辑、删除、切换置顶。

八、系统日志模块

1. 日志查看

• 记录所有管理员的关键操作，包括参数保存、用户编辑、模拟控制、新闻操作等。
• 支持按用户名/操作类型/内容搜索，按操作类型、管理员、日期范围筛选。
• 分页显示，每页 15 条。

2. 日志用途

• 用于审计和故障排查，可追溯操作者、操作时间、IP 地址。
• 在出现数据异常时，通过日志快速定位问题原因。

九、系统运行机制与特别提示

1. 周粒度控制与延迟生效

• 模拟过程以“周”为最小计算单位，每周内的市场模拟、数据生成和结果保存为连续不可中断的操作。
• 延迟时间仅在每周开始前生效，若在周内修改延迟，需等待当前周完成后方可应用新延迟。
• 暂停/停止指令同样遵循“周粒度”原则，点击后会等待当前周计算完毕再停止，不会立即切断。鉴于每轮计算极快，此延迟通常不影响管理体验。

2. 状态显示同步延迟

• 模拟程序每 0.5 秒轮询一次控制指令，但前端页面每 3 秒刷新一次状态，因此管理员看到的“运行/暂停”状态可能存在 ≤ 3 秒的滞后。刷新页面或稍等片刻即可获取最新状态。

3. 并发与事务安全

• 系统采用默认自动提交机制，模拟程序与管理后台可能同时访问同一数据表（如参数表）。在极低频率操作下（每数秒一次），出现数据冲突的概率极低。
• 若需进行批量或关键参数修改，建议先暂停模拟，避免并发修改导致数据不一致。

4. 异常恢复与人工干预

• 若模拟程序意外崩溃，数据库中的模拟状态可能仍标记为“运行中”。此时需 立即联系开发团队，由技术人员手动修正状态并排查原因。
• 程序本身包含 try-except 错误捕获，崩溃后会自动停止并记录日志，管理员可查看日志辅助定位问题。

十、常见问题与故障排查

1. 模拟无法启动

• 检查数据库连接是否正常（后台页面是否有报错）。
• 查看 simulation_command 表中的 simulation_status 是否为 “stopped”，若不是，可尝试先停止再启动。
• 确认 Python 模拟脚本是否正在运行（若独立部署）。

2. 图表不更新

• 确认模拟状态是否为“运行中”，且当前周数 > 0。
• 检查 simulation_results 表中是否有对应周的数据。
• 刷新页面或手动点击“更新图表”按钮。

3. 用户无法登录或状态异常

• 检查用户状态是否为“正常”（active），若为“冻结”则无法登录。
• 若用户类型被错误修改，可在用户管理中更正。

4. 数据不一致

• 如发现总资产与持仓市值不符，可能是数据库手动修改或模拟程序错误导致，建议暂停模拟并联系开发人员检查。

十一、安全警告与联系方式

联系方式：

• 开发者：Sonder
• 邮箱：2651211617@qq.com
• 紧急联系电话：请在内部沟通群中获取。