2.6 KiB
Archive
Historical documents kept for context. Nothing here is maintained, and none of it should be treated as current. For how the system works today, start at ../../README.md.
These files were previously scattered across the repository root. They are preserved rather than deleted because they record why parts of the system look the way they do — but they describe past states, and several contradict the current implementation.
specs/ — technical assignments (ТЗ)
The original Russian-language specifications the service was built from, plus scope notes. Useful for understanding intent behind a feature; unreliable as a description of current behaviour.
Includes ОТЛИЧИЯ_ТЗ_ОТ_РЕАЛИЗАЦИИ.md, which itself catalogues where the
implementation diverged from the spec — worth reading before trusting any other file in
this folder.
Also contains the original ТЗ. Модуль - маркетинг..docx.
api-history/ — superseded API documentation
Earlier revisions of the frontend API docs, kept because the analysis API went through three generations that still coexist at runtime.
| File | Superseded by |
|---|---|
marketing-analysis-api.md |
../api/marketing-analysis.md |
marketing-analysis-api-frontend.md |
ditto |
marketing-api-with-jwt-frontend.md |
ditto + ../api/authentication.md |
FRONTEND_API_GUIDE.md |
../api/README.md |
FRONTEND_API_CHANGES.md |
ditto |
FRONTEND_API_CHANGES_V2.md |
ditto |
FRONTEND_API_CHANGES_MARKETING_ANALYSIS.md |
ditto |
changelogs/ — completed change notes
One-off write-ups of finished refactors and bug fixes: the marketing strategy refactor,
chart improvements, a PDF-agent implementation summary, and a NullPointerException
fix in ReportGenerationService.
setup-notes/ — superseded setup guides
Earlier OpenAI setup, startup, MongoDB troubleshooting and GitLab-era deployment instructions. Replaced by configuration.md, development.md, deployment.md and troubleshooting.md.
DEPLOYMENT.md describes the GitLab CI pipeline that was retired in the August 2026
migration to Gitea Actions.
prompts/ — AI prompt drafts and working notes
Iterations of the marketing-analysis prompts and scratch notes written while designing
report generation. Previously the root-level files g.md, l.md and fix.md.
Historical drafts — the prompts actually in use live in the service classes.