Skip to content

docs(architecture): актуализировать architecture.md и project-structure.md под текущий код #385

Description

@ArtVsMark

Часть эпика #381 (§ 3). docs/architecture.md — самый отставший документ проекта (не обновлялся на несколько фичевых волн), при том что CLAUDE.md назначает его каноном «модули, слои, DAG».

Scope — architecture.md

Scope — project-structure.md

  • Добавить в «канонический перечень файлов»: web/rules_adapter.py, web/insights_adapter.py, glossary/data/ (11 bundled-JSON), core/locales/, директорию scripts/ (9 файлов), static/fonts/, static/vendor/, корневые CLAUDE/CONTRIBUTING/CHECKPOINT/SECURITY/CODE_OF_CONDUCT.
  • :13/:16/:92 — «__main__.py → grader.main()» (реально cli.main()); «cli/ режимы 0-4» (0–5); «tests/ 1150+ тестов» (реально 1412 collected).
  • CLAUDE.md:54–55 — «точки входа … cli.py» (это пакет cli/); «всё остальное в core/» игнорирует web//glossary//rules/, ide.py, pytest_plugin.py.

Non-goals

Не менять сам код и не переоформлять DAG-нотацию — только привести содержимое в
соответствие с фактическими импортами.

Критерии приёмки

  • Каждый модуль пакета присутствует в architecture.md и project-structure.md
  • Все рёбра DAG подтверждаются import-строками; ложных клеймов и фантомных рёбер нет
  • Leaf-инварианты в architecture.md совпадают с реальностью (проверка grep-импортов)

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions