Metadata-Version: 2.4
Name: deped-dcp-template
Version: 0.10.0
Summary: Shared templates and cleaning semantics for DepEd DCP data packages.
Requires-Python: >=3.14
Requires-Dist: click>=8.4
Requires-Dist: deped-primitives>=0.11
Requires-Dist: deped-runtime[excel]<0.7,>=0.6.1
Requires-Dist: email-validator>=2.3
Provides-Extra: r2
Requires-Dist: deped-runtime[r2]<0.7,>=0.6.1; extra == 'r2'
Description-Content-Type: text/markdown

# deped-dcp-template

`deped-dcp-template` owns the canonical v1.16 DCP workbooks, deterministic
lookup extraction, and DCP collection-value semantics. Version `0.10.0`
replaces the former catch-all cleaner module with focused, typed modules and
removes loader orchestration that belongs to consumers.

## Install

```bash
uv add deped-dcp-template
```

## Commands

```bash
uv run deped-dcp-template extract --templates-dir templates --output artifacts/base.db
uv run deped-dcp-template show --db artifacts/base.db
uv run --extra r2 deped-runtime r2 ls --prefix deped-dcp-template/templates
```

R2 support is optional and provided by `deped-runtime`.

## Public modules

- `normalization`, `values`, and `timestamps` handle submitted scalar values.
- `contacts`, `people`, and `entities` handle DCP collection records.
- `positions` and `equipment` expose immutable catalog builders and
  normalization policy.
- `audit` records shared DCP validation evidence.
- `extractor` and `template_assets` own canonical workbook artifacts.

Generic file, Excel, console, SQL, SQLite, and storage mechanics belong to
`deped-runtime`. Ecosystem-wide DepEd identity and governance semantics belong
to `deped-primitives`. In particular,
`deped_dcp_template.values.normalize_school_id` intentionally retains the
integer-coercion contract used by DCP collection schemas; it is not a
replacement for the Primitives school-identity APIs.

## Documentation and checks

- [Docs index](docs/index.md)
- [Architecture](docs/architecture.md)
- [Lookup extraction](docs/lookup-extraction.md)
- [Normalization](docs/normalization.md)
- [Downstream adoption](docs/downstream-adoption.md)

```bash
just check
```
