standards clean

This commit is contained in:
2026-03-22 12:40:02 +03:00
parent 670b29c6a6
commit 2511cfb575
7 changed files with 16588 additions and 15 deletions

View File

@@ -1,5 +1,5 @@
# [DEF:Std:API_FastAPI:Standard] # [DEF:Std:API_FastAPI:Standard]
# @TIER: CRITICAL # @COMPLEXITY: 5
# @PURPOSE: Unification of all FastAPI endpoints following GRACE-Poly. # @PURPOSE: Unification of all FastAPI endpoints following GRACE-Poly.
# @LAYER: UI (API) # @LAYER: UI (API)
# @INVARIANT: All non-trivial route logic must be wrapped in `belief_scope`. # @INVARIANT: All non-trivial route logic must be wrapped in `belief_scope`.
@@ -9,7 +9,7 @@
Every API route file must start with a module definition header: Every API route file must start with a module definition header:
```python ```python
# [DEF:ModuleName:Module] # [DEF:ModuleName:Module]
# @TIER: [CRITICAL | STANDARD | TRIVIAL] # @COMPLEXITY: [1-5]
# @SEMANTICS: list, of, keywords # @SEMANTICS: list, of, keywords
# @PURPOSE: High-level purpose of the module. # @PURPOSE: High-level purpose of the module.
# @LAYER: UI (API) # @LAYER: UI (API)

View File

@@ -1,5 +1,5 @@
# [DEF:Std:Architecture:Standard] # [DEF:Std:Architecture:Standard]
# @TIER: CRITICAL # @COMPLEXITY: 5
# @PURPOSE: Core architectural decisions and service boundaries. # @PURPOSE: Core architectural decisions and service boundaries.
# @LAYER: Infra # @LAYER: Infra
# @INVARIANT: ss-tools MUST remain a standalone service (Orchestrator). # @INVARIANT: ss-tools MUST remain a standalone service (Orchestrator).
@@ -15,11 +15,9 @@
## 2. COMPONENT BOUNDARIES ## 2. COMPONENT BOUNDARIES
* **Plugins:** All business logic must be encapsulated in Plugins (`backend/src/plugins/`). * **Plugins:** All business logic must be encapsulated in Plugins (`backend/src/plugins/`).
* **TaskManager:** All long-running operations MUST be handled by the TaskManager. * **TaskManager:** All long-running operations MUST be handled by the TaskManager.
* **Security:** Independent RBAC system managed in `auth.db`.
## 3. INTEGRATION STRATEGY ## 3. INTEGRATION STRATEGY
* **Superset API:** Communication via REST API. * **Superset API:** Communication via REST API.
* **Database:** Local SQLite for metadata (`tasks.db`, `auth.db`, `migrations.db`).
* **Filesystem:** Local storage for backups and git repositories. * **Filesystem:** Local storage for backups and git repositories.
# [/DEF:Std:Architecture] # [/DEF:Std:Architecture]

View File

@@ -1,5 +1,5 @@
# [DEF:Std:Constitution:Standard] # [DEF:Std:Constitution:Standard]
# @TIER: CRITICAL # @COMPLEXITY: 5
# @PURPOSE: Supreme Law of the Repository. High-level architectural and business invariants. # @PURPOSE: Supreme Law of the Repository. High-level architectural and business invariants.
# @VERSION: 2.3.0 # @VERSION: 2.3.0
# @LAST_UPDATE: 2026-02-19 # @LAST_UPDATE: 2026-02-19
@@ -23,7 +23,6 @@
### IV. Security & RBAC ### IV. Security & RBAC
* **Permissions:** Every Plugin must define unique permission strings (e.g., `plugin:name:execute`). * **Permissions:** Every Plugin must define unique permission strings (e.g., `plugin:name:execute`).
* **Auth:** Mandatory registration in `auth.db`.
### V. Independent Testability ### V. Independent Testability
* **Requirement:** Every feature must define "Independent Tests" for isolated verification. * **Requirement:** Every feature must define "Independent Tests" for isolated verification.

