ZHARIEF JOB IDEAS GENERATOR — COMPLETE ENGLISH SETUP GUIDE
=========================================================

1. WHAT THIS PACKAGE DOES
The script generates text records describing conceptual combinations of
geography, job seed, technology, activity, target, setting, scale, and scenario.
It can address 2,000,000,000,000,000 theoretical combinations, but this is NOT
an inventory of 2 quadrillion verified occupations or meaningful ideas.
The seed lists are small; higher numbered slots use explicitly synthetic labels.

2. INSTALL PYTHON ON WINDOWS
Visit https://www.python.org/downloads/ and install Python 3.9 or newer.
During installation, select "Add Python to PATH" if offered.
Open Windows PowerShell and check:
    python --version
If 'python' is not found, try 'py --version' and use 'py' in commands below.

3. OPTIONAL: INSTALL VISUAL STUDIO CODE
Download from https://code.visualstudio.com/
Install it, then use File > Open Folder to open the extracted ZIP folder.
Open Terminal > New Terminal. You do not need third-party Python packages.

4. CREATE A TEXT FILE
Run:
    python generate_zharief.py --rows 1000 --output jobs.txt
The output is a UTF-8, tab-separated TXT file with a header row.
Each line is one conceptual combination. Open it with VS Code or a text editor.

5. GENERATE LARGER TXT FILES
    python generate_zharief.py --rows 100000 --output jobs_100k.txt
    python generate_zharief.py --rows 1000000 --output jobs_1m.txt
Writing many rows takes time and disk space. Start with 1,000 to test.

6. CREATE MULTIPLE NON-OVERLAPPING PARTS
First part:
    python generate_zharief.py --start 0 --rows 1000000 --output part_001.txt
Second part:
    python generate_zharief.py --start 1000000 --rows 1000000 --output part_002.txt
Third part:
    python generate_zharief.py --start 2000000 --rows 1000000 --output part_003.txt
--start is zero-based; --rows is the number of rows to write.
The generator writes a header in each output file.

7. OPTIONAL COMPRESSED OUTPUT
    python generate_zharief.py --rows 1000000 --output jobs.csv.gz
The .csv.gz format saves disk space. .txt produces tab-separated plain text.

8. HOW THE NUMBER IS CALCULATED
200 geographic slots x 10,000 job slots x 100 technology slots x
100 activity slots x 100 target slots x 10 setting slots x 10 scale slots x
10 scenario slots = 2,000,000,000,000,000 combinations.
These slots are NOT all independently curated or real-world validated.
Many results are redundant, unrealistic, or just differently labeled.

9. USE WITH CLOUDFLARE PAGES
Cloudflare Pages hosts static files, such as ZIP, TXT, HTML, and CSS.
Upload this ZIP to your site's static assets and link to its filename.
Visitors can download it and run Python on their own computers.
A static Cloudflare Pages website does NOT execute the Python generator.

10. TROUBLESHOOTING
- 'python' not recognized: reinstall Python with PATH enabled, or use 'py'.
- Permission denied: choose a writable folder for --output.
- File too large: reduce --rows or create smaller numbered parts.
- Incorrect characters: open TXT with UTF-8 encoding.
- No output on website: the Python script must be run on a computer/server.

11. DATA QUALITY DISCLAIMER
These records are automatically constructed conceptual examples. Do not
present the full combination count as the number of real jobs in the world.
To improve quality, replace placeholder labels with researched occupation
names, country data, and validation rules before publishing search results.

12. NUMBERED JOB CODES AND NAMES
Every record includes a job_code such as RICE-FARMER-007.
The idea text also includes the three-digit scenario suffix, e.g. Rice farmer 007.
Scenario codes range from 001 to 010 in this version. They identify scenario slots, not independently verified job categories.
The id column is the globally unique sequential combination number from 1 to 2,000,000,000,000,000.
A job_code may repeat across other fields; use id for a unique record reference.
Example: python generate_zharief.py --rows 1000 --output jobs.txt
