# usgpo/house-manual architecture

> Architecture diagram of the GitHub repository usgpo/house-manual, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/usgpo/house-manual
- Repository: https://github.com/usgpo/house-manual

## Overview

##### Project type and purpose
- This is not a web application or a microservice suite, but an open-source data distribution repository.
- It publishes House Rules and House Manual XML content (112th–117th Congress) along with corresponding XSL and CSS style sheets.
- It is intended for bulk download and rendering (via XSLT) by the Government Publishing Office (GPO), govinfo, and end-users.

##### File structure
- Top-level directories “112”, “113”, “114”, “115”, “116”, “117” – each represents one Congress cycle.
- Under each, “govinfo-file-names” mirrors the filenames as published on govinfo (XML source, CSS/XSL for graphics)
- “original-file-names” holds the original XML and style files from the House Parliamentarian/Clerk.
- Root contains:
- README.md – high-level overview and bulk data links
- HMAN-XML_User-Guide.* – usage instructions for consumers
- CODEOWNERS – GitHub maintenance
- No server-side code or build scripts—this is a static content repository.

##### README for additional insights
- Confirms that XML packages and GPO-CLERK rule pamphlets are published via govinfo bulk data.
- Shows public URLs for each session’s XML package.
- Mentions an XSLT/CSS pipeline to convert XML into styled HTML (the “graphics-support-documents”).

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% Data Store: GitHub Repository
  subgraph "GitHub Repository (Data Store)"
    direction TB
    README["README.md"]:::data
    CODEOWNERS["CODEOWNERS"]:::data
    GUIDE_MD["HMAN-XML_User-Guide.md"]:::data
    GUIDE_PDF["HMAN-XML_User-Guide-v1.pdf"]:::data
    subgraph "Congress Content Folders"
      direction TB
      %% Congress folders with govinfo and original
      subgraph "112"
        direction TB
        GOV112["govinfo-file-names/"]:::data
        ORIG112["original-file-names/"]:::data
        GSD112["graphics-support-documents/"]:::data
      end
      subgraph "113"
        direction TB
        GOV113["govinfo-file-names/"]:::data
        ORIG113["original-file-names/"]:::data
        GSD113["graphics-support-documents/"]:::data
      end
      subgraph "114"
        direction TB
        GOV114["govinfo-file-names/"]:::data
        ORIG114["original-file-names/"]:::data
        GSD114["graphics-support-documents/"]:::data
      end
      subgraph "115"
        direction TB
        GOV115["govinfo-file-names/"]:::data
        ORIG115["original-file-names/"]:::data
        GSD115["graphics-support-documents/"]:::data
      end
      subgraph "116"
        direction TB
        GOV116["govinfo-file-names/"]:::data
        ORIG116["original-file-names/"]:::data
        GSD116["graphics-support-documents/"]:::data
      end
      subgraph "117"
        direction TB
        GOV117["govinfo-file-names/"]:::data
        ORIG117["original-file-names/"]:::data
        GSD117["graphics-support-documents/"]:::data
      end
    end
  end

  %% Ingestion Pipeline
  Ingestion["Bulk Data Ingestion Pipeline"]:::process

  %% Bulk Data Store
  BulkStore[(govinfo Bulk Data Store)]:::data

  %% XSLT/CSS Processing
  Processor["XSLT/CSS Processing Engine"]:::process
  Output["HTML Output"]:::external

  %% Consumers
  subgraph "Consumers"
    direction TB
    WebUI["govinfo.gov Web UI"]:::external
    CLI["CLI/3rd-party Apps"]:::external
    Browser["End-user Browser"]:::external
    StaticHost["Static Site Host"]:::external
  end

  %% Data Flows
  GitRepo["GitHub Repository"]:::data
  GitRepo -->|"push"| Ingestion
  Ingestion -->|"publish"| BulkStore
  BulkStore -->|"download raw XML/CSS/XSL"| CLI
  BulkStore -->|"download raw XML/CSS/XSL"| WebUI
  GitRepo -->|"clone"| CLI

  %% Processing Flow
  GSD112 -->|"transform"| Processor
  GSD113 -->|"transform"| Processor
  GSD114 -->|"transform"| Processor
  GSD115 -->|"transform"| Processor
  GSD116 -->|"transform"| Processor
  GSD117 -->|"transform"| Processor
  Processor -->|"generate HTML"| Output
  Output --> Browser
  Output --> StaticHost

  %% Click Events for component mappings
  click README "https://github.com/usgpo/house-manual/blob/main/README.md"
  click CODEOWNERS "https://github.com/usgpo/house-manual/tree/main/CODEOWNERS"
  click GUIDE_MD "https://github.com/usgpo/house-manual/blob/main/HMAN-XML_User-Guide.md"
  click GUIDE_PDF "https://github.com/usgpo/house-manual/blob/main/HMAN-XML_User-Guide-v1.pdf"
  click GOV112 "https://github.com/usgpo/house-manual/tree/main/112/govinfo-file-names/"
  click ORIG112 "https://github.com/usgpo/house-manual/tree/main/112/original-file-names/"
  click GSD112 "https://github.com/usgpo/house-manual/tree/main/112/govinfo-file-names/graphics-support-documents/"
  click GOV113 "https://github.com/usgpo/house-manual/tree/main/113/govinfo-file-names/"
  click ORIG113 "https://github.com/usgpo/house-manual/tree/main/113/original-file-names/"
  click GSD113 "https://github.com/usgpo/house-manual/tree/main/113/govinfo-file-names/graphics-support-documents/"
  click GOV114 "https://github.com/usgpo/house-manual/tree/main/114/govinfo-file-names/"
  click ORIG114 "https://github.com/usgpo/house-manual/tree/main/114/original-file-names/"
  click GSD114 "https://github.com/usgpo/house-manual/tree/main/114/govinfo-file-names/graphics-support-documents/"
  click GOV115 "https://github.com/usgpo/house-manual/tree/main/115/govinfo-file-names/"
  click ORIG115 "https://github.com/usgpo/house-manual/tree/main/115/original-file-names/"
  click GSD115 "https://github.com/usgpo/house-manual/tree/main/115/govinfo-file-names/graphics-support-documents/"
  click GOV116 "https://github.com/usgpo/house-manual/tree/main/116/govinfo-file-names/"
  click ORIG116 "https://github.com/usgpo/house-manual/tree/main/116/original-file-names/"
  click GSD116 "https://github.com/usgpo/house-manual/tree/main/116/govinfo-file-names/graphics-support-documents/"
  click GOV117 "https://github.com/usgpo/house-manual/tree/main/117/govinfo-file-names/"
  click ORIG117 "https://github.com/usgpo/house-manual/tree/main/117/original-file-names/"
  click GSD117 "https://github.com/usgpo/house-manual/tree/main/117/govinfo-file-names/graphics-support-documents/"

  %% Styles
  classDef data fill:#cce5ff,stroke:#004085,color:#004085
  classDef process fill:#d4edda,stroke:#155724,color:#155724
  classDef external fill:#fff3cd,stroke:#856404,color:#856404
```
