# Khandan Project Documentation Catalog

This folder contains the conceptual, structural, architectural, and planning documentation for the **Khandan (خاندان)** application.

## Documentation Index

1. **[ai-prompt-fa.md](file:///D:/projects/Khandan/docs/ai-prompt-fa.md)**
   - *Language:* Persian
   - *Purpose:* Rebuilding context for Persian-speaking AI agents/sessions to quickly understand the project parameters and save token quota.
   
2. **[ai-prompt-en.md](file:///D:/projects/Khandan/docs/ai-prompt-en.md)**
   - *Language:* English
   - *Purpose:* English translation of the AI resume prompt to bootstrap context on any global model.

3. **[architecture.md](file:///D:/projects/Khandan/docs/architecture.md)**
   - *Language:* English
   - *Purpose:* Technical design layout, describing directory structure, PDO SQLite data-layer, Vanilla CSS styling tokens, and Javascript Canvas/Media APIs.

4. **[development-guide.md](file:///D:/projects/Khandan/docs/development-guide.md)**
   - *Language:* English
   - *Purpose:* Coding style rules (PHP, CSS variables, JS event structures), XSS/CSRF security standards, file upload sanitization rules, and FTP deploy actions.

5. **[marketing-plan.html](file:///D:/projects/Khandan/docs/marketing-plan.html)**
   - *Language:* Persian
   - *Purpose:* Styled HTML presentation detailing target users, USP (Unique Value Proposition), premium plans, and gift shop monetization channels.

6. **[planning.md](file:///D:/projects/Khandan/docs/planning.md)**
   - *Language:* English
   - *Purpose:* Step-by-step roadmap breaking down development milestones (from database setup to PWA testing).

7. **[prerequisites.md](file:///D:/projects/Khandan/docs/prerequisites.md)**
   - *Language:* English
   - *Purpose:* Necessary environmental factors (PHP 8.x extensions, write permissions, HTML5 client APIs) for deployment.

8. **[proposal.html](file:///D:/projects/Khandan/docs/proposal.html)**
   - *Language:* Persian
   - *Purpose:* Richly styled HTML pitch/proposal summarizing the vision, modules, and target markets.

9. **[proposal.md](file:///D:/projects/Khandan/docs/proposal.md)**
   - *Language:* English
   - *Purpose:* Markdown version of the project pitch outlining visionary concept and module mapping.

10. **[structure.md](file:///D:/projects/Khandan/docs/structure.md)**
    - *Language:* English / Persian
    - *Purpose:* Database schema scripts (SQLite tables) and directory mapping configurations.