# content-explorer

> A user interface to dig into a field of interconnected knowledge. Inspired by onco.cc, the very well organized information collection about everything related to cancer.

**Stage:** research / repository seed, not yet a working application. **Reference:** https://github.com/judegomila/OnCo (code MIT; OnCo corpus CC BY-NC 4.0).

Start with [INTENT.md](INTENT.md), [research/OnCoDeepDive.md](research/OnCoDeepDive.md), [architecture/ArchitectureBlueprint.md](architecture/ArchitectureBlueprint.md), and [workplans/README.md](workplans/README.md).

## North-star demo

A single UI build loads either `systems-thinking` or `software-architecture`, shows the same browse/search/detail/connections experience, and needs zero edits to React components for the switch. Source references and rights follow every imported assertion.

## What this archive contains

Research grounded in publicly browsable upstream files, extraction plan, normative draft contracts, two independently authored small datasets, a basic connector example, executable fixture validator, roadmap and decision records. **It does not contain or claim to be a fork of upstream source.** Fetch and pin upstream at implementation time. See `scripts/bootstrap-upstream.sh`.

## Quick seed check

```sh
python3 scripts/validate_fixtures.py
python3 -m unittest tests.test_contract tests.test_ingest
```

## Implementation start

[CONTENT-WP-0000](workplans/CONTENT-WP-0000-upstream-baseline.md) pins upstream and records code provenance. [CONTENT-WP-0001](workplans/CONTENT-WP-0001-canonical-contracts.md) establishes clean domain fixtures. [CONTENT-WP-0002](workplans/CONTENT-WP-0002-ui-extraction.md) extracts the browse and detail shell. PRs should demonstrate test-backed progress against the acceptance criteria.

## OnCo comparison track

[CONTENT-WP-0007](workplans/CONTENT-WP-0007-onco-reference-slice.md) specifies a small, pinned, **authorized** OnCo reference-slice test program. No actual OnCo data is included. Public fixtures remain independently authored; real-data ingestion is disabled until the relevant data rights are cleared.