# STARTHERE — mgf-fed-web

> **Sibling package in the Magogi Foundation federation.**
> See [README.md](README.md) for what it is; [FEDERATION.md](FEDERATION.md) for
> the federation contract.

`mgf-fed-web` is the **federation dashboard** — a read-mostly FastAPI + Jinja web tool
that, per project, composes and displays the schema-governed `fed-resources/generated/`
state the **`mgf-fedres`** spine produces (status / roadmap / architecture / focus /
suggestions + sync state + feedback rounds + live activity). It **never authors project
state**: it composes + displays, tags anything it computes `derived`, and renders with
the **`mgf-brand-web`** operator-instrument layer. The read / sync / live logic all lives
in the spine; this distribution is a thin presentation layer over it.

## Status — skeleton

This repo is at the **skeleton** stage (0.1.0, Pre-Alpha): the DOC-01 doc baseline +
the packaging shape (the `mgf.fed_web` namespace package + the FastAPI/Jinja
distribution) exist; the app itself — routes, templates, the lenses, the sync UI, the
feedback loop, Follow-live — is **M2+ and not yet built**. The spine (`mgf-fedres`) is
built and published first.

## For operators (once the M2+ app lands)

```bash
pip install mgf-fed-web   # resolves from the self-hosted devpi index
mgf-fed-web               # serves the dashboard on 127.0.0.1 (local, single-user)
```

## For contributors

See [CONTRIBUTING.md](CONTRIBUTING.md). Standards inherited from
[mgf-common](https://codeberg.org/magogi-admin/mgf-standard/src/branch/main/docs/standards/).

## Quick links

| Resource | Where |
|---|---|
| What it is + the layering | [README.md](README.md) |
| The authoritative spec + brief + wireframe | [`mgf-fedres/docs/planning/mgf-fed-web/`](https://codeberg.org/magogi-admin/mgf-fedres/src/branch/main/docs/planning/mgf-fed-web/) |
| The end-to-end plan (this tool = Phase B) | [`mgf-fedres/docs/planning/PLAN.md`](https://codeberg.org/magogi-admin/mgf-fedres/src/branch/main/docs/planning/PLAN.md) |
| Scope policy | [SCOPE.md](SCOPE.md) |
| Deps / consumers | [DEPS.md](DEPS.md) |
| Conformance ledger | [docs/inprogress/MGF_STANDARDS_CONFORMANCE.md](docs/inprogress/MGF_STANDARDS_CONFORMANCE.md) |
| Federation contract | [FEDERATION.md](FEDERATION.md) |
