用途:针对可部署的 TYPO3 站点/项目仓库(composer.json 中 type 为 project,且根目录有 Compose 文件)进行合规评分与加固,是扩展版 typo3-conformance 的站点/项目对应工具。适用场景包括审查容器拓扑、Concourse CI、供应链门禁、密钥处理、TYPO3 站点配置(config/system、config/sites),以及从金标准骨架引导新客户站点。扩展仓库应改用 typo3-conformance;通用供应链加固见 enterprise-readiness,Docker/Compose 见 docker-development,Concourse 见 concourse-ci。
主要能力:内置规则目录与可执行检查器,无需外部检出。规则位于 checker/rules.json(机器可读,由 checker/gen_rules.py 生成);检查器为 checker/check.py,用法:python3 checker/check.py <repo-path>,仅需 pyyaml,会对目标仓库评分并逐条打印 PASS/FAIL。规则分七族:STRUCT(TYPO3 原生布局,config/ 位于 composer 项目根,无 build/config,config/sites/*/config.yaml,提交 composer.lock,.gitignore 排除 vendor/var/public 及 live-env 文件);CONTAINER(使用 compose.yaml 而非 docker-compose.yml,镜像固定,第三方用 @sha256 摘要或非浮动标签,禁止 :latest/:edge,registry.netresearch.de 一方镜像可浮动,持久服务需 healthchecks、deploy.resources.limits、restart,禁止直接挂载 docker.sock);CI(composer audit → Trivy 门禁 → SBOM → cosign,CI 任务镜像固定,fly 下载校验和,密钥检测,测试门禁,通过 MR 更新);DEPLOY(Valkey 需认证、驱逐、无持久化;ofelia 调度器经 socket-proxy;每周恢复验证;日志输出到 stdout/stderr);DEP(声明 PHP 平台约束,无 dev 分支约束,minimum-stability: stable,提交 lock);SEC(不提交密钥,settings.php/additional.php 无密钥且由环境驱动,不提交 live-env 文件,无调试/主机通配符);DOC(AGENTS.md + CLAUDE.md 符号链接,README 记录 setup/env/make)。
使用方式:先确认 type: project 且根目录有 Compose,否则不适用;运行检查器或按上述族评估,ERROR 阻断、WARN 应修复、INFO 为建议;架构/资产/运行时规则(三仓库拆分、uptime、php-fpm 状态、ci-colocation)为建议性,只报告不阻断;修复后重新评分,仓库范围规则应保持 100%。
限制:typo3-14-gold 与 typo3-project-standard 为 Netresearch 内部且可选;规则变更需在 gen_rules.py 中提出。迁移旧版 support/typo3-NN/app 仓库、只读 settings.php、数据库种子等细节见对应参考文档。具体收费、价格、平台与效果资料暂未提供。