TNCSC_Odoo/addons/community_membership
metatroncubeswdev 8dd97dec9b
Some checks failed
CI / Brand-leak check (push) Has been cancelled
CI / flake8 / pylint-odoo / manifest completeness (push) Has been cancelled
CI / Install all modules with --test-enable (push) Has been cancelled
docs(phase-9-a): fill in real module READMEs, add CHANGELOGs, fix stale HANDOFF
- Replace the Phase-0 "content to be completed" placeholder Usage section
  in every community_* README.rst with the actual features built across
  Phases 1-6 (routes, crons, portal pages).
- Add CHANGELOG.rst (19.0.1.0.0) to every community_* module.
- Note independent-vs-bundled module relationships in the root README.
- Fix HANDOFF.md: Phase 8 was already committed (9a24691) and a git
  remote is configured, contrary to what it still said; record 9-A
  progress and the open gaps (missing banner.png assets, live
  --test-enable suite not re-run this session, no v1.0.0 tag yet).
2026-08-20 09:23:32 -04:00
..

======================
Community OS Membership
======================

Generic membership engine: configurable tiers, family grouping, member IDs,
renewal automation, self-service portal, and a QR membership card.

Installation
============
Install as any Odoo module.

Configuration
=============
Settings > Members > Membership Settings.

Usage
=====
* Define tiers under **Members > Configuration > Tiers** (name, code, price,
  period). Each tier auto-creates its membership product.
* A partner's ``membership_member_id`` is generated on activation using the
  format string configured in Membership Settings (default
  ``MEM-{year}-{seq}``).
* A daily cron moves members to ``renewal_due`` at the configured reminder
  offsets and to ``expired`` on expiry, sending the matching email template
  and creating a draft renewal invoice for review.
* Members self-serve at ``/my/membership`` (status, tier, expiry, renew,
  download card) and can be verified publicly, without exposing personal
  data, at ``/membership/verify/<member_id>``.
* The QR membership card is a QWeb PDF report (85mm x 54mm) whose QR code
  encodes the verification URL.

Credits
=======

Authors
-------
* Metatroncube Software Solutions LLP