# ODPP Digitisation Programme — Documentation Pack

Documentation and a working prototype for the Complaints Management & File Movement digitisation programme, prepared for the Office of the Director of Public Prosecutions (ODPP), Uganda.

Live at **https://odpp-pack.africangraphyte.dev**. Open [index.html](index.html) to browse the full pack locally.

## Contents

**Start here — overview & identity**
- [ODPP Digitisation Pack.dc.html](ODPP%20Digitisation%20Pack.dc.html) — Programme scope, targets, waves and role-based reading paths.
- [ODPP Brand and Process Reference.dc.html](ODPP%20Brand%20and%20Process%20Reference.dc.html) — Brand identity, colour palette, regional offices, directorates.

**Technical specification**
- [ODPP Complaints Record System Blueprint.dc.html](ODPP%20Complaints%20Record%20System%20Blueprint.dc.html) — Entity model, lifecycle, numbering, permissions.
- [ODPP Seed Data and Django Map.dc.html](ODPP%20Seed%20Data%20and%20Django%20Map.dc.html) — Django app map and seed data, written as a build reference.
- [ODPP Barcoding Specification.dc.html](ODPP%20Barcoding%20Specification.dc.html) — Jacket label design, QR payload and scan grammar.
- [ODPP Parallel Running Model.dc.html](ODPP%20Parallel%20Running%20Model.dc.html) — Track-scan vs. page-scan, operating rules for running alongside paper files.

**Prototype & assurance**
- [ODPP Case Pipeline Prototype.dc.html](ODPP%20Case%20Pipeline%20Prototype.dc.html) — Interactive working demo (officer sign-in, public complaint tracker).
- [ODPP Production Assessment.dc.html](ODPP%20Production%20Assessment.dc.html) — Real-world scenarios, legal checklist, RBAC review.

## How the pages work

Each `.dc.html` document is a self-contained page rendered by [support.js](support.js), a small document-component runtime that resolves `<x-dc>` templates, handles conditional/loop blocks, and applies the shared design tokens from `_ds/`. Every page:

- Links `support.js` for its rendering logic.
- Loads shared fonts, colours and components from `_ds/sprint-internet-tz-design-system-019de452-ba3c-7c38-afd2-c723b208c512/`.
- Carries its own `<title>`, description, favicon and Open Graph/Twitter tags so it previews correctly if shared individually (e.g. on WhatsApp).
- Is responsive out of the box (fluid `clamp()` spacing/type, wrapping grids).

No build step or server is required — open any file directly in a browser, or serve the folder with a static file server.

## Repository structure

```
/
├── index.html                        Documentation index (start here)
├── README.md                         This file
├── support.js                        Document-component runtime used by every page
├── ODPP *.dc.html                    The eight documents listed above
├── _ds/                               Shared design system (fonts, colours, UI components)
├── uploads/                           Images referenced by the documents (incl. ODPP-ICON.png favicon/logo)
├── _headers                           Cloudflare Pages response headers (caching, security)
├── _redirects                         Cloudflare Pages redirects (clean URL aliases, 404 fallback)
├── 404.html                           Custom not-found page
└── wrangler.toml                      Cloudflare Pages project config
```

## Deploying to Cloudflare Pages

This is a static site — no build command or output directory beyond the repo root is needed.

**Option A — connect a git repo (Cloudflare dashboard):**
1. Push this folder to a GitHub/GitLab repository.
2. In the Cloudflare dashboard: Workers & Pages → Create → Pages → connect the repo.
3. Build command: none. Build output directory: `/`.
4. Deploy. Then add `odpp-pack.africangraphyte.dev` as a custom domain on the project.

**Option B — direct upload with Wrangler CLI (no git required):**
```
npx wrangler pages deploy . --project-name=odpp-pack
```
`wrangler.toml` already sets the project name and output directory, so this command can be run straight from this folder.

Clean URLs such as `/digitisation-pack` and `/complaints-blueprint` are mapped to the long `.dc.html` filenames via `_redirects` — use these when sharing links.

## Notes

- The pack references a Django backend (apps: `core`, `cases`, `complaints`, `conduct`, `insight`) as the intended implementation target; that code is not included in this repository, only described in the specification documents above.
- `og:image`/`og:url` meta tags use the live domain `https://odpp-pack.africangraphyte.dev`. If the domain ever changes, update it across the `.dc.html` files and `index.html`.