=== AwoPulse — Employee Satisfaction (eNPS), 360 Feedback & Kaizen Suggestion Studio ===
Contributors: awoscan
Tags: hr, feedback, survey, kaizen, evaluation
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage employee eNPS pulse surveys, 360 performance evaluations, Kaizen continuous improvement ideas, and A4 HR board reports.

== Description ==

**AwoPulse 2.2.0** is a self-contained corporate B2B studio for WordPress (`WP Admin -> AwoPulse`).

= What AwoPulse Does =

AwoPulse empowers HR and quality teams to evaluate employee satisfaction (eNPS), conduct structured performance reviews, track factory/office Kaizen improvement proposals, and print A4 HR Committee Reports.

= How to Configure and Use AwoPulse =

1. **Open the Studio:** After activating the plugin, click **AwoPulse** in the WordPress admin sidebar (requires `manage_options` capability).
2. **Configure Company Settings:** Enter your company name, HR/Quality committee details, and evaluation period in the Organization Settings panel.
3. **Create or Select a Record:** Click **+ New Evaluation / Kaizen Proposal** and record the department, submission type (Kaizen Suggestion, 360 Performance Review, eNPS Pulse), score, and cost-saving/impact estimate.
4. **Calculate, Filter, and Manage Status:** Track committee review status (Submitted, Under Review, Approved / Rewarded, Implemented) and calculate aggregate eNPS and department scores.
5. **Save, Print A4 PDF, or Export:** Click **Save** to store records in WordPress, click **Print A4 HR & Kaizen Report** for management sign-off, or export to CSV / JSON.

= Key Features =

* **Live Two-Column Studio & Instant A4 Print Preview:** Edit your records on the left and preview the formatted A4 corporate document on the right (`@media print` ready).
* **100% Local WordPress Database Storage:** Stores workspace records safely inside `wp_options` (`awopulse_workspace_v1`) via Nonce-verified and capability-checked WordPress AJAX (`manage_options`).
* **CSV & Portable JSON Export / Import:** Export records to Excel-compatible CSV or portable JSON backup files at any time.
* **Adaptive Day / Night UI:** Supports automatic system theme detection as well as manual Light and Dark modes.

= External Services =

* **100% Local Default Operation:** By default in Free mode, AwoPulse runs 100% locally inside your WordPress site and makes **zero external HTTP requests**.
* **Optional AWO-Guard / Polar.sh PRO License Verification (`https://awosign.awoscan.com`):** Only when a site administrator explicitly enters an optional PRO license key (`AWO-PLS-...` or `AWO-SUITE-...`) and clicks Activate, the plugin sends an HTTPS POST request to `https://awosign.awoscan.com/api/license/activate` containing the license key, site domain, and company name to verify the license and issue a signed domain lease token.
  * Service Provider: AwoScan / AWO Cloud Portal (`https://awosign.awoscan.com`) & Polar Software, Inc. (`https://polar.sh`)
  * Terms & Privacy Policy: `https://awoscan.com/privacy` and `https://polar.sh/legal/privacy`

= Privacy and Data Storage =

AwoPulse stores all records, company settings, and uploaded logos/stamps locally inside your own WordPress database (`wp_options` under `awopulse_workspace_v1`). No business records or customer data are sent to external servers. All stored options are automatically removed when the plugin is uninstalled (`uninstall.php`).

= Source Code =

All PHP, JavaScript, and CSS files in this plugin are distributed in human-readable, unminified source form directly inside the plugin directory (no external build tool or compiler is required):

* awopulse.php - WordPress admin studio, eNPS & Kaizen scoring engine, AJAX storage, and A4 HR committee report layout.

== Installation ==

1. Upload the `awopulse` folder to `/wp-content/plugins/` or upload the plugin ZIP file via **Plugins -> Add New -> Upload Plugin** in WordPress.
2. Activate **AwoPulse** through the **Plugins** menu in WordPress.
3. Click **AwoPulse** in the WordPress admin sidebar (`manage_options` capability required).
4. Configure your company header, add your first record, click **Save**, and use **Print A4 / PDF** to generate your document.

== Frequently Asked Questions ==

= Does AwoPulse require an external account or cloud subscription to work? =

No. AwoPulse runs locally inside WordPress out of the box with no external account required.

= Where is my data stored? =

All data is stored in your own WordPress database inside the `wp_options` table (`awopulse_workspace_v1`) and can be exported to JSON or CSV at any time.

= Can I print A4 documents or save them as PDF? =

Yes. Click the Print A4 button inside the studio to open your browser's native print dialog, where you can print directly to an A4 printer or choose "Save as PDF".

== Screenshots ==

1. AwoPulse main workspace editor and live A4 document preview.
2. Saved records list, status filter, and CSV/JSON export controls.
3. Company header, branding, and studio configuration panel.

== Changelog ==

= 2.2.0 =
* Added step-by-step configuration and usage documentation, Privacy and Data Storage section, and Source Code documentation in `readme.txt`.
* Added optional AWO-Guard v1.0 Polar.sh PRO license activation (`AWO-PLS-...` and `AWO-SUITE-...`) with external service disclosure.

= 1.0.0 =
* Initial release of AwoPulse corporate studio for WordPress.
