TorbatYar/docs

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/ — permanent AI Development Framework (read before coding)
3. architecture/ and architecture/adr/
4. development/project-principles.md
5. development/coding-standards.md
6. development/testing-strategy.md
7. module-registry.md
8. provider-registry.md
9. glossary.md
10. Relevant phases/ docs

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

Navigation

Status & Planning

Document	Responsibility
progress.md	Completed work only
roadmap.md	Future roadmap only
next-steps.md	Immediate next milestone only
crm-phase-6-0.md	CRM Service Foundation (Phase 6.0)
crm-phase-6-1.md	CRM Core Business Entities (Phase 6.1)
crm-phase-6-2.md	CRM Enterprise Sales Process Engine (Phase 6.2)
crm-phase-6-3.md	CRM Enterprise Sales Collaboration (Phase 6.3)
loyalty-phase-7-0.md	Loyalty Service Foundation (Phase 7.0)
communication-phase-8.md	Enterprise Communication Platform (Phase 8)
sports-center-roadmap.md	Sports Center Platform roadmap (Phases 9.0–9.10)

Architecture

Document	Responsibility
architecture/architecture.md	Overview
architecture/module-boundaries.md	Ownership boundaries
architecture/database-architecture.md	DB architecture
architecture/multi-tenant-architecture.md	Tenancy
architecture/deployment-architecture.md	Runtime topology
architecture/security-architecture.md	Security
architecture/identity-architecture.md	Identity
architecture/authorization-architecture.md	Authz
architecture/integration-architecture.md	Integrations
architecture/event-driven-architecture.md	Events
architecture/service-architecture.md	Service layering
architecture/ai-architecture.md	AI rules
architecture/compliance-architecture.md	Compliance
architecture/adr/	ADRs (one decision per file)

Development

Document	Responsibility
development/developer-guide.md	How to run/develop
development/project-principles.md	Mandatory principles
development/coding-standards.md	Coding conventions
development/testing-strategy.md	Testing
development/branching-strategy.md	Git branches
development/release-strategy.md	Releases

Reference

Document	Responsibility
reference/database-schema.md	Schema reference
reference/services-contracts.md	Service contracts
reference/api-reference.md	API index
reference/event-catalog.md	Events
reference/provider-reference.md	Provider details

Deployment

Document	Responsibility
deployment/deployment.md	Deploy overview
deployment/production.md	Production
deployment/ssl.md	TLS / tenant SSL
deployment/monitoring.md	Monitoring
deployment/backup.md	Backup
deployment/restore.md	Restore
deployment/disaster-recovery.md	DR

Registries & Glossary

Document	Responsibility
module-registry.md	All modules
provider-registry.md	All providers
glossary.md	Terms

Frontend

Document	Responsibility
frontend/README.md	Accounting UI & design system index

AI Development Framework

Document	Responsibility
ai-framework/README.md	Framework purpose, usage, reading order
ai-framework/master-prompt.md	Global AI implementation rules
ai-framework/development-loop.md	Permanent implementation lifecycle
ai-framework/quality-gates.md	Mandatory quality gates
ai-framework/phase-manifest.yaml	Phase registry
ai-framework/service-manifest.yaml	Service registry
ai-framework/prompt-rules.md	Phase prompt rules
ai-framework/cursor-guidelines.md	Cursor workflow
architecture/adr/ADR-013.md	Framework ADR
architecture/adr/ADR-014.md	Sports Center Platform ADR

Decisions, Templates, Phases

Path	Responsibility
decisions/	Non-architectural decisions
templates/	Required document templates (short forms)
ai-framework/	AI implementation templates & lifecycle
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)
• Phase handover completed (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
• current-architecture-review.md (historical review; superseded by this structure)