graphify add

graphify-out/GRAPH_REPORT.md

@@ -0,0 +1,214 @@
+# Graph Report - khatibi  (2026-10-09)
+
+## Corpus Check
+- cluster-only mode — file stats not available
+
+## Summary
+- 548 nodes · 887 edges · 80 communities (14 shown, 66 thin omitted)
+- Extraction: 85% EXTRACTED · 15% INFERRED · 0% AMBIGUOUS · INFERRED: 131 edges (avg confidence: 0.92)
+- Token cost: 2,543 input · 5,433 output
+
+## Graph Freshness
+- Built from commit: `f19d8ee6`
+- Run `git rev-parse HEAD` and compare to check if the graph is stale.
+- Run `graphify update .` after code changes (no API cost).
+
+## Community Hubs (Navigation)
+- User Action Views
+- Inventory and Product Models
+- Daily Reporting Command
+- Customer Admin Templates
+- Database Schema Migrations
+- Admin Panel URLs
+- Database Backup Command
+- Initial Database Migrations
+- User Relation Migrations
+- Financial and Accounting Views
+- Invoice Management Logic
+- Django Admin Configuration
+- Core Application Models
+- Resource Cleanup Command
+- Django App Configurations
+- Timezone-related Migrations
+- Application Entrypoint Scripts
+- Graphify Tooling
+- Data Validation Migration
+- Database Schema Migration
+- Database Schema Migration
+- Remove StoreRoom User Relation
+- Database Schema Migration
+- Add Action Type Field
+- Add Action Grade Field
+- Database Schema Migration
+- Add Article Payment Status
+- Add Article Payment Method
+- Add Customer Last Visit
+- Database Schema Migration
+- Add Sarresid Description
+- Update ProductInStore Options
+- Update ProductInStore Options
+- AI Tooling Documentation
+- Customer Action Partial
+- New Customer Base Template
+- Customer Feedback Partial
+- Customer Invoice Detail
+- Customer Accounting Template
+- Customer Invoice List
+- Customer Feedback Page
+- Action List Template
+- New Customer Invoice Page
+- New Customer Invoice V2
+- Customer Satisfaction List
+- Customer Satisfaction Partial
+- Customer Debt Management
+- Customer List Page
+- Financial Dashboard
+- Accounting Main View
+- New Inventory Operation
+- Inventory Operations List
+- Operations Backup Template
+- Financial Report Template
+- Debt Collection Dashboard
+- Inventory Movement Report
+- Customer Satisfaction Dashboard
+- Check and Credit Report
+- Satisfaction List Template
+- Store Inventory Template
+- Store Transfers Template
+- Stores List Template
+- Extended Requirements File
+- Project Requirements File
+
+## God Nodes (most connected - your core abstractions)
+1. `StoreRoom` - 25 edges
+2. `ProductInStore` - 23 edges
+3. `User` - 21 edges
+4. `Action` - 20 edges
+5. `Product` - 18 edges
+6. `StoreTransferRequest` - 15 edges
+7. `Article` - 15 edges
+8. `ProductCategory` - 14 edges
+9. `Customer` - 13 edges
+10. `approve_transfer_request()` - 12 edges
+
+## Surprising Connections (you probably didn't know these)
+- `VisitQueue` --uses--> `User`  [INFERRED]
+  admin_panel/models.py → admin/models.py
+- `Factor` --uses--> `User`  [INFERRED]
+  admin_panel/models.py → admin/models.py
+- `StoreRoom` --uses--> `User`  [INFERRED]
+  admin_panel/models.py → admin/models.py
+- `StoreRoomOwner` --uses--> `User`  [INFERRED]
+  admin_panel/models.py → admin/models.py
+- `StoreTransferRequest` --uses--> `User`  [INFERRED]
+  admin_panel/models.py → admin/models.py
+
+## Import Cycles
+- None detected.
+
+## Hyperedges (group relationships)
+- **Customer Satisfaction & Collection** — admin_panel_templates_admin_panel_report_rezayat, admin_panel_templates_admin_panel_report_debtors_no_vosol, admin_panel_customer_customernazarinc [EXTRACTED 0.90]
+- **Customer Management Flow** — admin_panel_customer_base_new, admin_panel_customer_action_inc, admin_panel_customer_id_factor, admin_panel_customer_hesabdari [EXTRACTED 1.00]
+- **Financial & Debt Management** — admin_panel_templates_admin_panel_financial_dashboard, admin_panel_templates_admin_panel_hesabdari [EXTRACTED 1.00]
+- **Inventory Management System** — admin_panel_templates_admin_panel_store, admin_panel_templates_admin_panel_store_transfers, admin_panel_templates_admin_panel_report_inventory_movements, admin_panel_templates_admin_panel_operationsbk [EXTRACTED 1.00]
+- **Login Form** — admin_panel_templates_admin_panel_login, django_url_admin_panel_p_login, django_csrf_token, form_field_username, form_field_password [EXTRACTED]
+- **New Store Form** — admin_panel_templates_admin_panel_storebk1, django_url_admin_panel_newstore, django_csrf_token, form_field_storename [EXTRACTED]
+- **Store Inventory Display** — admin_panel_templates_admin_panel_storebk1, template_variable_productsum, product_property_product_name, product_property_mojodi [EXTRACTED]
+- **Customer Lifecycle Management** — admin_panel_templates_admin_panel_customers [INFERRED 0.85]
+- **Customer Interaction Lifecycle** — admin_panel_templates_admin_panel_customers, admin_panel_templates_admin_panel_customerNew, admin_panel_templates_admin_panel_customerRezayat [INFERRED 0.85]
+- **Financial & Debt Management Flow** — admin_panel_templates_admin_panel_customerSarresid, admin_panel_templates_admin_panel_hesabdari, admin_panel_templates_admin_panel_financial_dashboard [INFERRED 0.90]
+- **Settle Due Payment Flow** — admin_panel_templates_admin_panel_hesabdaricheckpassfail_html, admin_panel_url_passcheck, admin_panel_url_pardakhtnesiye [INFERRED 0.90]
+- **Accounting and Billing Flow** — admin_panel_templates_admin_panel_basehesabdari, admin_panel_templates_admin_panel_bedehi, admin_panel_templates_admin_panel_hesabdariheckpass, concept_url_admin_panel_hesabdari, concept_url_admin_panel_bedehi, concept_url_admin_panel_pardakhtnesiye [INFERRED]
+- **Check Clearing Flow** — admin_panel_templates_admin_panel_hesabdariresidnashode, admin_panel_views_passcheck [INFERRED]
+- **Customer Management Flow** — admin_panel_templates_admin_panel_customerbase, admin_panel_templates_admin_panel_customerbasenew, admin_panel_templates_admin_panel_customeraction, admin_panel_templates_admin_panel_customerid, admin_panel_templates_admin_panel_customeridfactorbackup, concept_url_admin_panel_customers, concept_url_admin_panel_customeredit, concept_url_admin_panel_newfactor [INFERRED]
+- **Nesiye Payment Flow** — admin_panel_templates_admin_panel_hesabdariresidnashode, admin_panel_urls_pardakhtnesiye [INFERRED]
+- **Store and Inventory Management Flow** — admin_panel_templates_admin_panel_basestore, concept_url_admin_panel_stores, concept_url_admin_panel_productadd, concept_url_admin_panel_operations, concept_url_admin_panel_store_transfers, concept_url_admin_panel_productsjson, concept_url_panel_productmojodi [INFERRED]
+
+## Communities (80 total, 66 thin omitted)
+
+### Community 0 - "User Action Views"
+Cohesion: 0.05
+Nodes (57): User, Action, ProductCategory, ActionJson(), ActionList(), ActionListAll(), ActionListToday(), ActionListUser() (+49 more)
+
+### Community 1 - "Inventory and Product Models"
+Cohesion: 0.06
+Nodes (30): ArticleType, CacheTable, PhoneNumber, Product, Meta, ProductInStore, Meta, MovementType (+22 more)
+
+### Community 2 - "Daily Reporting Command"
+Cohesion: 0.08
+Nodes (15): Command, Article, Meta, Customer, Meta, Sarresid, toJalali(), remove_query_param() (+7 more)
+
+### Community 3 - "Customer Admin Templates"
+Cohesion: 0.08
+Nodes (22): admin_panel/base.html, admin_panel/templates/admin_panel/customerActionInc.html, admin_panel/templates/admin_panel/customerBaseNew.html, Django Custom Tags: custom_tags, URL: admin_panel:bedehi, URL: admin_panel:bedehiKhadamat, URL: admin_panel:bedehiNasb, URL: admin_panel:customer (+14 more)
+
+### Community 4 - "Database Schema Migrations"
+Cohesion: 0.06
+Nodes (16): Migration, Migration, Migration, Migration, Migration, Migration, Migration, Migration (+8 more)
+
+### Community 5 - "Admin Panel URLs"
+Cohesion: 0.06
+Nodes (30): URL: admin_panel:ActionListUserToday, URL: admin_panel:entezar, URL: admin_panel:hesabdari, URL: admin_panel:hesabdari_residnashone, URL: admin_panel:index, URL: admin_panel:p_logout, URL: admin_panel:rezayat, URL: admin_panel:stores (+22 more)
+
+### Community 7 - "Initial Database Migrations"
+Cohesion: 0.09
+Nodes (11): Migration, Migration, Migration, Migration, Migration, Migration, Migration, Migration (+3 more)
+
+### Community 8 - "User Relation Migrations"
+Cohesion: 0.09
+Nodes (11): Migration, Migration, Migration, Migration, Migration, Migration, Migration, Migration (+3 more)
+
+### Community 9 - "Financial and Accounting Views"
+Cohesion: 0.10
+Nodes (20): Customer Data Object, Factor Data Object, Sarresid Data Object, admin_panel.ViewReportMali, base.html, toCurrency, admin_panel:customerNew URL, admin_panel:pardakhtNesiye URL (+12 more)
+
+### Community 10 - "Invoice Management Logic"
+Cohesion: 0.17
+Nodes (8): Factor, Meta, FactorIteam, InventoryException, newFactor(), newFactor2(), _parse_jalali_date(), _parse_timestamp()
+
+### Community 11 - "Django Admin Configuration"
+Cohesion: 0.22
+Nodes (3): StoreRoomAdmin, StoreRoomOwnerInline, StoreTransferRequestAdmin
+
+### Community 12 - "Core Application Models"
+Cohesion: 0.20
+Nodes (9): Customer, Factor, FactorIteam, PhoneNumber, Product, ProductCategory, ProductInStore, StoreRoom (+1 more)
+
+### Community 15 - "Timezone-related Migrations"
+Cohesion: 0.29
+Nodes (3): Migration, Migration, Migration
+
+### Community 19 - "Graphify Tooling"
+Cohesion: 0.33
+Nodes (5): graphify tool, graphify explain, graphify path, graphify query, graphify
+
+## Ambiguous Edges - Review These
+- `admin_panel/base.html` → `admin_panel/templates/admin_panel/baseHesabdari.html`  [AMBIGUOUS]
+  admin_panel/templates/admin_panel/baseHesabdari.html · relation: conceptually_related_to
+
+## Knowledge Gaps
+- **84 isolated node(s):** `base.html`, `toCurrency`, `Customer Data Object`, `Factor Data Object`, `admin_panel:customerNew URL` (+79 more)
+  These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 276 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
+- **66 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
+
+## Suggested Questions
+_Questions this graph is uniquely positioned to answer:_
+
+- **Why does `passCheck()` connect `Financial and Accounting Views` to `User Action Views`, `Daily Reporting Command`?**
+  _High betweenness centrality (0.208) - this node is a cross-community bridge._
+- **Are the 20 inferred relationships involving `StoreRoom` (e.g. with `User` and `approve_transfer_request()`) actually correct?**
+  _`StoreRoom` has 20 INFERRED edges - model-reasoned connections that need verification._
+- **What connects `base.html`, `toCurrency`, `Customer Data Object` to the rest of the system?**
+  _84 weakly-connected nodes found - possible documentation gaps or missing edges._
+- **Should `User Action Views` be split into smaller, more focused modules?**
+  _Cohesion score 0.053728949478749 - nodes in this community are weakly interconnected._
+- **Why does `admin_panel/base.html` connect `Customer Admin Templates` to `Financial and Accounting Views`, `Admin Panel URLs`?**
+  _High betweenness centrality (0.194) - this node is a cross-community bridge._
+- **Are the 14 inferred relationships involving `ProductInStore` (e.g. with `Command` and `approve_transfer_request()`) actually correct?**
+  _`ProductInStore` has 14 INFERRED edges - model-reasoned connections that need verification._
+
+### Low-confidence Hints
+_AMBIGUOUS edges — the extractor was unsure. Verify before acting on these._
+
+- **What is the exact relationship between `admin_panel/base.html` and `admin_panel/templates/admin_panel/baseHesabdari.html`?**
+  _Edge tagged AMBIGUOUS (relation: conceptually_related_to) - confidence is low._