59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# 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.
|