Sovexxa Society Management System

=== Sovexxa Society Management System === Contributors: Sovexxa Development Team Tags: society, management, erp, residents, billing, maintenance, complaints Requires at least: 6.0 Tested up to: 6.6 Requires PHP: 8.2 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

A comprehensive, production-ready WordPress plugin for multi-society management with ERP capabilities.

== Description ==

Sovexxa Society Management System is a complete, secure, modular WordPress plugin designed for managing societies with a hierarchical structure:

• Super Admin - Manage all societies and global settings
• Society Admin - Manage their assigned society
• Flat Residents - Access their flat information and portal

== Features ==

=== Core Management ===

• Multi-society support with complete data isolation
• Society structure: Society → Wing → Floor → Flat
• Flat members management (Owner, Tenant, Family Member)
• Management committee tracking

=== Maintenance & Billing ===

• Monthly maintenance billing
• Payment recording (Cash, Bank Transfer, UPI, Cheque, Online)
• Receipt generation and PDF export
• Payment history and outstanding dues tracking
• Late fees and adjustments

=== Communication ===

• Society notices and announcements
• Complaint management system
• Visitor management
• WhatsApp Click-to-Chat integration for bills, receipts, and notices

=== Assets & Resources ===

• Parking allocation and management
• Staff management
• Expense tracking
• Detailed categorization

=== Reporting ===

• Maintenance collection summary
• Outstanding dues reports
• Income & expense statements
• Flat-wise dues reports
• Member lists
• Committee lists
• PDF and print-friendly layouts
• CSV export

=== Security ===

• Role-based access control (RBAC)
• Nonce verification on all forms
• SQL injection prevention with prepared statements
• XSS protection with proper escaping
• CSRF protection
• Strict society and flat ownership validation
• User capability checks
• No cross-society data exposure

=== User Experience ===

• Unified login for all user types
• Responsive mobile-first design
• Resident portal with dashboard
• Ajax and non-Ajax support
• Pagination for large datasets
• Professional receipt and bill designs

== Installation ==

1. Upload the plugin folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to Sovexxa Dashboard to set up your first society
4. Create a Society Admin user and assign them to a society
5. Use the unified login page for all users

== Database ==

The plugin creates the following tables (with WordPress prefix):

• wp_sovexxa_societies
• wp_sovexxa_wings
• wp_sovexxa_floors
• wp_sovexxa_flats
• wp_sovexxa_members
• wp_sovexxa_parking
• wp_sovexxa_maintenance
• wp_sovexxa_receipts
• wp_sovexxa_notices
• wp_sovexxa_complaints
• wp_sovexxa_visitors
• wp_sovexxa_expenses
• wp_sovexxa_staff
• wp_sovexxa_committee_members
• wp_sovexxa_payments
• wp_sovexxa_audit_logs

== User Roles & Capabilities ==

=== Super Admin === Full access to all societies, users, and settings. Capabilities: sovexxa_manage_all

=== Society Admin === Manage assigned society only. Capabilities: sovexxa_manage_society, sovexxa_manage_flats, sovexxa_manage_members, etc.

=== Flat Resident === Access resident portal and their flat information. Capabilities: sovexxa_view_portal, sovexxa_view_own_flat

== Shortcodes ==

• [sovexxa_login] - Unified login page (redirects based on user role)
• [sovexxa_portal] - Resident portal dashboard
• [sovexxa_notices] - Display society notices
• [sovexxa_bills] - Display resident's bills
• [sovexxa_committee] - Display management committee

== WhatsApp Setup ==

The plugin uses WhatsApp Click-to-Chat by default (no API required).

To use Business API:

1. Go to Sovexxa → Settings → WhatsApp Settings
2. Select "Business API" mode
3. Enter your Access Token, Phone Number ID, Business Account ID
4. Messages will be sent via Business API

== PDF & Print ==

All reports support:

• View in browser
• Print to PDF
• Print-friendly layout
• CSV export

The plugin uses browser print functionality. For advanced PDF generation, integrate Dompdf.

== Security Notes ==

• Always validate user permissions before viewing data
• Society Admins cannot access other societies
• Residents can only access their assigned flat
• All financial transactions are logged
• Use HTTPS for all sensitive operations
• Enable two-factor authentication on WordPress for added security

== Changelog ==

= 1.0.0 =

• Initial release
• All core features implemented
• Full RBAC and security
• Complete reporting suite
• WhatsApp integration

== Support ==

For support, issues, or feature requests, visit: https://github.com/rameezjatagar02-rgb/sovexxa-society-management

== License ==

This plugin is licensed under the GPLv2 or later.