DemoPlast documentation

A Django-based catalog site for a plastic packaging manufacturer. This is the project's technical documentation: how to run it, how to operate it, how it is built and why.

The documentation is split into four types following the Diátaxis model — each answers a different question. Pick the one that matches what you need to do right now.

Tutorials

"I am here for the first time — walk me through it." Step-by-step setup from nothing to a running server.

• Run the project locally

How-to guides

"I know the context, I need to solve a specific task." Recipes for routine operations.

• Deploy to a server
• Operations: SSH, logs, backups
• Manage content through the admin
• Enable notification channels

Reference

"I need exact facts: fields, variables, endpoints." Exhaustive tables without explanations.

• Environment variables
• API and endpoints
• Data model

Explanation

"I want to understand why it is built this way." The context behind the architectural decisions.

• Architecture
• 152-FZ compliance
• Decisions (ADR)

---

English is the source of truth for this documentation; the Russian version is a translation (ADR-0006).

Source code and project overview — in the repository README.