179 lines
10 KiB
Markdown
179 lines
10 KiB
Markdown
# TorbatYar Documentation
|
||
|
||
Permanent source of truth for architecture, standards, registries, deployment, and phase planning.
|
||
|
||
## Start Here (every implementation phase)
|
||
|
||
1. [`project-status.yaml`](project-status.yaml) — **first** (execution dashboard; do not full-scan when present)
|
||
2. This file
|
||
3. [ai-framework/](ai-framework/) — permanent Enterprise / AI Development Framework (read before coding; [ADR-013](architecture/adr/ADR-013.md), [ADR-018](architecture/adr/ADR-018.md))
|
||
4. Active-service snapshot + latest handover only (via Project Index)
|
||
5. [architecture/](architecture/) and [architecture/adr/](architecture/adr/) **only if referenced**
|
||
6. [development/project-principles.md](development/project-principles.md) when required by stage
|
||
7. [module-registry.md](module-registry.md) / [glossary.md](glossary.md) as cache-eligible ALWAYS READ
|
||
8. Relevant [phases/](phases/) docs for the **current phase only**
|
||
|
||
If a change affects architecture, APIs, providers, or module boundaries: **update documentation first**, then code.
|
||
|
||
## Navigation
|
||
|
||
### Status & Planning
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [project-status.yaml](project-status.yaml) / [project-status.md](project-status.md) | **Single execution dashboard** — critical_path, execution_priority, deployment_readiness (read first) |
|
||
| [progress.md](progress.md) | Completed work only |
|
||
| [roadmap.md](roadmap.md) | Future roadmap only |
|
||
| [next-steps.md](next-steps.md) | Immediate next milestone only |
|
||
| [crm-phase-6-0.md](crm-phase-6-0.md) | CRM Service Foundation (Phase 6.0) |
|
||
| [crm-phase-6-1.md](crm-phase-6-1.md) | CRM Core Business Entities (Phase 6.1) |
|
||
| [crm-phase-6-2.md](crm-phase-6-2.md) | CRM Enterprise Sales Process Engine (Phase 6.2) |
|
||
| [crm-phase-6-3.md](crm-phase-6-3.md) | CRM Enterprise Sales Collaboration (Phase 6.3) |
|
||
| [loyalty-phase-7-0.md](loyalty-phase-7-0.md) | Loyalty Service Foundation (Phase 7.0) |
|
||
| [communication-phase-8.md](communication-phase-8.md) | Enterprise Communication Platform (Phase 8 — Production Ready SMS MVP) |
|
||
| [communication-roadmap.md](communication-roadmap.md) | Communication future channels & optional ops (roadmap only) |
|
||
| [sports-center-roadmap.md](sports-center-roadmap.md) | Sports Center Platform roadmap (Phases 9.0–9.10) |
|
||
| [delivery-roadmap.md](delivery-roadmap.md) | Delivery & Fleet Platform roadmap (Phases 10.0–10.10) |
|
||
| [delivery-phase-10-0.md](delivery-phase-10-0.md) | Delivery Platform Foundation (Phase 10.0) |
|
||
| [experience-roadmap.md](experience-roadmap.md) | Experience Platform roadmap (Phases 11.0–11.10) |
|
||
|
||
### Architecture
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [architecture/architecture.md](architecture/architecture.md) | Overview |
|
||
| [architecture/module-boundaries.md](architecture/module-boundaries.md) | Ownership boundaries |
|
||
| [architecture/database-architecture.md](architecture/database-architecture.md) | DB architecture |
|
||
| [architecture/multi-tenant-architecture.md](architecture/multi-tenant-architecture.md) | Tenancy |
|
||
| [architecture/deployment-architecture.md](architecture/deployment-architecture.md) | Runtime topology |
|
||
| [architecture/security-architecture.md](architecture/security-architecture.md) | Security |
|
||
| [architecture/identity-architecture.md](architecture/identity-architecture.md) | Identity |
|
||
| [architecture/authorization-architecture.md](architecture/authorization-architecture.md) | Authz |
|
||
| [architecture/integration-architecture.md](architecture/integration-architecture.md) | Integrations |
|
||
| [architecture/event-driven-architecture.md](architecture/event-driven-architecture.md) | Events |
|
||
| [architecture/service-architecture.md](architecture/service-architecture.md) | Service layering |
|
||
| [architecture/ai-architecture.md](architecture/ai-architecture.md) | AI rules |
|
||
| [architecture/compliance-architecture.md](architecture/compliance-architecture.md) | Compliance |
|
||
| [architecture/adr/](architecture/adr/) | ADRs (one decision per file) |
|
||
|
||
### Development
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [development/developer-guide.md](development/developer-guide.md) | How to run/develop |
|
||
| [development/project-principles.md](development/project-principles.md) | Mandatory principles |
|
||
| [development/coding-standards.md](development/coding-standards.md) | Coding conventions |
|
||
| [development/testing-strategy.md](development/testing-strategy.md) | Testing |
|
||
| [development/branching-strategy.md](development/branching-strategy.md) | Git branches |
|
||
| [development/release-strategy.md](development/release-strategy.md) | Releases |
|
||
|
||
### Reference
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [reference/database-schema.md](reference/database-schema.md) | Schema reference |
|
||
| [reference/services-contracts.md](reference/services-contracts.md) | Service contracts |
|
||
| [reference/api-reference.md](reference/api-reference.md) | API index |
|
||
| [reference/event-catalog.md](reference/event-catalog.md) | Events |
|
||
| [reference/provider-reference.md](reference/provider-reference.md) | Provider details |
|
||
|
||
### Deployment
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [deployment/deployment.md](deployment/deployment.md) | Deploy overview |
|
||
| [deployment/production.md](deployment/production.md) | Production |
|
||
| [deployment/ssl.md](deployment/ssl.md) | TLS / tenant SSL |
|
||
| [deployment/monitoring.md](deployment/monitoring.md) | Monitoring |
|
||
| [deployment/backup.md](deployment/backup.md) | Backup |
|
||
| [deployment/restore.md](deployment/restore.md) | Restore |
|
||
| [deployment/disaster-recovery.md](deployment/disaster-recovery.md) | DR |
|
||
|
||
### Registries & Glossary
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [module-registry.md](module-registry.md) | All modules |
|
||
| [provider-registry.md](provider-registry.md) | All providers |
|
||
| [glossary.md](glossary.md) | Terms |
|
||
|
||
### Frontend
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [frontend/README.md](frontend/README.md) | Accounting UI & design system index |
|
||
|
||
### AI / Enterprise Development Framework
|
||
|
||
| Document | Responsibility |
|
||
| --- | --- |
|
||
| [ai-framework/README.md](ai-framework/README.md) | Framework purpose, usage, reading order |
|
||
| [project-status.yaml](project-status.yaml) | Single execution dashboard — critical_path / priorities / readiness |
|
||
| [ai-framework/master-prompt.md](ai-framework/master-prompt.md) | Global implementation rules |
|
||
| [ai-framework/enterprise-phase-discovery.md](ai-framework/enterprise-phase-discovery.md) | Mandatory pre-implementation discovery |
|
||
| [ai-framework/definition-of-done.md](ai-framework/definition-of-done.md) | Mandatory Definition of Done |
|
||
| [ai-framework/mandatory-phase-artifacts.md](ai-framework/mandatory-phase-artifacts.md) | Artifacts every phase includes by default |
|
||
| [ai-framework/enterprise-completeness.md](ai-framework/enterprise-completeness.md) | Pre-close completeness verification |
|
||
| [ai-framework/boundary-rules.md](ai-framework/boundary-rules.md) | Service/phase/integration hard boundaries |
|
||
| [ai-framework/development-loop.md](ai-framework/development-loop.md) | Permanent implementation lifecycle |
|
||
| [ai-framework/quality-gates.md](ai-framework/quality-gates.md) | Mandatory quality gates |
|
||
| [ai-framework/phase-manifest.yaml](ai-framework/phase-manifest.yaml) | Phase registry |
|
||
| [ai-framework/service-manifest.yaml](ai-framework/service-manifest.yaml) | Service registry |
|
||
| [ai-framework/prompt-rules.md](ai-framework/prompt-rules.md) | Phase prompt rules |
|
||
| [ai-framework/cursor-guidelines.md](ai-framework/cursor-guidelines.md) | Cursor workflow |
|
||
| [architecture/adr/ADR-013.md](architecture/adr/ADR-013.md) | Framework ADR |
|
||
| [architecture/adr/ADR-018.md](architecture/adr/ADR-018.md) | Enterprise Completeness Mandate |
|
||
| [architecture/adr/ADR-019.md](architecture/adr/ADR-019.md) | Mandatory Enterprise Phase Discovery |
|
||
| [architecture/adr/ADR-014.md](architecture/adr/ADR-014.md) | Sports Center Platform ADR |
|
||
| [architecture/adr/ADR-015.md](architecture/adr/ADR-015.md) | Delivery & Fleet Platform ADR |
|
||
| [architecture/adr/ADR-016.md](architecture/adr/ADR-016.md) | Experience Platform ADR |
|
||
|
||
### Decisions, Templates, Phases
|
||
|
||
| Path | Responsibility |
|
||
| --- | --- |
|
||
| [decisions/](decisions/) | Non-architectural decisions |
|
||
| [templates/](templates/) | Required document templates (short forms) |
|
||
| [ai-framework/](ai-framework/) | AI implementation templates & lifecycle |
|
||
| [phases/](phases/) | Phase area documentation |
|
||
|
||
## Phase Completion Gate
|
||
|
||
No implementation phase is complete until:
|
||
|
||
- [ ] Business Analysis completed for the phase
|
||
- [ ] Enterprise Phase Discovery completed; Missing→Implement gaps closed ([ai-framework/enterprise-phase-discovery.md](ai-framework/enterprise-phase-discovery.md))
|
||
- [ ] Code completed for **all** in-scope business capabilities (CRUD is never sufficient)
|
||
- [ ] Mandatory phase artifacts delivered ([ai-framework/mandatory-phase-artifacts.md](ai-framework/mandatory-phase-artifacts.md))
|
||
- [ ] Definition of Done satisfied ([ai-framework/definition-of-done.md](ai-framework/definition-of-done.md))
|
||
- [ ] Tests passed
|
||
- [ ] Documentation updated
|
||
- [ ] ADR updated (if required)
|
||
- [ ] Module Registry updated
|
||
- [ ] Provider Registry updated (if required)
|
||
- [ ] Progress updated
|
||
- [ ] Next Steps updated
|
||
- [ ] Project Status updated ([project-status.yaml](project-status.yaml) + [project-status.md](project-status.md))
|
||
- [ ] Architecture validation passed
|
||
- [ ] Boundary rules respected ([ai-framework/boundary-rules.md](ai-framework/boundary-rules.md))
|
||
- [ ] Enterprise Completeness signed off ([ai-framework/enterprise-completeness.md](ai-framework/enterprise-completeness.md))
|
||
- [ ] AI/Enterprise framework quality gates passed ([ai-framework/quality-gates.md](ai-framework/quality-gates.md))
|
||
- [ ] Phase handover completed ([ai-framework/phase-handover.md](ai-framework/phase-handover.md))
|
||
- [ ] Manifests updated (if phase/service registration changed)
|
||
- [ ] No TODO remains
|
||
- [ ] Self review completed
|
||
- [ ] Final verification completed
|
||
|
||
## Architecture Guard
|
||
|
||
Before modifying application code, verify consistency with principles, ADRs, registries, tenancy, database architecture, coding standards, testing strategy, and the Enterprise / AI Development Framework. On conflict: **stop**, explain, correct docs/ADR first.
|
||
|
||
## Deprecated Paths
|
||
|
||
Older paths may remain as stubs pointing here. Do not add new content to deprecated files.
|
||
|
||
## Related
|
||
|
||
- Root [README.md](../README.md)
|
||
- [current-architecture-review.md](current-architecture-review.md) (historical review; superseded by this structure)
|