Gamete bank

The Gamete Bank module manages physical storage (tanks, baskets, ladders, positions), storage plans, active samples and the transaction history. The access path is /manage-gamete-bank with four sub-routes:

• /manage-gamete-bank/storage (default view)
• /manage-gamete-bank/plans
• /manage-gamete-bank/storage-configuration
• /manage-gamete-bank/history

Submodules and permissions

Each submodule has its own permissions:

Submodule	Permission	Allows
Storage	GAMETE_BANK_STORAGE READ/WRITE/ADMIN	Manage active samples and positions.
Plans	GAMETE_BANK_PLAN READ/WRITE/ADMIN	Create, edit and deactivate plans.
Configuration	GAMETE_BANK_STORAGE_CONFIGURATION READ/WRITE/ADMIN	Maintain tanks, ladders and positions.
History	GAMETE_BANK_HISTORY READ	Consult transactions.
Parameters	PARAMETERS	Configure qualities, limits and types.

Key concepts

• Tank: physical storage unit (cryogenic). Contains baskets, ladders and positions.
• Basket: subdivision of the tank.
• Ladder: subdivision of the basket.
• Position: minimum unit where a sample (cryotop or vial) is placed.
• Sample: the gamete (oocyte, sperm or embryo) stored.
• Plan: commercial scheme that bills the patient for storage (monthly, quarterly, etc.).
• Plan charge: recurring charge generated by a plan (PAID, OVERDUE, DUE, UPCOMING).

Documented features

Feature	Page
Configure tanks and positions	Configure tanks, baskets and ladders
Create storage plan	Create storage plan
Register sample (freezing)	Register gamete sample
Thaw or discard sample	Thaw or discard sample
Consult transaction history	Consult history
Configure bank parameters	Configure parameters

How the main screen is organized (Storage)

The storage view (storage) is the most complex in the system. It shows:

• List of tanks with metrics (baskets, ladders, occupied and free positions).
• Animations to expand/collapse tanks and see internal detail.
• Actions to register, thaw or discard samples.
• Filters by tank and sample type.

Roles and permissions (summary)

• Bank operator: performs sample registrations, thawings and discards.
• Bank coordination: manages plans and configuration.
• Administration: configures parameters and permissions.

Relation with other modules

• Patients: samples and plans are associated with the patient.
• Cash box: the CryoBank tab of Cash box shows the charges generated by the plans and allows charging them.
• Medical studies: freezing, thawing and insemination studies interact with the bank.

Operational recommendations

• Keep the tanks configuration updated to avoid inconsistencies in storage.
• Periodically review the plan charges in Cash box and notify patients with overdue charges.
• Every operation (registration, thawing, discard) is recorded in the history. Preserve traceability.