# 选举与投票信息系统 - 实施清单

## 项目目标

建设一个面向组织内部选举的 ASP.NET Core 系统，统一支持在线匿名投票、线下纸质票计票、混合汇总、公开内容发布与实时公开看板。系统应确保资格受控、投票唯一、选票匿名、计票可复核、结果可审计。

## 技术基线

- 后端：ASP.NET Core Web API、EF Core、OpenAPI（Scalar 或 Swagger）
- 业务基础设施：ABP Framework（按需采用其身份、权限、审计和模块化能力）
- 数据库：MySql（首选；SQL Server 为可支持替代）
- 身份认证：OpenIddict 或 Keycloak，采用 OpenID Connect / OAuth 2.0
- 实时与任务：SignalR、Hangfire、Redis
- 文件：MinIO 或 S3 兼容对象存储
- 管理端：Vue 3 + Element Plus；公开站点：Nuxt 3（优先）
- 编辑与可视化：CKEditor 5 或 TinyMCE、ECharts、ClosedXML
- 可观测性：Serilog + Seq 或 OpenSearch

## 业务规则（实现前必须确认）

- [ ] 明确选民身份认证来源：本地账号、统一身份认证或两者并行。
- [ ] 明确是否存在实名投票；默认在线投票为匿名投票。
- [ ] 明确线上、线下混合投票时，是否允许同一选民跨渠道投票；默认不允许。
- [ ] 明确线下票是否必须双人独立录入和监票确认；建议必须。
- [ ] 明确结果公开策略：默认实时公开参与率，截止前不公开候选人实时得票。
- [ ] 明确票数相同、无效票、弃权票、候选人退出和补选的规则。
- [ ] 明确组织层级、管理员授权范围与数据保留期限。

## 第一阶段：项目骨架与基础能力

- [ ] 创建解决方案与模块边界：Identity、Organization、Election、Voting、OfflineCounting、Cms、PublicBoard、Audit。
- [ ] 配置 PostgreSQL、EF Core 迁移、开发环境配置与健康检查。
- [ ] 接入身份认证，建立用户、角色、权限和组织范围授权。
- [ ] 建立统一 API 错误格式、参数校验、分页、排序和筛选规范。
- [ ] 接入 Serilog、审计日志与敏感字段脱敏。
- [ ] 配置 Redis、Hangfire、对象存储和本地开发替代实现。
- [ ] 建立单元测试、集成测试和权限越权测试基础设施。

## 第二阶段：组织、选民与候选人

- [ ] 组织架构：组织、部门、班级等层级与成员归属。
- [ ] 用户和选民资料：导入、停用、有效状态、组织范围查询。
- [ ] 选民资格规则：按组织、名单、身份属性或人工审核确定。
- [ ] 候选人管理：提名、自荐、资格材料、审核、撤回、取消资格和公示。
- [ ] 提供 Excel 批量导入/导出，导入须预校验并返回逐行错误。

## 第三阶段：选举活动与在线投票

- [ ] 活动状态机：草稿、待发布、公示中、投票中、已截止、计票中、已发布、已归档。
- [ ] 配置活动类型：单选、多选、多席位、赞成/反对/弃权。
- [ ] 配置时间窗口、选民范围、候选人范围、最少/最多选择数、平票和当选规则。
- [ ] 创建选民资格快照；投票开始前完成冻结，冻结后的变更必须走受控流程。
- [ ] 实现在线投票资格校验、时间校验、规则校验、限流和防重复投票。
- [ ] 分离“投票资格/已投状态”和“匿名选票”存储；常规查询不得反向关联。
- [ ] 通过数据库唯一约束、事务和并发控制保障每个活动每名选民只能完成一次投票。
- [ ] 实现投票回执，仅证明投票完成，不透露选票内容。
- [ ] 覆盖：越权、重复提交、截止边界、并发投票、非法候选人和异常恢复测试。

## 第四阶段：线下投票与计票复核

- [ ] 管理线下场次：地点、时间、票箱/票站、工作人员、监票员。
- [ ] 实现线下签到或名单核验，与线上已投状态交叉校验。
- [ ] 支持按候选人录入有效票、无效票和弃权票。
- [ ] 支持双人独立计票录入，自动比对并将差异送入复核。
- [ ] 实现计票批次、复核、监票确认、封存附件与更正版本记录。
- [ ] 已确认线下计票不得原地修改；更正必须保留前版本、原因、审核人与时间。
- [ ] 仅将“已确认”的线下票纳入活动最终汇总。

## 第五阶段：结果、公开看板与 CMS

- [ ] 按规则汇总线上有效票与已确认线下票，生成候选人得票、有效/无效/弃权统计及当选名单。
- [ ] 建立结果审核、监票确认、发布和归档流程。
- [ ] SignalR 推送公开看板数据，断线后使用受控轮询兜底。
- [ ] 公开看板显示活动状态、参与人数、参与率、数据更新时间和公开规则说明。
- [ ] 候选人实时票数、排名和图表只在活动明确开启后公开；不得公开未确认线下结果。
- [ ] CMS：栏目、文章、公告、政策、操作指南、候选人公示、结果公告、媒体库与附件。
- [ ] CMS 支持草稿、审核、发布、下线、定时发布、版本历史、回滚、分类、标签、SEO。
- [ ] 建立 CMS 内容与选举活动、公开看板、结果公告之间的关联。

## 第六阶段：安全、运维与交付

- [ ] 实现全量审计：配置、名单、审核、投票状态、线下计票、结果发布和 CMS 发布。
- [ ] 审计日志中不得存储线上匿名选票与选民身份的可查询关联。
- [ ] 配置接口限流、防自动化滥用、CSRF 策略（如采用 Cookie 会话）与安全响应头。
- [ ] 制定备份、恢复、归档和日志保留策略。
- [ ] 容器化部署：API、前端、PostgreSQL、Redis、MinIO、反向代理。
- [ ] 建立 CI：格式检查、编译、单元测试、集成测试、数据库迁移验证与镜像构建。
- [ ] 编写管理员、监票员、线下计票员、CMS 编辑与选民操作手册。

## 验收场景

- [ ] 无资格选民不能查看或提交目标活动的选票。
- [ ] 同一选民无法在线重复投票，也无法在线上与线下重复参与。
- [ ] 管理员可查看参与状态，但无法从正常业务查询获知匿名选民投给谁。
- [ ] 两份线下独立计票不一致时，结果不能进入最终汇总。
- [ ] 未审核/未确认的线下票不出现在对外公开看板或最终结果中。
- [ ] 实时公开数据严格遵守活动的公开策略，且不会泄露个人投票信息。
- [ ] 活动截止、结果确认、发布、撤销发布等关键动作均可审计追溯。
- [ ] CMS 内容经过审核后可公开发布，历史版本可追溯和恢复。