CarbonOps-Parser is a public climate-tech data infrastructure project for auditable carbon accounting source ingestion and validation. It documents Python, .NET, and PostgreSQL boundaries for public emission factors from GHG Protocol, DEFRA/DESNZ, and IPCC EFDB without claiming production carbon-accounting correctness.
- README - project positioning, safe quickstart, supported source families, status, and roadmap summary.
- Final Project Production-Ready Verdict - narrow project-level production-ready verdict and explicit non-claims.
- Production Parity Contract - Python production path and .NET parity evidence.
- Production Packaging And Operator Runbook - supported Python operator path, PostgreSQL readiness, cron scheduling, verification, and troubleshooting.
- Python Ingestion Local Runbook - local Docker PostgreSQL ingestion runbook for the packaged Python path.
- .NET Runtime Docs - .NET Worker Service path and parity-oriented runtime notes.
- Architecture - Python, .NET, PostgreSQL, validation, diagnostics, and dry-run boundaries.
- Examples - deterministic local examples and fixture entry points.
- Database Model - shared ingestion metadata and source-specific table groups for GHG Protocol, DEFRA/DESNZ, and IPCC EFDB.
- Database Startup - PostgreSQL startup expectations and local database notes.
- PostgreSQL Runtime Readiness Checklist - database readiness checks for the supported PostgreSQL boundary.
- PostgreSQL Phase 1 Schema Contract - Phase 1 schema contract details.
- Phase 2 Roadmap And Execution Boundary - next-stage roadmap and safety gates.
- Phase 2 Runtime And Source Expansion Review Gate - review gate before runtime or source-family expansion.
- Release Notes Draft - draft notes for a first public alpha/review release.
- Maintainer Release And Sync Checklist - develop-to-main alignment, stale PR/issue cleanup, and alpha/review tag readiness.
- Contribution Guide - issues, features, forks, branches, pull requests, validation, secrets, artifacts, and maintainer-only merge policy.
- Support Policy - support boundaries and safe information-sharing guidance.
- Security Policy - responsible disclosure and no-secret expectations.
- Issue Templates - bug reports, feature requests, documentation requests, and production-readiness questions.
- Pull Request Template - PR checklist for scope, validation, runtime impact, PostgreSQL impact, docs, secrets, artifacts, and production-ready claims.
Repository topics cannot be configured through repository files, but maintainers can use these suggested GitHub topics when publishing or reviewing the public repository:
carbon-accounting, emission-factors, carbon-emissions, ghg-protocol, defra-desnz, ipcc-efdb, climate-tech, data-ingestion, python, dotnet, postgresql, postgres, etl, data-validation, open-source
Search-friendly project description:
Auditable public carbon emission factor ingestion and validation for climate-tech data infrastructure, with Python and .NET contracts, PostgreSQL readiness, non-destructive dry runs, and documented support boundaries for GHG Protocol, DEFRA/DESNZ, and IPCC EFDB.
Discovery wording should stay conservative. The repository may describe source ingestion, parsing, validation, diagnostics, dry-run previews, and reviewable PostgreSQL readiness. It should not claim production carbon-accounting correctness, compliance correctness, legal correctness, source-owner correctness, or factor correctness.
- Architecture
- Configuration Model
- Background Job Model
- Database Model
- Database Startup
- Ingestion Metadata Model
- Ingestion Contracts
- Engineering Standards
- Production Packaging And Operator Runbook
- Python Ingestion Local Runbook
- Source Support
- Source Discovery
- Source Ingestion Boundaries
- Source Acquisition Boundary
- Source Acquisition Sequencing Checklist
- Local Source Acquisition Contract Boundary
- Local Source Acquisition Examples Boundary
- Local Source Manifest Boundary
- Local Source Manifest Examples Boundary
- Source Manifest Adapter Handoff Boundary
- Source Manifest Adapter Handoff Examples Boundary
- Source Acquisition Validation Boundary
- Source Acquisition Validation Examples Boundary
- Source Acquisition Error Taxonomy Boundary
- Source Acquisition Error Taxonomy Examples Boundary
- Source Acquisition Review Gate Boundary
- Source Acquisition Review Gate Examples Boundary
- Source Acquisition Implementation Readiness Boundary
- Source Acquisition Implementation Readiness Examples Boundary
- Source Acquisition Implementation Sequencing Checklist
- Source Acquisition Implementation Sequencing Examples Boundary
- Source Acquisition Registry
- Source Acquisition Target Planning
- Source Acquisition HTTP Client Boundary
- Source Acquisition Manifest Boundary
- Source Acquisition Run Boundary
- Source Acquisition CLI Boundary
- Source Acquisition Parser Handoff Contract
- Artificial Source Acquisition Validation Pipeline
- Artificial Source Acquisition Module Recap
- Artificial Source Acquisition Phase Closure
- Artificial Manifest Metadata Boundaries
- Artificial Manifest Validation Summary
- Artificial Manifest Metadata Collection
- Artificial Manifest Collection Validation Summary
- Artificial Manifest Metadata Phase Recap
- Artificial Manifest Next Phase Option Matrix
- Artificial In-Memory Manifest Usage Example
- Artificial Manifest Usage Example Phase Recap
- Source Adapter Contract
- Source Adapter Execution Flow
- Source Adapter Error And Warning Handling
- Source Adapter Configuration Boundaries
- Source-Specific Adapter Skeleton Guidance
- DEFRA/DESNZ Adapter Skeleton Boundaries
- Parser Adapter Boundary
- Parser Execution Planning Boundary
- Parser Execution Result Boundary
- Parser Execution Runner Boundary
- Source-Specific Parser Adapter Boundary
- Parser File Content Input Boundary
- Local Parser File Content Loader Boundary
- Parser Execution Normalization Handoff Boundary
- Parsed Raw Record Payload Boundary
- Parser Handoff Boundary
- Parser Contract Boundaries
- Source-Specific Parser Skeleton Boundaries
- DEFRA/DESNZ Parser Skeleton Boundaries
- Real Format Parser Boundary
- Normalization Boundary
- Normalization Input Boundary
- DEFRA/DESNZ Minimal Normalization Mapping Boundary
- Local File Normalized Persistence Dry-Run Boundary
- Local Dry-Run CLI Boundary
- Local Dry-Run Troubleshooting
- Normalized Result Persistence Boundary
- PostgreSQL Persistence Schema Boundary
- PostgreSQL DDL Preview Boundary
- PostgreSQL Insert SQL Builder Boundary
- PostgreSQL Persistence Preview Boundary
- Persistence Repository Boundary
- PostgreSQL Implementation Safety Gate
- PostgreSQL Integration Test Boundary
- PostgreSQL Integration Test Container Strategy
- PostgreSQL Opt-In Integration Runbook
- PostgreSQL Config Contract Boundary
- PostgreSQL Repository Skeleton Boundary
- PostgreSQL Repository Implementation Planning Boundary
- PostgreSQL Runtime Persistence Implementation Plan
- PostgreSQL Driver Dependency Decision
- PostgreSQL Connection Session Contract Boundary
- PostgreSQL Execution Adapter Boundary
- PostgreSQL Transaction Policy Boundary
- PostgreSQL Idempotency Conflict Strategy Boundary
- PostgreSQL psycopg Session Adapter Boundary
- PostgreSQL Disabled Runtime Execution Adapter Boundary
- PostgreSQL Repository Disabled Execution Preview Boundary
- PostgreSQL Runtime Execution Gate Boundary
- PostgreSQL Phase 1 Schema Contract
- PostgreSQL Bootstrap Boundary Contract (Phase 1)
- PostgreSQL Schema Bootstrap Execution Adapter Boundary
- PostgreSQL DDL Strategy Contract (Phase 1 Planning)
- PostgreSQL Runtime Readiness Checklist
- PostgreSQL Runtime Readiness Checkpoint
- Parser To Normalization Handoff Boundary
- Parser To Normalization Integration Recap
- Source To Normalization Pipeline Recap
- Normalization Execution Boundary
- Normalization Result Summary Boundary
- Normalization Summary Builder Boundary
- Normalization Pipeline Recap
- Normalization Public API Recap
- Normalization Test Coverage Recap
- Normalization Deferred Implementation Roadmap
- Public Roadmap Checkpoint
- Milestone Checkpoint CO-037 To CO-049
- Governance Smoke Test Checkpoint
- Stabilization Checkpoint
- Production Readiness Gap Analysis
- Production Readiness Sequencing Roadmap
- Production Parity Contract
- Final Project Production-Ready Verdict
- Production E2E Ingestion Readiness Contract
- PH-017 Production E2E Docker PostgreSQL Release Validation
- PH-018 Real Production-Ready Ingestion Contract
- Final Phase 1 Production Readiness Review
- Phase 2 Roadmap And Execution Boundary
- Phase 2 Runtime And Source Expansion Review Gate
- Release Notes Draft
- Repository Navigation Guide
- Review Readiness Checklist
- Documentation Map Consistency Checklist
- Source Adapter Package Recap
- Roadmap
- Task Breakdown
- Limitations
- Public Safety