261ce6d55b
Audited every *.md in docs/ and root. Merged five overlapping backend docs (BACKEND_INTEGRATION.md + AUTHENTICATION.md + ERROR_CONTRACT.md + MAINTENANCE_MODE.md + the already-archived BACKEND_API.md/ BACKEND_API_REMAINING_WORK.md) into one canonical docs/BACKEND.md (4775 lines, 10 numbered sections) - deleted the four standalone files outright now that their content is fully inlined. Archived (not deleted - real historical value): ADMIN.md (Sprint 19-28 build log, sprint-report-shaped, not a living reference) and FRONTEND-ROADMAP.md (despite its name, a shipped-history changelog with detail no other doc has - not a forward roadmap, so keeping it in root alongside NEXT_PHASE.md was exactly the "10 roadmaps" confusion being cleaned up). Deleted outright (zero value): SPRINTS.md - a leftover copy-pasted sprint-kickoff prompt saved as a file, not documentation. Rewrote docs/PROJECT_STATUS.md with completion-percentage estimates per area (frontend/backend/UI/admin/storefront) and an explicit first-customer-readiness call. Rewrote docs/NEXT_PHASE.md to the strict 5-phase structure (backend integration -> production testing -> performance -> monitoring -> v2 ideas), pointing to PRODUCT_BACKLOG .md/FUTURE_FEATURES.md for phase 5 detail instead of duplicating it. Rewrote root README.md - was stale (referenced deleted pages/info, pages/legal folders from a prior RC pass), now covers architecture, frontend/backend status, how to run, mock<->API switch mechanism (useMockData in environment.ts), current folder structure, and a documentation map. Updated docs/PROJECT_INDEX.md (the stated entry point) to link only the surviving doc set - every remaining document is reachable from it. Fixed every broken/stale cross-reference to the deleted/renamed backend docs across ARCHITECTURE.md, EDITOR.md, FRONTEND.md, PROJECT-STRUCTURE.md, StaticPages.md, KNOWN-ISSUES.md (10 individual link fixes, verified by repo-wide grep before and after). Left CHANGELOG.md's two historical entries untouched - changelogs are append-only history, not live navigation, editing past entries would misrepresent what was true at the time. Not touched (explicitly out of scope): docs/architecture/foundation/** (enforced ADRs/governance, permanent not sprint-shaped), docs/context/** (Barry Cache infrastructure, "do not edit by hand" per CLAUDE.md), .claude/worktrees/** (separate git worktrees containing an unrelated project's docs, not this repo's documentation). docs/ root: 22 files -> 16. Plus 5 in docs/archive/ (was 3).
79 lines
4.9 KiB
Markdown
79 lines
4.9 KiB
Markdown
# Marketplace Frontend
|
|
|
|
Angular 21 multi-tenant marketplace platform frontend. Standalone components, signals, no NgRx. One codebase serves unlimited tenants ("marketplaces") via a per-tenant `bootstrap.json` fetched at runtime — no tenant-specific code paths.
|
|
|
|
Three surfaces on this one codebase:
|
|
- **Storefront** (`/`) — the public shopping site: catalog, product pages, cart, static/CMS pages.
|
|
- **Builder / Project Editor** (`/edit/**`) — in-app editor that edits the tenant's `BootstrapConfig` (theme, nav, homepage sections, widgets, footer, languages, static pages).
|
|
- **Backoffice / Admin** (`/:lang/backoffice/**`) — products, categories, orders, transactions, users, moderation, media, monitoring, analytics.
|
|
|
|
## Architecture
|
|
|
|
`Component (container) → Facade → Domain Service → Repository/Provider (DI token, swappable mock↔API) → Mock | API`
|
|
|
|
Enforced by `npm run arch:check` (import boundaries + circular deps), not just convention. Full detail: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md), governance ADRs at `docs/architecture/foundation/**`.
|
|
|
|
## Frontend status
|
|
|
|
**Release Candidate — feature-complete.** See [`docs/PROJECT_STATUS.md`](docs/PROJECT_STATUS.md) for the honest current-state breakdown (completion %, known limitations, readiness for demo/production/backend).
|
|
|
|
## Backend
|
|
|
|
**Not implemented yet — fully specified.** Every domain currently runs against an in-memory/mock gateway except Categories (the one domain wired to a real HTTP API). The complete contract a backend engineer needs — every endpoint, DTO, auth flow, error model, upload contract, and a step-by-step implementation checklist — lives in one canonical document:
|
|
|
|
**[`docs/BACKEND.md`](docs/BACKEND.md)**
|
|
|
|
## How to switch Mock ↔ API
|
|
|
|
Toggle `useMockData` in `src/environments/environment.ts` (or `environment.production.ts`). `RuntimeProviderStrategyService` (`src/app/core/providers/runtime-provider-strategy.service.ts`) reads this flag per-domain to decide whether a facade gets the mock or real gateway. On `localhost` with `useMockData: false`, some domains (bootstrap, categories) still fall back to mock automatically so local dev never silently hits a real backend by accident — see that service for the exact per-domain logic.
|
|
|
|
## Development
|
|
|
|
```bash
|
|
npm install # install dependencies
|
|
npm start # local dev server
|
|
npm run build # production build -> dist/dexarmarket/
|
|
npm run arch:check # import-boundary + circular-dependency check
|
|
```
|
|
|
|
## Folder structure
|
|
|
|
```text
|
|
src/
|
|
├── app/
|
|
│ ├── components/ # Shared storefront components (header, footer, product-card, etc.)
|
|
│ ├── core/ # Auth, admin-auth, config/tenant resolution, DI providers, interceptors
|
|
│ ├── dynamic-renderer/ # Bootstrap JSON -> section/widget rendering pipeline (live homepage engine)
|
|
│ ├── facades/ # Runtime, website, builder, and backoffice facades
|
|
│ ├── features/ # Domain features: admin/*, project-editor, content-management, website/*
|
|
│ ├── guards/ # Route guards (language, admin-auth, dirty-state, etc.)
|
|
│ ├── i18n/ # Translation service, pipe, and locale packs (en/ru/hy)
|
|
│ ├── pages/ # Top-level routed pages: home, cart, static-page
|
|
│ ├── services/ # API, cart, auth, SEO, Telegram, and language services
|
|
│ ├── shared/ # Shared UI primitives (button, dialog, confirm-dialog, table, etc.)
|
|
│ └── widgets/ # Dynamic-renderer widget components
|
|
├── assets/mock/ # Local mock configuration and catalog data
|
|
├── environments/ # Development and production environment settings (incl. useMockData)
|
|
└── styles/ # Shared global styles and themes
|
|
```
|
|
|
|
## Documentation map
|
|
|
|
Full index: [`docs/PROJECT_INDEX.md`](docs/PROJECT_INDEX.md). Key entry points:
|
|
|
|
| Doc | What it covers |
|
|
|---|---|
|
|
| [`docs/PROJECT_STATUS.md`](docs/PROJECT_STATUS.md) | Current completion status, honest limitations, demo/production readiness |
|
|
| [`docs/BACKEND.md`](docs/BACKEND.md) | The one canonical backend spec — endpoints, DTOs, auth, security, errors, uploads, checklist |
|
|
| [`docs/NEXT_PHASE.md`](docs/NEXT_PHASE.md) | Roadmap: backend integration → testing → performance → monitoring → v2 |
|
|
| [`docs/TODO.md`](docs/TODO.md) | Release blockers only |
|
|
| [`docs/KNOWN-ISSUES.md`](docs/KNOWN-ISSUES.md) | Real, reproducible, currently-open frontend bugs |
|
|
| [`docs/PRODUCT_BACKLOG.md`](docs/PRODUCT_BACKLOG.md) | Items needing a client/business decision |
|
|
| [`DESIGN.md`](DESIGN.md) | Visual design system |
|
|
| [`PRODUCT.md`](PRODUCT.md) | Product positioning |
|
|
|
|
## Notes
|
|
|
|
- Authentication and payment integrations are on their existing contracts — see `docs/BACKEND.md` for the auth/security contract a real backend must satisfy.
|
|
- Client-facing content should avoid placeholder names, mock labels, and temporary routes.
|