Metadata-Version: 2.4
Name: aps-kernel
Version: 0.0.1
Summary: Metis (谋序) — deterministic CP-SAT scheduling kernel, independent schedule validator, and headless CLI — APS standard edition
Author: APS Contributors
License: MIT
Project-URL: Homepage, https://aps.zhinengti.online
Project-URL: Documentation, https://github.com/123aiot/aps/tree/main/docs
Project-URL: Source, https://github.com/123aiot/aps
Project-URL: Changelog, https://github.com/123aiot/aps/blob/main/CHANGELOG.md
Keywords: aps,scheduling,production-planning,cpsat,ortools,finite-capacity,manufacturing,metis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Manufacturing
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: solver
Requires-Dist: ortools>=9.10; extra == "solver"
Requires-Dist: pydantic>=2.0; extra == "solver"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Dynamic: license-file

# aps-kernel — Metis 谋序（APS 标准版）

> **运筹帷幄，谋定后动** —— 同衡·谋序·同枢，智造同频。

可嵌入的**确定性**排产内核：CP-SAT 求解器、**独立复核器**、工序-资源适配数据模型、
设备槽位与班次日历、headless CLI。

> **标准版 vs 专业版**：本包只含可嵌入内核（无 UI / 无服务 / 无 LLM）。
> 甘特图前端、Web 控制台、AI 编排层（Copilot）、多租户 RLS、审批与 IM 通道、
> MRP/物料齐套联动、ATP/CTP 属专业版（Docker 镜像 + docker compose）。

> 🌐 官网：https://aps.zhinengti.online
> 家族产品：Nereus 同衡（数字孪生）· Hermes 同枢（物流调度）

---

## 状态

**v0.0.1 — 占位版本，求解内核开发中。**

本版本仅锁定包名与元数据，不含功能。功能版本计划：

| 版本 | 内容 |
|---|---|
| 0.1.0 | CP-SAT 求解内核 + 独立复核器跑通 |
| 0.2.0 | 约束 DSL + 设备槽位/排除约束 |
| 0.3.0 | 班次日历切段 + 甘特数据适配 |
| 1.0.0 | GA |

## 确定性的机制（为什么可以信）

规划中的确定性保证（与家族 `cps-twin` 的确定性文化一致）：

- 固定**分钟栅格**驱动，墙钟时间只出现在 `generated_at`，不进入求解结果
- `seed` 固定 + `interleave_search` ⇒ 同输入同结果
- `data_snapshot_hash` / `config_version` / `code_version` 进 **provenance**
- **独立复核器**：不信任求解器自报的加工时长，用输入数据重新核对任务、设备、数量与区间

> 求解器只保证「找到可行解」，复核器保证「导出的东西真的可行」。

## 安装（0.1.0 起可用）

```bash
pip install aps-kernel            # 核心
pip install "aps-kernel[solver]"  # 含 ortools + pydantic
```

## License

MIT
