# AIFDE

**Repository Path**: ccstclink/aifde

## Basic Information

- **Project Name**: AIFDE
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-02
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI FDE 系统 · 代码仓库（并行开发基线）

契约来源：`I:/AIFDE/TXT/1102/` 13 份文档 + `1102_多轮审计结论汇总.md`（唯一契约来源，只读）。

## 目录（03 §12 + 本启动方案）

| 目录 | 内容 | 责任流 |
|---|---|---|
| `ontology/` | 本体仓库（05 §3.1 三层目录；种子含 core v0.2.0） | S1 |
| `schemas/` | 契约：Pydantic + TS 类型（自 ontology 自动生成）+ 统一错误契约 + 消息信封 | S1 |
| `services/` | 服务实现（M0 六容器单体：chat/router/perception/runtime/executor/gateway，02 §14；M1 十服务拆分） | S2–S5 |
| `connectors/` | 数据接入域：SPI 框架 + 三连接器 + writer 骨架 + conformance（S3 已交付，08 §3） | S3/S5 |
| `edge/` | 边缘数采网关：SQLite WAL 缓存/断网补传/单向发送（02 §4.4，S3 已交付） | S3 |
| `skills/` | 技能包（05 §3.5 技能包结构） | S4 |
| `prompts/` | 提示词资产 | S4 |
| `frontend/` | Web 工作台 Vue3+Vite+Element Plus / PWA（03 §1，ADR-012） | S6 |
| `deploy/` | K3s/Helm/离线包（03 §7.1） | S7 |
| `tests/` | CI 验证（pytest；通用纪律 ③：无验证的交付视为未完成） | 全部 |
| `docs/` | 治理文档与生成目录 | S1 |

## 契约冻结纪律

1. 00–13 号契约文档只读；修订建议写入交付报告"契约修订建议"节，S1 统一裁决（00 §7.3 顺序：术语 00 → 数据 05 → 参数 03 → 设计 02/06/07/08 → 流程 04 → 商业 01）。
2. 其余流以 tag `contract-v0.4` 为编译依赖。
3. 交叉约定：`trace_id` 全链路透传（信封 → span → badcase，02 §13）；统一错误契约（05 §9.1，retryable/remediation 必填）；端口见 `docs/ports.md`（02 §13）。

## CI 验证（当前全部可跑）

```powershell
python schemas/generate.py          # 本体校验 + 契约再生成（幂等）
python tools/ontology_validator.py  # 03 §5.2 校验（M0 第一周硬门禁）
python -m pytest tests/ -q          # 契约测试 + S3 连接器/边缘网关全套（conformance 37 例）
```

> S3 依赖：核心仅 pydantic/PyYAML/pytest；真实驱动（asyncua/pymodbus/psycopg/kafka）为可选 extras（`pip install -e .[opcua,modbus,cdc,kafka]`），CI 全部走 mock 源。

## 已登记的契约修订建议（→ S1 裁决）

- 05 §3.2 标注"actions 10 个"但实列 11 个（N6 补 QueryWorkOrder）——见 `tests/test_ontology.py` 注释。
- 05 §3.1 目录清单漏列 `org_unit.yaml`（对象在 §3.2 中存在）——已在 `ontology/core/org_unit.yaml` 头注释登记。
- 审计汇总称 core 本体为 "v0.3.0"，正文 YAML 为 v0.1.0+v0.2.0 增量（R7 口径漂移）——本仓库以 ontology YAML 为单一事实源（core v0.2.0）。
- 21 个稳定错误码为 P1 批次目标，本种子 18 码起步（digest 锁定，扩展须更新 `schemas/errors.yaml` 并复跑生成器）。