Skip to content

Feat(library): add core doctypes for media and membership management - #427

Open
brianmalik wants to merge 2 commits into
developfrom
library-management
Open

Feat(library): add core doctypes for media and membership management#427
brianmalik wants to merge 2 commits into
developfrom
library-management

Conversation

@brianmalik

Copy link
Copy Markdown
Collaborator

Library Management Module - Core Doctypes

This PR introduces the foundational data model for the Library Management Module within the Education System. It establishes the core doctypes required for cataloging, membership, and circulation workflows.

The implementation is designed to support scalable library operations including media tracking, member management, and future circulation features (issue/return/reservation).


Added Doctypes

Cataloging Layer

  • Publisher
    Stores publishing entities for Library Media
image
  • Author
    Stores authors and enables multi-author relationships
image
  • Media Category
    Classifies media items (e.g., Books, Journals, Audio, etc.)

  • Library Media
    Core catalog entity representing a media title (ISBN-based master record)

image

Inventory Layer

  • Media Copy
    Represents physical/stockable instances of Library Media
image

Supports tracking of:

  • Edition number
  • Status (Available / Issued / Lost / etc.)
  • Barcode / QR integration (future-ready)

Membership Layer

  • Library Member
    Represents system users linked to Student / Employee / External entities
image
  • Member Card
    Handles library access identification and membership validation
image

Key Relationships Established

  • Library Media → Publisher (many-to-one)
  • Library Media → Author (many-to-many via child table)
  • Library Media → Media Category (classification)
  • Media Copy → Library Media (one-to-many)
  • Library Member → Student / Employee / External reference
  • Member Card → Library Member

Design Decisions

  • Separated catalog (Library Media) from inventory (Media Copy) to support scalable circulation logic

  • Introduced child table structure for authors to support multi-author books

  • Designed membership system to support:

    • Internal users (students/employees)
    • External members
  • Prepared foundation for:

    • Barcode / QR scanning
    • Automated media intake workflows
    • Circulation (issue / return) system

Testing Notes

  • Ensure all doctypes are created successfully via migration/install
  • Verify link fields between Media, Publisher, and Author
  • Validate Media Copy creation and linkage to parent Media
  • Confirm Library Member reference mapping works correctly

Notes

This PR establishes the core structural backbone of the Library Management System and is required before implementing circulation and scanning workflows.

brianmalik added 2 commits May 6, 2026 09:56
…agement

- Add Publisher and Author doctypes
- Add Library Media and Media Category for cataloging
- Add Media Copy for item-level tracking
- Add Library Member for user library profiles
- Add Member Card for access and identification

Establishes foundation for library catalog, circulation, and membership workflows
@brianmalik
brianmalik requested review from flexGURU, muchai and tuwafula and removed request for flexGURU, muchai and tuwafula May 6, 2026 13:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant