This directory contains the cleaned and consolidated project documentation migrated from legacy sources.
architecture/clean-architecture.md– Layering, DI, domain events, validation, loggingarchitecture/permissions-dac.md– DAC hierarchy & permission systemarchitecture/DUAL_CURRENCY_ECONOMY.md– Hard/soft coin module boundaries, ledger, reconciliation, reserves, and rollout gates
papers/dual-currency-economy-whitepaper.md– Product and economic source for the internal hard/soft coin economypapers/whitepaper.md– Legacy Game Guild governance whitepaperpapers/tokenomics.md– Legacy GGG governance token notes; separate from internal hard/soft coins
modules/auth-module.md– Authentication & token lifecyclemodules/tenant-module.md– Multi-tenancy modelmodules/posts-module.md– Domain event driven postsmodules/base-entity.md– Entity base abstraction
api/problem-details-configuration.md– RFC 7807 responses, exception mappings, detail levels, localization, and correlation IDs
frontend/dashboard.md– Dashboard architecture & server actionsfrontend/filter-system.md– Type-safe filter frameworkfrontend/testing-lab.md– Reusable testing lab componentsfrontend/nextjs-migration.md– Next.js 15 migration notesfrontend/notifications.md– Notification integration
testing/test-architecture.md– Test layers & organizationsetup/environment.md– Environment variables, running servicessetup/local-development-cleanup.md– Safe shutdown, cleanup, diagnostics, and local environment recoverysetup/dev-learning.md– Precompiled local Learning environment for functional testing
security/DUAL_CURRENCY_ECONOMY_THREAT_MODEL.md– Financial-integrity, provider, ad-fraud, privacy, and operational controls
See architecture/permissions-dac.md for DAC details.
If adding new docs, keep top-level heading unique and include a short purpose paragraph.