Selega 文档
Selega 是一款用于财务报表（estados contables，EECC）合法化的控制工具。它获取一套报表的规范数字，对其运行一组数字交叉核对，走完一份各辖区的核对清单，并提出一个处理结论。本页将逐一介绍各个部分。
流程：上传 → 实时验证 → 结论
Section titled “流程：上传 → 实时验证 → 结论”- 录入数字。 Selega 填充一套规范的数字结构，这些数字分布于财务状况表（ESP）、损益表（ER）、权益变动表（EEPN）、现金流量表（EFE）、各附表与附注中。该结构可通过三种方式填充：
- 手工，在网格中填写——始终可用。
- 通过本地提取引擎——在 PDF 画布上套用按格式定制的模板，配以逐区域 OCR（Tesseract）与来源追溯。无网络，私密。这是默认路径。
- 通过受控 AI 引擎——可泛化适应任意格式，但会将数据发送至云端，因此默认关闭、需主动启用（见下文受控 AI）。
- 实时验证。 随着数字录入，交叉核对会持续运行。每个数字在被某项交叉核对印证时标为绿色，在进入某项无法平衡的核对时标为琥珀色。审核人员予以确认；任何不一致的数字都无法通过。
- 核对清单。 在数字核对之外，还会审核该辖区的形式控制核对清单。
- 结论。 决策引擎汇总未通过的核对项并提出处理结论——合法化、提出异议、签字认证或拒绝 / 退回。
规范数字结构
Section titled “规范数字结构”Selega 将一套财务报表建模为一个扁平的数字与标志结构（定义于 src/core/schema.js），与其来源的 PDF 格式无关。这些数字涵盖：
- ESP（财务状况）： 资产总额、负债总额、权益、期末及期初的现金及银行存款。
- EEPN（权益变动）： 期末权益、本年度结果。
- ER（损益表）： 最终结果。
- EFE（现金流量）： 方法（直接法 / 间接法）、期初及期末现金、现金变动、经营 / 投资 / 筹资活动现金流、现金的 RECPAM。
- 附表： 本年度固定资产折旧、费用附表中的折旧。
- 附注 / 封面： SIPA 社会保障债务、公司类型、放弃法定监事的附注、负权益附注。
数字交叉核对
Section titled “数字交叉核对”交叉核对是 Selega 的核心。它们是通用的——FACPCE 标准在全国适用——因此同一组核对会作为每个辖区的种子；因委员会而异的是形式控制目录及其后果。它们以数据形式存储（规则包中的一组 JSON 交叉核对），由一个通用引擎进行评估，因此管理员可以从可视化构建器中编辑它们，而无需触碰代码。
默认组包含下列交叉核对。比较时使用一个小的容差（默认 1 个货币单位）以吸收舍入误差。每一项要么是比较（两边必须相等），要么是存在性核对（某个数字或附注在某条件下必须存在）。默认情况下，本组中的每一项交叉核对都带有直接拒绝的后果，但该后果可按每项交叉核对进行配置。
| # | 交叉核对 | 验证内容 |
|---|---|---|
| 1 | 会计恒等式（A = P + PN） | 资产总额等于负债总额加权益（ESP）。 |
| 2 | 权益：ESP = EEPN | ESP 中的权益等于 EEPN 中的期末权益。 |
| 3 | 结果：ER = EEPN | 损益表的最终结果等于 EEPN 中结转的结果。 |
| 4 | 现金：ESP = EFE（期末） | ESP 中的期末现金及银行存款等于 EFE 中的期末现金。 |
| 5 | EFE 变动 = 期末 − 期初 | 现金变动等于期末现金减期初现金。 |
| 5b | EFE 变动 = 经营 + 投资 + 筹资 | 现金变动等于经营、投资与筹资活动现金流之和。 |
| 6 | 结果：ER = EFE（间接法） | 最终结果与 EFE 的结果相符。仅当 EFE 方法为间接法时。 |
| 7 | 折旧：ER = EFE（间接法） | 损益表中的折旧等于 EFE 中的折旧。仅限间接法。 |
| 8 | 所得税：ER = EFE（间接法） | 损益表中的所得税等于 EFE 中的所得税。仅限间接法。 |
| 9 | EFE 中列示现金的 RECPAM | 存在一行专门的现金 RECPAM。仅当 EFE 方法为直接法时。 |
| 10 | 折旧：固定资产附表 = 费用附表 | 本年度折旧在两份附表之间相符。 |
| 11 | 第 17.250 号法第 10 条社会保障 | SIPA 社会保障债务声明存在。 |
| 12 | 负权益附注 | 当权益低于零时，必须存在所要求的附注。 |
| 13 | 放弃法定监事附注 | 对于 SA / SAS 类公司，必须存在放弃法定监事的附注（第 284 条）。 |
交叉核对结果
Section titled “交叉核对结果”每项交叉核对会评估为四种状态之一：OK（平衡）、DIFIERE（不平衡——所涉数字被标为琥珀色）、NA（在当前条件下不适用，例如 EFE 为直接法时的仅限间接法的核对）或 FALTA（缺少某个必填数字）。
返回为 DIFIERE 的交叉核对会被转化为异议，每条异议都带有其交叉核对所定义的后果。决策引擎（src/core/decision.js）随后按后果优先级计算汇总结论：
- 直接拒绝 → 该工作被拒绝 / 退回。如果已缴纳草稿费（tasa borrador），则改为退回以待更正。
- Subsanable（可更正） → 若已缴纳草稿费则退回以待更正；否则，若专业人士选择不更正，则予以合法化。
- 签字认证 → 降级为仅认证签字。
- 无阻断性异议 → 予以合法化。
加急费（tasa urgente）若叠加任何异议，则丧失其加急状态，该工作退回至一般重新受理列表。可能的结论有：Se legaliza（合法化）、Se devuelve para corregir（退回更正，草稿费）、Se certifica solo la firma（仅认证签字）以及 Se deniega / se devuelve（拒绝 / 退回）。
- Selega 自带阿根廷 24 个辖区的登记表；每个辖区要么已完整定义，要么是待填充的模板。
- 每个委员会定义自己的规则包：形式控制目录、启用哪些交叉核对，以及后果。某辖区本地编辑过的规则包会覆盖仓库中自带的规则包。
- 交叉核对是通用的（FACPCE 标准全国适用）；因委员会而异的是形式控制与后果。
- 管理员选择某次安装服务于哪些辖区，并从页眉切换当前辖区。
角色与审核工作流
Section titled “角色与审核工作流”Selega 有五种角色——受理员、主管、审计员、管理员、超级管理员——配以可配置的审核工作流、信号灯式收件箱以及可导出的只读案卷。访问权限既在视觉上受控（禁用某角色不可执行的操作），也在后端真正受控。
AI 默认关闭且可插拔。它可针对本地引擎（Ollama，例如在 CPU 上运行的 Qwen2.5-VL）或云端（OpenRouter）运行，本地优先。云端路径受三个条件控制：在管理后台中启用、存在 API 密钥，以及按文档授权——因为它是唯一会将数据发送到容器之外的路径。API 密钥保存在服务器端（从管理后台加载时以只写方式存储）。
Selega 的状态存放于 PostgreSQL（compose 文件中的 db 服务，通过 DATABASE_URL 连接）。数据库持久化于 selega-pg 卷中——它是合法化记录所在，请务必备份。应用容器自身只读取 /app，并将 OCR 输出写入 /tmp。
一切均通过环境变量配置（12-factor）——完整表格见安装 Selega。在运维层面，你需要设置的是 POSTGRES_PASSWORD（必填）、管理员邮箱、是否处于 TLS 之后（SELEGA_SECURE_COOKIE）、主机端口，以及可选的云端 AI 密钥（最好从管理后台加载）。各辖区规则、交叉核对、核对清单和用户全部从界面中的管理与系统面板编辑——无需改动代码。
原生 JS（ES 模块，无框架）· Node.js（自带 HTTP 服务器）· PostgreSQL（pg）· Docker · 内置 pdf.js / Tesseract.js / pdf-lib · 可选的用于本地 AI 的 Ollama。