View File

@@ -1,5 +1,5 @@
# [DEF:Std:Plugin:Standard] # [DEF:Std:Plugin:Standard]
# @TIER: CRITICAL # @COMPLEXITY: 5
# @PURPOSE: Standards for building and integrating Plugins. # @PURPOSE: Standards for building and integrating Plugins.
# @LAYER: Domain (Plugin) # @LAYER: Domain (Plugin)
# @INVARIANT: All plugins MUST inherit from `PluginBase`. # @INVARIANT: All plugins MUST inherit from `PluginBase`.

View File

@@ -30,7 +30,7 @@
## III. ТОПОЛОГИЯ ФАЙЛА (СТРОГИЙ ПОРЯДОК) ## III. ТОПОЛОГИЯ ФАЙЛА (СТРОГИЙ ПОРЯДОК)
1. **HEADER (Заголовок):**[DEF:filename:Module] 1. **HEADER (Заголовок):**[DEF:filename:Module]
@COMPLEXITY: [1|2|3|4|5] *(алиас: `@C:`; legacy `@TIER` допустим только для обратной совместимости)* @COMPLEXITY: [1|2|3|4|5] *(алиас: `@C:`)*
@SEMANTICS: [keywords] @SEMANTICS: [keywords]
@PURPOSE: [Однострочная суть] @PURPOSE: [Однострочная суть]
@LAYER: [Domain | UI | Infra] @LAYER: [Domain | UI | Infra]
@@ -92,10 +92,6 @@
- Для UI требуются UX-контракты. - Для UI требуются UX-контракты.
- Использование `belief_scope` строго обязательно. - Использование `belief_scope` строго обязательно.
**Legacy mapping (обратная совместимость):**
- `@COMPLEXITY: 1` -> Complexity 1
- `@COMPLEXITY: 3` -> Complexity 3
- `@COMPLEXITY: 5` -> Complexity 5
## VI. ПРОТОКОЛ ЛОГИРОВАНИЯ (THREAD-LOCAL BELIEF STATE) ## VI. ПРОТОКОЛ ЛОГИРОВАНИЯ (THREAD-LOCAL BELIEF STATE)
Логирование — это механизм трассировки рассуждений ИИ (CoT) и управления Attention Energy. Архитектура использует Thread-local storage (`_belief_state`), поэтому `ID` прокидывается автоматически. Логирование — это механизм трассировки рассуждений ИИ (CoT) и управления Attention Energy. Архитектура использует Thread-local storage (`_belief_state`), поэтому `ID` прокидывается автоматически.

View File

@@ -1,5 +1,5 @@
# [DEF:Std:UI_Svelte:Standard] # [DEF:Std:UI_Svelte:Standard]
# @TIER: CRITICAL # @COMPLEXITY: 5
# @PURPOSE: Unification of all Svelte components following GRACE-Poly (UX Edition). # @PURPOSE: Unification of all Svelte components following GRACE-Poly (UX Edition).
# @LAYER: UI # @LAYER: UI
# @INVARIANT: Every component MUST have `<!-- [DEF:] -->` anchors and UX tags. # @INVARIANT: Every component MUST have `<!-- [DEF:] -->` anchors and UX tags.
@@ -28,7 +28,7 @@ Each Svelte file must follow this structure:
<!-- [DEF:ComponentName:Component] --> <!-- [DEF:ComponentName:Component] -->
<script> <script>
/** /**
* @TIER: [CRITICAL | STANDARD | TRIVIAL] * @COMPLEXITY: [1-5]
* @PURPOSE: Brief description of the component purpose. * @PURPOSE: Brief description of the component purpose.
* @LAYER: UI * @LAYER: UI
* @SEMANTICS: list, of, keywords * @SEMANTICS: list, of, keywords

16580
.ai/structure/PROJECT_MAP.md Normal file

File diff suppressed because it is too large Load Diff