Files
khatibi/graphify-out/GRAPH_REPORT.md
T
2026-10-09 17:18:17 +03:30

214 lines
11 KiB
Markdown

# 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._