# TorbatYar Documentation

Permanent source of truth for architecture, standards, registries, deployment, and phase planning.

## Start Here (every implementation phase)

1. This file
2. [ai-framework/](ai-framework/) — permanent AI Development Framework (read before coding)
3. [architecture/](architecture/) and [architecture/adr/](architecture/adr/)
4. [development/project-principles.md](development/project-principles.md)
5. [development/coding-standards.md](development/coding-standards.md)
6. [development/testing-strategy.md](development/testing-strategy.md)
7. [module-registry.md](module-registry.md)
8. [provider-registry.md](provider-registry.md)
9. [glossary.md](glossary.md)
10. Relevant [phases/](phases/) docs

If a change affects architecture, APIs, providers, or module boundaries: **update documentation first**, then code.

## Navigation

### Status & Planning

| Document | Responsibility |
| --- | --- |
| [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) |
| [sports-center-roadmap.md](sports-center-roadmap.md) | Sports Center Platform roadmap (Phases 9.0–9.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 Development Framework

| Document | Responsibility |
| --- | --- |
| [ai-framework/README.md](ai-framework/README.md) | Framework purpose, usage, reading order |
| [ai-framework/master-prompt.md](ai-framework/master-prompt.md) | Global AI implementation rules |
| [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-014.md](architecture/adr/ADR-014.md) | Sports Center 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:

- [ ] Code completed
- [ ] Tests passed
- [ ] Documentation updated
- [ ] ADR updated (if required)
- [ ] Module Registry updated
- [ ] Provider Registry updated (if required)
- [ ] Progress updated
- [ ] Next Steps updated
- [ ] Architecture validation passed
- [ ] AI 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, and testing strategy. 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)
