<!--
SPDX-FileCopyrightText: 2026 Team Centurions
SPDX-License-Identifier: AGPL-3.0-or-later
-->

# Work-Division Plan — Team Centurions

To deliver PageParse for the **CPU-First Hackathon**, responsibilities are allocated based on component expertise. Below is the team allocation and system ownership.

---

## 1. Core Responsibilities

| Role / Area | Owner | Key Deliverables |
|---|---|---|
| **Lead Architect & Backend Dev** | Varun | Preprocessing, ONNX Handwriting OCR integration, llama.cpp GBNF grammar parser, and SQLite persistence. |
| **Frontend Engineer & PWA Dev** | Varun | Vite + TS dashboard, offline localStorage failover state machine, interactive page detail viewer, and CSS. |
| **DevOps / QA / CI Automation** | Varun | pre-commit framework, GitLab CI config (`.gitlab-ci.yml`), semantic commit linter, and test coverage validation. |

---

## 2. Component System Ownership

```
┌────────────────────────────────────────────────────────┐
│                      PAGEPARSE UI                      │  ◄── Varun (Frontend)
└───────────────────────────┬────────────────────────────┘
                            ▼
┌────────────────────────────────────────────────────────┐
│                    FASTAPI BACKEND                     │  ◄── Varun (Backend)
└───────────┬───────────────┬────────────────┬───────────┘
            │               │                │
            ▼               ▼                ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│ PREPROCESS   │     │ INFERENCE    │     │ PERSISTENCE  │  ◄── Varun (Core Engine)
│ (OpenCV)     │     │ (ONNX/GGUF)  │     │ (SQLite/Vec) │
└──────────────┘     └──────────────┘     └──────────────┘
```

- **Image Preprocessing & OCR Pipeline:** Varun owns `preprocess.py`, `ocr/handwriting.py`, and `ocr/printed.py`.
- **Extraction & LLM Layer:** Varun owns `extract.py` and GBNF grammar files.
- **Storage & Search Engine:** Varun owns `store.py` and `search.py`.
- **Web UI & Telemetry:** Varun owns `web.py`, PWA assets, and `telemetry.py`.
- **Pipelines Orchestrator:** Varun owns `pipelines.py`.
- **CI/CD Quality Control:** Varun owns `.gitlab-ci.yml`, `.pre-commit-config.yaml`, and unit tests execution.

---

## 3. Dev Timeline & Milestones

- **Milestone 1: Spec and Plan (Phase 1)** — *Completed*
  - Draft Spec Kit and issue logs.
  - Setup team division.

- **Milestone 2: Engine MVP (Phase 2)** — *Completed*
  - Core pipelines (Ingestion -> Storage) passing unit tests.
  - CLI and local database verification.
  - PWA frontend built and bundled.

- **Milestone 3: CI/CD & Audit Compliance (Phase 3)** — *In Progress*
  - Integrate 10+ code audit tools.
  - Configure pre-commit and local GitLab runner pipelines.