Δομή του project
Χάρτης του κώδικα και σύνδεση προς το σωστό workflow για κάθε περιοχή που αλλάζετε.
Χάρτης ανώτατου επιπέδου
bubllio-crm/
├── frontend/ React application
├── src/ Django project and business apps
├── docs/ operator, product, API, and architecture documentation
├── skills/ repeatable implementation and verification workflows
├── compose.yaml local PostgreSQL service
├── Dockerfile production backend image
├── pyproject.toml Python dependencies and package metadata
└── uv.lock locked Python dependency versionsΟι τοπικές βάσεις δεδομένων, τα αρχεία περιβάλλοντος, οι κρύπτες, η δημιουργία εξόδου, και η κατάσταση επεξεργαστή αγνοούνται. Βλέπε τους κανόνες υγιεινής στο AGENTS.md.
Σύστημα υποστήριξης
src/manage.py είναι το σημείο εισόδου εντολών Django. Οι ρυθμίσεις σε κλίμακα έργου είναι υπό src/bubllio_crm/· η επιχειρηματική συμπεριφορά χωρίζεται σε εφαρμογές Django.
| Εφαρμογή | Ιδιοκτησίες |
|---|---|
accounts | Συμπεριφορά λογαριασμού που βλέπει ο χρήστης. |
access | Μέλη, ρόλοι, ικανότητες και προσκλήσεις. |
onboarding | Πρώτη λειτουργία εγκατάστασης και διοίκησης εγκατάστασης. |
organizations | Χώροι εργασίας, ρυθμίσεις, και SMTP λογαριασμούς. |
companies | Οργανώσεις πελατών και δραστηριότητα της εταιρείας. |
contacts | Άνθρωποι που σχετίζονται με εταιρείες. |
deals | Ευκαιρίες πώλησης και στάδια αγωγών. |
activities | Συνέχεια-ups, κλήσεις, συναντήσεις, και το Member εργασίας. |
subscriptions | Υπηρεσίες, επαναλαμβανόμενες χρεώσεις, χρεώσεις και πληρωμές. |
automations | Κανόνες αυτοματοποίησης, εκτέλεση και ιστορικό. |
Μέσα σε μια εφαρμογή, κρατήστε τις ευθύνες προβλέψιμες:
models.py / models/ persistent data and invariants
serializers.py API input and output validation
api/ or views.py HTTP coordination
services/ reusable business workflows
urls.py routes
migrations/ schema history
tests/ behavior and regression coverageΔιαβάστε τη ροή εργασίας Django πριν προσθέσετε τη συμπεριφορά backend. Οι αλλαγές με τη χρήση σκόπευτρων πρέπει επίσης να ακολουθούν τους κανόνες του αποθετηρίου.
Γραφικό περιβάλλον
Ο επίσημος πελάτης React ζει στο frontend/ και αναπτύσσεται ανεξάρτητα από το Django.
frontend/src/
├── components/ shared UI and application layouts
├── context/ shared React contexts
├── features/ domain hooks, services, schemas, and components
├── i18n/ language setup and translation JSON
├── pages/ route-level composition
├── routes/ TanStack Router configuration
├── services/ shared API client infrastructure
├── styles/ brand tokens and Material UI theme
└── types/ shared API/domain typesΤα αιτήματα του περιβάλλοντος ακολουθούν μία κατεύθυνση:
page/component → feature hook → feature service → shared API client → DjangoΔιαβάστε τη ροή εργασίας frontend για φόρμες, ερωτήματα, μεταλλάξεις, δρομολόγηση και επαλήθευση.
Configuration
| Αρχείο | Αντικείμενο |
|---|---|
.env.example | Ασφαλής ανάπτυξη τοποθέτες και διαθέσιμες ρυθμίσεις. |
.env.production.example | Λίστα ελέγχου παραγωγής χωρίς μυστικά. |
src/bubllio_crm/settings.py | settings Django και εγκατεστημένες εφαρμογές. |
src/bubllio_crm/database.py | DATABASE_URL ανάλυση. |
compose.yaml | Προαιρετική τοπική PostgreSQL. |
compose.production.yaml | Γενόσημο αυτο-φιλοξενούμενη στοίβα παραγωγής. |
compose.dokploy.yaml | Dokploy στοίβα παραγωγής. |
Τα πραγματικά αρχεία .env και τα διαπιστευτήρια δεν πρέπει ποτέ να δεσμευτούν.
Πού να πάει η αλλαγή;
| Αλλαγή | Κύρια θέση |
|---|---|
| Νέο αποθηκευμένο πεδίο ή αναλλοίωτο | Ιδιοκτησία του μοντέλου Django συν τη migration |
| Επικύρωση API | Κατοχή serializer |
| Επαναχρησιμοποιήσιμη επιχειρηματική δραστηριότητα | Ιδιοκτησία μονάδας υπηρεσιών |
| Συντονισμός HTTP | Προβολή ή ενότητα API |
| Ακατέργαστη αίτηση frontend | Υπηρεσία χαρακτηριστικού |
| Κλιμάκωση ερωτήματος/επικύρωση | Άγκιστρο χαρακτηριστικών |
| Διάταξη σελίδας και κατάσταση UI | Συστατικό σελίδας ή χαρακτηριστικών |
| Κοινή οπτική συμπεριφορά | frontend/src/components/ |
| Οπτική ολοσχερής token | frontend/src/styles/brand.ts |
| Τρέχουσα τεχνική συμπεριφορά | docs/architecture/ |
| Ροή εργασίας χρήστη | docs/guides/ |
| Μελλοντική κατεύθυνση | docs/roadmap/ |
Όταν δεν είστε σίγουροι, ξεκινήστε από την αρχική σελίδα της τεκμηρίωσης ή δείτε το κοντινότερο υπάρχον feature με την ίδια δομή.