# 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](../../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`](../api/marketing-analysis.md) |
| `marketing-analysis-api-frontend.md` | ditto |
| `marketing-api-with-jwt-frontend.md` | ditto + [`../api/authentication.md`](../api/authentication.md) |
| `FRONTEND_API_GUIDE.md` | [`../api/README.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](../configuration.md),
[development.md](../development.md), [deployment.md](../deployment.md) and
[troubleshooting.md](../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.