Aptli 的整体架构
在您开始操作任何单个页面之前，了解各部分之间的关联会很有帮助。Aptli 中的几乎所有内容都围绕着一个核心展开：一个 项目 包含 任务，每个任务都有 物料侧 和 工时侧， 这两个方面最终汇聚成一份由验证签发的报告。库存流动贯穿于整个体系之中。
本页面即为该主干的示意图。此处每个模块后续都有其详细指南——此处仅展示它们之间的连接关系。
整体架构
┌─────────────┐
│ PROJECT │ optional umbrella
└──────┬──────┘
│ groups many
▼
┌─────────────┐
│ JOB │ one unit of planned work
└──────┬──────┘
┌────────────────┴────────────────┐
│ │
MATERIAL stream WORK stream
"what gets used" "what gets done"
│ │
▼ ▼
┌─────────────────┐ ┌──────────────────┐
│ Resource lines │ │ Work Orders │
│ on the job │ │ (the dispatch) │
└───────┬─────────┘ └────────┬─────────┘
│ │
┌──────┴───────┐ ┌───────┴───────┐
▼ ▼ ▼ ▼
Registered Ad-hoc Registered Ad-hoc
RESOURCE (typed in by ACTIVITY (typed in by
(from your hand, not (from your hand, not
catalogue) registered) catalogue) registered)
这种结构是刻意重复的。**两条路径都提供相同的选择：**从已注册项的目录中调用，或临时手动输入。你绝不会被迫预先注册所有内容才能开始工作。
项目包含任务
项目是一个可选的“伞状结构”——可能是某项活动、网站上线，或是工作中的某个阶段。它将相关任务分组，并汇总其进度，让你能在一处查看整个项目的进展。
任务不必隶属于某个项目。许多工作都是无需归属的独立任务。项目仅在您需要汇总进度时才发挥作用，绝非必须遵守的繁文缛节。
任务包含两个流程
任务是计划工作的核心单元。可以将其视为由两个独立部分组成：
这两个流程并行运行，彼此不依赖。 一个项目可能包含材料但没有正式的活动，也可能包含活动但没有被追踪的材料。您只需在对项目有实际价值的地方，才为每一侧添加结构。
注册与临时 —— 反复面临的选择
在两个流程中，您都需要为每一行选择以下两种路径之一：
- 注册 —— 从您维护的目录中选择（资源 用于物料，活动 用于工作）。 注册能确保名称、单位、库存追踪和提货规则的一致性。
- 临时 —— 现场手动输入。无需预先注册。适用于一次性物料或不值得创建目录条目的特殊任务。
同一条记录可以混合使用这两种方式。 这是一种“更灵活的参考系统”——注册仅是增加追踪功能的选项，绝非阻碍工作的门槛。
两条流在报告中汇合
计划描述了“应该”发生的情况。报告则记录了“实际”发生的情况——这也是两条流汇合之处：
WORK stream MATERIAL stream
│ │
work performed material consumed
(against the activity) (against the resources)
│ │
└────────────────┬──────────────────┘
▼
┌─────────┐
│ REPORT │ what was actually done + used
└────┬────┘
▼
┌──────────────┐
│ VALIDATION │ sign-off
│ pass / fail │
│ needs-revision / approved-with-notes
└──────────────┘
报告将已完成的工作和消耗的材料记录在同一处。 验证是其上的质量把关环节：审核人员通过状态签字确认，该状态即为工作被接受的释放依据。报告和验证是该任务的审计轨迹——即使底层基础设施发生变更，它们仍会保留在记录中。
库存方面
物料流中的所有内容都由库存账本支撑。库存菜单包含四个视图，它们之间的关系如下：
RESOURCE ──┐
(what it is, │
the ├──► STOCK ITEM the live balance:
catalogue) │ "X of this resource, at this site"
│ │
SITE ──────┘ │ every change is written as a
(where stock lives: ▼
warehouse, depot, TRANSACTION receipt · transfer · pickup ·
or a person) consumption · adjustment · return
- 资源 — 目录条目：物料的本质（上文“已登记物料”选项中亦有涉及）。
- 地点 — 存放库存的场所。可以是物理位置（仓库、中转站、现场）或个人地点（工人的个人库存）。
- 库存项目 — 特定地点中某项资源的数量。库存余额仅通过交易发生变化。
- 交易 — 每笔进出记录的不可篡改记录。这是审计轨迹；若需更正错误，应添加调整项，绝不直接编辑历史记录。
消耗的物料会发生什么
当报告显示物料已被使用时，这种消耗并非仅仅从表格中消失——它会实际移动库存。消耗的物料有两种去向：
┌──────────┐ consumed ┌────────────────────────────┐
│ SITE │ ───────────────► │ Used up at the job │
│ (stock) │ │ Gone — but recorded forever │
└────┬─────┘ │ as a consumption record │
│ └────────────────────────────┘
│ transferred / picked up
▼
┌──────────────┐
│ Person or │ Carried out as tracked inventory —
│ another site │ still on the books, just moved
└──────────────┘
- 在工地上消耗 —— 材料已被使用。 库存余额减少，并生成永久消耗记录。无法删除已使用记录；更正需通过添加调整项进行，绝不能删除历史数据。
- 作为受控库存从现场移出 —— 物料离开仓库但并未消失。 它被转移到另一个地点或由工人领走，因此在实际使用前，它仍会以新位置的记录形式保留在账上。
无论哪种情况，库存账目始终保持一致：离开某地的库存要么已被消耗，要么现在位于系统可定位的其他位置。
整合流程
典型的端到端流程：
- 计划 — 创建工单（可选：归入项目）。为物料添加资源行，并分发包含具体活动的工单。
- 授权与领料 — 工人从指定地点提取所需的已登记物料。
- 执行工作 — 在现场根据工作单的活动内容进行作业。
- 报告 — 记录已完成的工作及消耗的材料。
- 确认 — 审核人员签字确认，这既代表接受工作成果，也最终确认了材料消耗。
下一步操作
本页的每个模块均配有完整指南：
有三个菜单项位于该主框架旁，而非其内部：
- 首页 — 显示上述所有内容的进度和库存汇总仪表盘。
- 现场记录 — 地图。任务和地物在此具有地理位置；参见 地图概念。
- 求助请求 — 针对任何记录发起并跟踪支持请求。
接下来：谁能查看和修改什么 — 了解 Aptli 如何决定每个人被允许查看和编辑的内容。