documentação do sistema

.context/docs/architecture.md

@@ -0,0 +1,61 @@
+---
+type: doc
+name: architecture
+description: System architecture, layers, patterns, and design decisions
+category: architecture
+generated: 2026-04-29
+status: active
+scaffoldVersion: "2.0.0"
+---
+
+# Architecture Notes
+
+## System Architecture Overview
+The system is a modular frontend web application built using Angular. It follows a modular monolith architecture where features are grouped into specific modules such as `Sales`, `Partners`, `Financial`, and `CRM`. The application heavily relies on Redux-pattern state management (likely NgRx) to manage global state such as shopping carts, customer sales, and application data flow. Data is fetched via Angular services which communicate with a backend REST API.
+
+## Architectural Layers
+- **Components**: UI elements and pages organized by feature domain (`src/app/sales/`, `src/app/partners/`, `src/app/crm/`).
+- **Services**: Business logic and API communication layer (`src/app/services/`, `src/app/shared/services/`).
+- **Store / State Management**: Reducers, actions, and models handling complex state management (`src/app/sales/store/`).
+- **Models**: TypeScript interfaces and classes defining data structures (`src/app/models/`).
+- **Shared Utils**: Common messages, loading indicators, and validators (`src/app/shared/`).
+
+> See [`codebase-map.json`](./codebase-map.json) for complete symbol counts and dependency graphs.
+
+## Detected Design Patterns
+| Pattern | Confidence | Locations | Description |
+|---------|------------|-----------|-------------|
+| Module | 100% | `src/app/*.module.ts` | Angular feature modules for separation of concerns |
+| Redux / Store | 95% | `src/app/sales/store/` | State management using Actions, Reducers, and Store |
+| Dependency Injection | 100% | `src/app/services/` | Angular DI for injecting services into components |
+| Observable / Reactive | 90% | Services & Store | Heavy use of RxJS Observables for async data flows |
+
+## Entry Points
+- [AppModule](file:///d:/desenvolvimento/Simplifique/vendaweb/Vendaweb-portal/src/app/app.module.ts)
+- [AppComponent](file:///d:/desenvolvimento/Simplifique/vendaweb/Vendaweb-portal/src/app/app.component.ts)
+
+## Public API
+| Symbol | Type | Location |
+|--------|------|----------|
+| `AppModule` | Class | `src/app/app.module.ts` |
+| `SalesModule` | Class | `src/app/sales/sales.module.ts` |
+| `PartnersModule` | Class | `src/app/partners/partners.module.ts` |
+| `ShoppingReducer` | Function | `src/app/sales/store/reducers/shopping.reducer.ts` |
+
+## Internal System Boundaries
+The application is clearly separated into bounded contexts:
+- **Sales**: Core module handling product listings, shopping carts, checkout, and ordering.
+- **Partners**: Module for managing partner ranges, reports, and payments.
+- **CRM**: Module handling customer data, editing, and listing.
+- **Admin/Auth**: Authentication and user permission management.
+
+## Top Directories Snapshot
+- `src/app/sales/` (~50+ files)
+- `src/app/models/` (~40+ files)
+- `src/app/shared/` (~30+ files)
+- `src/app/partners/` (~20+ files)
+- `src/app/components/` (~10+ files)
+
+## Related Resources
+- [Project Overview](./project-overview.md)
+- [Data Flow](./data-flow.md)