
1c-ai-pipeline
Навыки, правила, защитные хуки и MCP-инструменты для анализа и развития решений на 1С: работа с требованиями, исходным кодом, метаданными, формами, отчётами, интеграциями, правами и сценариями тестирования.
- version
- 1.2.0
- GitHub stars
- 6
Install
/plugin install 1c-ai-pipeline@1c-ai-pipelineRun it inside Claude Code after adding the marketplace with /plugin marketplace add infostart-hub/vanessa-ai-pipeline.
Contents
Discovered from sourceSkills 45
EDT-MCP code research
Purpose and trigger
Use this skill to produce a bounded, evidence-backed explanation of 1C project code, dependencies, impact, or implementation differences.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Keep the task read-only and tied to exact project, metadata FQN, module, method,
or symbol targets. Route a known bounded correction to
edt-mcp-project-local-fix; do not turn research into implementation without
authorization.
Primary workflow
- Resolve candidates with
get_metadata_objects,list_modules, andsearch_in_code. Search is literal and not dialect-aware: for identifiers, use AST-backed definition/reference/hierarchy tools and do not infer absence from one Russian or English spelling. - Narrow with
get_module_structure, then preferread_method_sourceoverread_module_sourceunless module-level context is required. - Follow only the relationships needed using
go_to_definition,find_references,get_method_call_hierarchy,get_outgoing_structures, orget_symbol_info. get_method_call_hierarchyscans only one project's<project>/src. Inspect each relevant base/extension project separately and name any project left unsearched. Treatget_outgoing_structuresas a heuristic lower bound, even when its response is not marked partial.- Treat every single-hop/depth-1 result and structured-output analysis as a lower bound. Inspect bounded source and relevant projects before claiming a complete contract.
- Start with counts, file lists, filters, or method/range reads; request full payloads or more pages only when needed. Preserve truncation and cursor evidence in the result.
- Use
get_platform_documentationwhen the conclusion depends on platform behavior rather than project code.
Explain the business consequence
For an analyst asking where a field value comes from, trace the originating business object and the event that copies or computes the value. Check whether the destination stores a relationship to that object or only a copied value; inspect relevant base and extension metadata before claiming a missing link. Explain the observable consequence in business language. Distinguish a proven implementation limitation from a requirements gap that needs confirmation. When useful, give a small number of alternatives and their tradeoffs; do not implement them or invent an upstream integration. Cite the method and metadata that support the conclusion. A code location alone is not the explanation.
Authority rule
Do not write code, metadata, runtime data, or Git state. Request a new task boundary before any implementation or runtime experiment.
Stop rule
Stop when the exact target cannot be resolved, required project evidence is unavailable, or the conclusion needs unauthorized runtime proof.
Completion signal
Return exact targets, the evidenced call/data flow, relevant dependencies and exceptions, impact classification, partial-result caveats, unknowns, and the smallest useful next validation step.
EDT-MCP external objects
Purpose and trigger
Use this skill for metadata, code, forms, builds, or a bounded debug run of an external data processor/report that exists in an EDT external-object project.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Select the exact external-object project and qualified
ExternalDataProcessor.<Name> or ExternalReport.<Name> target. Do not
substitute its linked base configuration, a normal configuration object, or a
prebuilt .epf/.erf outside an EDT project.
Primary workflow
- Resolve the project, object, linked base application, and runtime target with
list_projects,get_applications, andlist_configurations. - Route metadata structure to
edt-mcp-project-metadata, BSL changes toedt-mcp-project-local-fix, and managed-form work toedt-mcp-project-forms; re-read and validate the exact owning object after a mutation. - For a build, resolve the qualified target and compare its simple name across
both external-object kinds.
objectNameis a simple-name selector; stop on a processor/report collision unless building both is explicitly authorized. Before building, obtain explicit update/restructure authority for the associated build infobase, or confirm that it is disposable; the platform dumper may prepare and update that infobase even for an ordinary build. Callbuild_external_objectsinto a fresh empty staging directory, omittingobjectNameonly for an authorized build-all. SetrecordBuildTime=falseunless changing the source object's Comment was requested. Verify the result and staged artifact before promotion; preserve an existing artifact and authorize its exact replacement before any in-place build or promotion. - For a debug run, complete target, launch-policy, disclosure, credential, and
debug_statuspreflight first, usingset_infobase_credentialsonly when authorized. If a matching live client exists, use it only as an explicitly authorized target; stop when the external object requires a fresh launch. Otherwise callset_breakpointbefore launching the resolved external-object target according to the currentlaunchhelp/schema. Retain task-owned IDs and verify that the returned target identity matches the resolved target. If a preflight race returnsalreadyRunning=true, refresh the uniquely identified target, resume only a task-caused suspension, remove task-owned temporary state, and stop. Terminate and relaunch only with explicit user authorization. - After launch, settle the task-owned launch outcome under current tool
help/schema and a bounded caller-approved deadline before cleanup, an
absence claim, or completion. If the deadline expires, report the launch as
in-flight or unknown with its outstanding task-owned cleanup obligation; do
not assume a later client cannot appear. Once settled, call
wait_for_breakand inspect withget_variablesonly when the current help proves the intended debug target is unambiguous. Otherwise remove only task-owned temporary state and stop. - Finish with
resumefor any task-suspended execution, callingremove_breakpoint, and usingterminate_launchonly for a uniquely identified, task-owned launch whose termination is authorized.
Authority rule
Building, credentials, infobase update/restructure, external-change handling, launch/restart, artifact replacement, data disclosure, and termination require the authority applicable to their exact targets and effects.
Stop rule
Stop on wrong project kind, ambiguous object/runtime/debug target, unsupported write, missing prerequisite, unavailable credentials, or unapproved side effects. Never operate on an unrelated active launch to make the route work.
Completion signal
Report the exact project/object, confirmed changes or build artifacts, bounded runtime evidence when requested, partial or unproved claims, and cleanup of all task-owned temporary state.
EDT-MCP managed forms
Purpose and trigger
Use this skill to inspect or change a managed form's structure, data, commands, handlers, dynamic lists, or visible layout.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Work on the exact project and form FQN through structured EDT-MCP operations.
Route code-only fixes to edt-mcp-project-local-fix and DCS changes to
edt-mcp-project-query-dcs. Direct Form.form editing is a last resort only
when the installed project rules describe the procedure, structured operations
cannot represent the change, and the user explicitly authorizes the risk.
Primary workflow
- When the request concerns usability, field grouping, reading/editing comfort,
or the order of user actions, load
onec-managed-form-designfirst. Use its scenario and composition analysis to derive the change proposal from actual metadata. This technical skill executes that proposal; it does not replace the subject skill with an arbitrary rearrangement. For a narrowly specified binding or handler repair, that design handoff is not required. - Read the form with
get_metadata_detailsand inspect only relevant handlers withget_module_structureandread_method_source. - Consult the current guide, then use the narrowest supported
create_metadata,modify_metadata, ordelete_metadataoperation. - Re-read the form and verify the requested ownership, binding, data-path,
command, and handler relationships; validate changed query text with
validate_querywhen applicable. - For a dynamic list, verify its owning form attribute, main table or custom
query, selected fields, visible item data paths, settings/filter handlers,
and refresh/requery behavior. Validate changed query text before writing and
ensure every visible
List.Fieldpath resolves afterward. - Use
get_form_layout_snapshotwhen layout structure matters andget_form_screenshotonly when rendered appearance is acceptance evidence.get_form_screenshotis disabled by default; if it is not intools/list, report visual evidence as unavailable. When taking a post-change screenshot, userefresh=true. Blank output most likely means EDT lacks-DnativeFormBufferedLayoutRender=true; report visual evidence as unavailable rather than treating the change as failed. - Run targeted validation and an authorized runtime UI scenario only when interaction behavior must be proven.
Authority rule
Do not broaden a form mutation, leave dangling bindings, activate UI, launch a client, or change runtime data without the authority required for that effect.
Stop rule
Stop when the form target is ambiguous, the structured writer cannot represent the requested change, required references cannot be preserved, or necessary visual/runtime evidence is unavailable.
Completion signal
Return the exact form target, confirmed structural/source diff, targeted validation, requested layout or runtime evidence, and explicit gaps. A model read or screenshot proves only the state it actually reports, not user interaction.
Runtime-safe form commands
Do not shadow platform form methods with custom handlers: use a semantic name
such as ОткрытьСпецификацию, not Открыть. Update the command action, element
references and callers together. EDT model validation alone does not prove that
the platform can compile a dynamic form.
Avoid opening an experimental form directly inside application startup. If the authorized demo requires startup routing, contain exceptions at that boundary, report the original module/line and keep the application usable. A timer or automated preparation is not evidence that the agent performed the business task. Use the existing client for the UI result; do not install or start another EDT.
EDT-MCP local BSL fix
Purpose and trigger
Use this skill when the defect and exact BSL method or small query-bearing fragment are known and the user requested a bounded correction.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Change one logical BSL surface in the exact project/module/method. Do not expand into architecture, metadata/form/DCS structure, unrelated cleanup, or plugin code.
Primary workflow
- Resolve and read the exact method with
read_method_source; retain the returnedcontentHashfor lost-update protection. - Validate a changed 1C query with
validate_querybefore writing when applicable. - Consult
get_tool_guidefor the current write contract, then apply the smallest guardedwrite_module_sourceedit. Modereplaceoverwrites the whole module; use it only for an intentional full-module replacement, not a method-sized edit. - Re-read the method, revalidate any final query, and run targeted
revalidate_objectsplusget_project_errorsafter every code write. - Inspect the minimal repository diff and add only the focused test or runtime probe required by acceptance.
Authority rule
The request authorizes only the bounded source correction. It does not authorize infobase updates, client launches, runtime data changes, broader refactors, or unrelated Git changes.
Stop rule
Stop before writing on target ambiguity, non-unique replacement, stale lost-update evidence, failed query validation, unready project state, or an unresolved design decision.
Completion signal
Return the exact changed method, minimal diff, successful readback and targeted validation, focused runtime/test evidence when required, and remaining static versus runtime gaps.
EDT-MCP project maintenance
Purpose and trigger
Use this skill for bounded project diagnostics, revalidation, clean/resync, application maintenance, database update, configuration import/export, or Git operations when enabled.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Target one exact EDT project, application, repository tree, or caller-approved import/export location. Route business code and metadata changes to their task skills; do not broaden maintenance to the workspace or unrelated projects.
Primary workflow
- Diagnose with
get_project_errors,get_problem_summary, and targetedrevalidate_objects; useapply_quick_fix,clean_project, orresync_to_diskonly when current evidence and help select that operation. Apply a quick fix only for an authorized exact marker and variant, then inspect its diff. Beforeclean_project, prove the exact project has no unsaved in-memory model edits; preserve any through the current supported, authorized save/resync route, or stop if safety cannot be proved. Always pass the exact project; omission rebuilds every EDT project. After any clean, polllist_projectswithformat=jsonand bounded backoff for at most five minutes, or a shorter caller deadline, until that exact project reportsready. If the deadline expires, stop and report the unsettled project; do not trust the clean result or continue against an unsettled/unknown state. - Resolve application identity with
get_applicationsandlist_configurations. Note thatget_applicationsenriches autonomous (standalone) server entries (type="com.e1c.g5.dt.applications.type.wst-server",applicationKind="standaloneServer") withwebUrl,port,wsConnectionString, andinfobaseFile; to wrap an existing1Cv8.1CDin an EDT standalone server usecreate_infobase(..., applicationKind="standaloneServer", mode="register"). For astandaloneServer(wst-server) application, prefer coordinated launch (launchorrun_yaxunit_testswithupdateBeforeLaunch=true) rather than a bareupdate_database. Forupdate_databaseon file/cluster infobases, review the current preview and side effects withterminateRunningClients=false, obtain authority, execute once with the reviewed value, and verify the final state. Usetrueonly when explicit application-wide authority covers every matching EDT-launched client that may appear between preview and apply. - Poll a returned job only with
get_job_status; usecancel_jobonly under its current authorization and confirmation contract. Treat a client timeout as an unknown result; reconcile the authoritative operation outcome under current help before retrying, continuing, or reporting completion. - For import, confirm a caller-approved source plus a new project target, call
import_configuration_from_xmlfor a directory of XML files orimport_project_from_filefor a .cf/.cfe/.epf/.erf file, then verify the returned project exists and becomes usable. For export, confirm the exact project and approved output directory, callexport_configuration_to_xml, then verify the reported destination and expected export result. - Before using the current working tree, inspect actual repository status and
diff through the project-approved Git route and prove it clean, free, and not
needed for parallel work. Use
list_git_branchesonly for branch/binding identity, then usecreate_git_branchorswitch_git_branchas appropriate. A task branch must be checked out explicitly; verify the returnedcheckedOut/current branch before any mutation because branch creation alone leaves the working tree on its previous branch by default. - When the active project has foreign changes or parallel work is required, do not switch it. Use a separate Git worktree through the project-approved Git route and resolve that checkout as a distinct EDT project before MCP mutation. Lack of MCP worktree support is a capability limitation, not a prohibition; use an authorized route or stop with a concrete question.
Authority rule
Database/project/file deletion, update/restructure, import/export overwrite, credential storage, launch termination, branch switching, publication, and any operation affecting foreign work require explicit authority for the exact target and effect.
Stop rule
Stop on ambiguous direction or identity, unsaved/foreign state at risk, unreviewed destructive effects, unsupported worktree routing, or a background job whose final state is unknown.
Completion signal
Report exact targets, before/after project/application/Git state, diagnostics, job finality, verified import/export destination or project, and any operation intentionally not performed.
EDT-MCP metadata workflow
Purpose and trigger
Use this skill to inspect or change exact 1C metadata objects, members, roles, rights, RLS, or extension composition through structured EDT-MCP operations.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Resolve the exact project and metadata FQN. Use edt-mcp-project-forms for
managed-form structure and edt-mcp-project-query-dcs for DCS content; never
edit metadata XML to bypass the structured surface.
Primary workflow
- Resolve metadata by programmatic
Name, never by localized synonym. Only the FQN type token is bilingual (for exampleCatalog/Справочник). Read the target withget_metadata_details, including the current writable surface when needed. - Use
find_referencesonly for targets supported by its current help; use the relevant mutation preview and bounded consumer checks for other targets. - Consult the current guide, preview destructive or cascading effects, then
use the smallest
create_metadata,modify_metadata,rename_metadata_object,delete_metadata, oradopt_metadata_objectoperation. For a new typed metadata member, include its intended structuredtypeincreate_metadatawhen the current guide supports it; do not create a default String(10) just to retype it in a second call. Changes to existing types still follow the destructive-change preview and approval contract. - For roles and RLS, follow the current guide's ordering and effective-rights model, re-read the complete affected state, and treat partial application as possible until readback proves otherwise.
- For extension work, identify the base and exact extension project. Call
adopt_metadata_objectwith the base asprojectNameand an explicitextensionProjectNamewhen more than one extension is possible. Adoption covers the metadata object; route BSL override/interception work toedt-mcp-project-local-fixand validate the extension afterward. - Re-read the target, validate it, and re-check relevant references. Use an authorized runtime test when effective access or RLS behavior is acceptance.
Authority rule
Rename, delete, cascade, force, adoption, rights/RLS changes, and rollback need authority for their exact targets and consequences. A preview is not approval.
Stop rule
Stop on ambiguous FQN, unsupported mutation, incomplete destructive preview, missing authority, failed persistence/readback, or required runtime proof that cannot be performed safely.
Completion signal
Return the exact metadata target, confirmed structured diff and persistence, targeted validation/reference evidence, effective-rights evidence when applicable, and explicit runtime or completeness gaps.
EDT-MCP profiling
Purpose and trigger
Use this skill when one reproducible performance question requires runtime measurement against an exact 1C application.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Measure one authorized scenario and data volume. Do not mix the measurement with refactoring, broad load generation, or unrelated runtime activity.
Primary workflow
- Define the question and resolve an active, unambiguous debug target with
debug_status; route launch or Attach preparation toedt-mcp-project-runtime-debugwhen needed. - Establish an attributable profiling window using current help and existing
get_profiling_resultsstate. Keep the global profiling surface quiescent through the final result read; if result identity cannot be matched independently, treat the global result as unattributed. - Call
start_profilingand claim ownership only when its result confirms this task started the profiling window. If profiling was already active, do not stop or replace it; stop and report that an attributable window could not be established without disrupting another owner. Otherwise execute only the bounded scenario and callstop_profilingfor that task-owned window on success, failure, timeout, or interruption. - Read
get_profiling_resultsin that protected window, correlate candidate methods/lines with exact source, and repeat only for a controlled comparison. - Treat returned profiling rows as potentially partial; do not make absolute hotspot or completeness claims unless the measurement proves them.
Authority rule
The target application, scenario, data effects, launch/Attach work, and any repeat measurement must be authorized. Profiling does not authorize a code fix.
Stop rule
Stop and clean up when the target changes, another session prevents reliable attribution, the scenario would mutate prohibited data, or results cannot be linked to the intended run.
Completion signal
Report the exact target and scenario, conditions, observed duration and candidate hotspots, partial-result and attribution limits, cleanup status, and the next validation experiment for any proposed optimization.
EDT-MCP query and DCS workflow
Purpose and trigger
Use this skill to locate, inspect, validate, or change a 1C query or supported Data Composition Schema surface.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Resolve the exact project, owning method or schema FQN, dataset, exact settings
variant/default settings, and business grain. Route form-only work elsewhere
and never edit .dcs directly to bypass an unsupported structured operation.
Primary workflow
- Locate the owner with
search_in_code,get_module_structure,read_method_source, orget_metadata_details. - Read the complete owning method for an embedded BSL query. For DCS,
read current
get_tool_guide('dcs')and the live schema, then usedcsget for the exact root and returned node addresses. A summary or dataset node may omit query text: read its advertised query address and all pages. Pass only the complete query text, excluding Markdown framing, tovalidate_queryin the exact project. UsedcsMode=truefor DCS queries and plain mode for ordinary queries. Inspectvalidandissues; tool-call success does not imply validity. - Preserve business grain and cardinality. Hand an embedded BSL query mutation
to
edt-mcp-project-local-fixand require its guarded lost-update workflow; use the existingdcsowner for supported schema/settings mutations. Copy addresses and root hash from get. Indexed edits and replace/remove requireexpectedHash; prefer update of the exact existing node. Preserve dependencies, disabled settings, user identities, and designer content outside the target. Replace resets omitted members. Do not drop charts or switch to raw file edits when a typed operation is unsupported. - Re-read the owner, validate the final query, and inspect targeted
get_project_errorswhen markers matter. - Run an authorized report/runtime check only when rows, totals, RLS, parameters, performance, or presentation are part of acceptance.
Authority rule
Do not broaden source/DCS changes, bypass access restrictions, execute against runtime data, or alter report settings beyond the authorized target.
Stop rule
Stop on ambiguous ownership, unresolved model validation, unsupported DCS write capability, unsafe cardinality, or missing runtime target/read authority.
Completion signal
Return the exact owner and dataset, confirmed source/schema diff, successful readback and static validation, business-grain reasoning, and explicit gaps. Static validation never proves returned rows, totals, RLS, performance, or UI.
EDT-MCP runtime debugging
Purpose and trigger
Use this skill when one runtime question needs authorized launch, Attach, debugger, variable, expression, or event-log evidence.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Resolve one exact project, application, launch/Attach configuration, and runtime
question. Skip launch and debugger work entirely when bounded get_event_log
evidence alone answers the question.
Primary workflow
- For event-log-only work, resolve the authorized log source, apply current
server-side bounds from help, call
get_event_log, and report any paging, format, location, disclosure, or completeness gap. - Otherwise resolve the target with
get_applications,list_configurations,debug_status, andlist_breakpoints; distinguish pre-existing breakpoints from task-owned ones, and settle update, external-change, restart, credential, and data-disclosure authority before launching. - Use
set_infobase_credentialsonly for the confirmed target and only when authorized. Decide fromdebug_statuswhether to use an existing session or start a fresh one before installing the smallestset_breakpoint. Use an existing session directly only when it is the exact authorized target and no fresh-start effect is required; install the breakpoint and continue withoutlaunch, or stop. For a fresh launch or Attach, set the breakpoint before starting it and retain task-owned identifiers. When that exact session is already running and no breakpoint line is known,debug_pausestops it at the next BSL statement it runs instead. - If a preflight race makes
launchreportalreadyRunning=true, do not claim that launch, update, restart, or startup options ran. Refresh the uniquely identified target, resume only a suspension caused by the task's breakpoint, remove task-owned temporary state, and stop unless a fresh relaunch was explicitly authorized. Never resume an ambiguous or unrelated suspension. - Settle any in-progress or unknown launch outcome under current help and a
bounded caller-approved deadline before removing a task-owned breakpoint,
treating the launch as absent, or completing. Before
debug_pause,wait_for_break,get_variables,evaluate_expression,set_variable,step, orresume, require current help and status to identify one unambiguous intended debug target. Otherwise remove only task-owned temporary state and stop. - Collect only the bounded evidence needed. Treat expression evaluation and variable mutation as potentially state-changing.
- Resume execution if this task suspended it. A
debug_pausethat returnedpaused: falsestays armed: catch it withwait_for_breakand resume it, or report the armed request. Callremove_breakpoint, and useterminate_launchonly for a uniquely identified, task-owned launch whose termination is authorized.
Authority rule
Infobase update/restructure, external-change handling, credentials, restart, Attach, sensitive-data disclosure, expression/state mutation, and launch termination each require authority for the exact target and effect.
Stop rule
Stop on ambiguous debugger target, missing launch/Attach route, unapproved side effects or disclosure, shared-session risk, or uncontrolled BSL execution.
Completion signal
Report the exact runtime target and mode, decisive frame/value/log evidence, server-side bounds and partial-result caveats, any state mutation, and cleanup of task-owned suspensions, breakpoints, and launches.
Exception-first launch observation
A live process is not application readiness. Before launch record a fresh event log boundary; inspect new errors immediately while waiting for the requested form. Empty platform /Out does not rule out an event-log-only exception. Keep the full module, line and original message. Shared infobase events require session/action correlation. Do not relaunch after an exception until its cause is changed; a screenshot is a result artifact, not the exception detector.
EDT-MCP project session
Purpose and trigger
Use this skill to establish the exact EDT-MCP route, project, and required capability before another business-project workflow begins.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Discover only facts needed for the current 1C project task. Do not use this skill for EDT-MCP plugin development or repeat preflight whose evidence remains current.
Primary workflow
- Reuse valid session evidence. On an unfamiliar workspace, use the bounded
onboarding route:
get_edt_version->list_projects->get_configuration_properties->get_problem_summary, thenlist_subsystemsonly when project navigation needs it. Resolve the exact project and kind before continuing. - When proxy routing matters, call
router_status; useget_server_statusonly when installed surface or EDT state affects the task. - If a required capability is hidden, inspect
list_toolsetsand useenable_toolsetonly as current help permits. Follow the client's supported catalog-refresh or reconnect route; do not assume either behavior. - Call
get_tool_guidefor the selected unfamiliar, destructive, or cascading operation rather than preloading unrelated guides. - Prefer counts, filters, narrow fields, and paginated reads before full payloads. Preserve cursors and truncation evidence; fetch another page only when the task's conclusion requires it.
- Resolve metadata by programmatic
Name, never by localized synonym. Only the FQN type token is bilingual (for exampleCatalog/Справочник). - Hand off the exact project and visible capability to one primary task skill.
Load that task skill before doing its work. This session skill establishes
context; it does not replace the code-research, metadata, or other task
workflow. For a question about where a field is filled, continue with
edt-mcp-project-code-research.
Authority rule
Discovery does not authorize project mutation, destructive operations, runtime effects, optional Git/Workmate use, or substitution of a different project.
Stop rule
Stop when project ownership or route is ambiguous, the required capability remains unavailable, or the next operation lacks a proven target or authority.
Completion signal
Record the selected project, project kind when relevant, routed server surface, required visible capability, chosen task skill, and any unresolved ambiguity.
EDT-MCP translation workflow
Purpose and trigger
Use this skill to inspect configured translation resources, generate strings, run translation, and verify localized metadata for an exact project.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Keep the exact project, declared language codes, existing storage/provider topology, and localized human-facing fields in scope. Never translate programmatic metadata names, FQNs, BSL identifiers, query fields, or 1C tokens.
Primary workflow
- Resolve project identity/kind with
list_projects, declared languages withget_configuration_properties, and configured translation routes withget_translation_project_info. - Confirm the intended languages, project support, storage/provider scope, and write or external-service authority using current help.
- Call
generate_translation_stringsortranslate_configurationonly for the confirmed route and requested operation. Before readback or validation, wait under current help and a bounded caller-approved deadline untillist_projectsreports the exact project as ready; on expiry stop and report the operation as unsettled rather than treating its success status as model readiness. - Re-read representative localized metadata with
get_metadata_details, inspect the repository diff when applicable, and run targeted validation. - Report only identities, counts, status, and affected samples that current tool output actually confirms; successful execution is not proof of translation quality or complete coverage.
Authority rule
Storage/dictionary writes, overwrite, external provider transmission, and any route affecting multiple storages or projects require authority for that exact scope.
Stop rule
Stop on unsupported project kind, undeclared language, ambiguous or incomplete storage topology, unreviewed overwrite/transmission, or a need to change programmatic identifiers.
Completion signal
Return the exact project/languages/route, confirmed operation result, verified localized samples and diff/validation evidence, and explicit quality or completeness gaps.
EDT-MCP Workmate research
Purpose and trigger
Use this skill only when the user explicitly asks for Workmate research or an authorized second opinion on an exact 1C project question.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Keep one bounded subject-matter question, exact project/object identity, and requested answer mode in scope. Workmate is not a default implementation, Git, production-write, or proof route.
Primary workflow
- Check
get_server_status(workmateblock:installed,enabled,tokenConfigured,bridgeSessionReady,askWorkmateToolEnabled,status). Ifstatusisno_client_tokenordisabled, direct the user to obtain an access key athttps://code.1c.ai/and configure it in 1C:EDT (Window -> Preferences -> 1C:Workmate / 1С:Напарник). IfaskWorkmateToolEnabledisfalse, reveal theworkmatetoolset viaenable_toolset(["workmate"])or ask the user to enableask_workmateinWindow -> Preferences -> MCP Server. - Resolve the project and inspect
get_tool_guideforask_workmate. - Treat
projectNameas Workmate context, not an authorization or isolation boundary. For a bridge/tool-capable call that could write, require a proven filtered/read-only capability set or actual filesystem/process containment limited to every authorized project and file target; a one-project EDT workspace is not containment. Otherwise do not delegate mutations and stop for authority or containment. - Submit one
ask_workmaterequest with the resolved exactprojectNameand retain its returned job identity; do not omit the project and fall back to Workmate's default context. - Poll only that job with
get_job_status; do not duplicate a committed request to discover progress or recover from ambiguity. - Verify target identity and load-bearing claims with direct read-only EDT-MCP evidence before using the answer.
Authority rule
External model contact, shared write-capable tools, project mutations, and any retry after uncertain dispatch require the relevant user authority. A read-only prompt alone is not an enforcement boundary.
Stop rule
Stop when Workmate is unavailable, compatibility or target identity is unclear, completion is unconfirmed, unexpected writes appear, or the next step needs new material authorization.
Completion signal
Return the exact question/target, confirmed Workmate final state, directly verified claims, unresolved uncertainty, and any detected project effects.
EDT-MCP YAXUnit
Purpose and trigger
Use this skill to discover, run, debug, poll, or cancel the narrowest useful YAXUnit selection on an exact authorized test application.
Operating rule
Read and apply the common operating rules before this workflow.
Task boundary
Resolve one exact launch configuration or project/application, YAXUnit engine, test extension, and intended selector. This skill is not for generic UI/E2E tests or an unidentified/shared production infobase.
Selector contract
Resolve the exact filter before starting a run; do not guess test method names.
- To run a whole test module, use
modules=ModuleNameand omittests. - To run an individual test, use
tests=ModuleName.MethodNameexactly as required by the currentrun_yaxunit_testscontract. - Never pass only a module name or only a method name in
tests. - Use
extensionsandtagsonly for their documented filter families; do not invent module wildcards or encode one filter family inside another. - After an invalid selector, zero-test result, or missing-report outcome, do not blindly repeat the same invocation. Re-check current help and the actual test registration/source, correct the selector, then start one clean run.
- Completion evidence must record the exact filters that were actually sent.
Primary workflow
- Resolve the target with
list_configurationsorget_applications, consult currentrun_yaxunit_testshelp, and configure credentials withset_infobase_credentialsonly when authorized and required. - Select at least one intended test, module, extension, or tag; settle update,
external-change, launch, disclosure, and dependency scope before execution.
With
updateBeforeLaunch=true, pass an explicitupdateScopeofconfigurationor exactextension:<ProjectName>targets; useallonly when every dependent extension is intentionally included and authorized. Obtain authority for every affected project/application launch and project Attach launch; otherwise use a proven no-sweep route or stop. - Call
run_yaxunit_testswith the resolved update values. If pending, retain its job ID and poll only that job withget_job_status; never rerun merely to check status. If a caller-approved deadline expires while that job remains live or unresolved, do not abandon ownership: continue reconciliation, cancel only with authorization and confirm a terminal state, or obtain an explicit accepted handoff of the retainedjobIdand all task-owned breakpoint/launch cleanup obligations. - For a completed normal run, require at least one intended test to have executed. Treat zero executed tests as inconclusive unless an empty selection was explicitly requested.
- For debugging, first prove the intended debug target can remain unambiguous
under current help. Then use
set_breakpoint-> debug-moderun_yaxunit_tests->wait_for_break-> bounded inspection ->resumeandremove_breakpoint. After the run or any target race, calldebug_statusand resume every uniquely attributable task-caused suspension before removing the task breakpoint; never resume an unrelated or ambiguously owned target. Useterminate_launchonly for a uniquely identified, task-owned launch whose termination is authorized. - Use
cancel_jobonly for the retained running job and follow its current preview, confirmation, and final-state contract.
Authority rule
Infobase update/restructure, dependency scope, credentials, existing-launch termination, sensitive-data disclosure, cancellation, and cleanup termination require authority for the exact target and effect.
Stop rule
Stop on ambiguous application/debug target or selector, absent engine/test extension, missing update/launch authority, or unsafe shared target only after any retained job is terminal or its ownership and task-owned cleanup obligations have been explicitly handed off. A known unresolved job is not, by itself, a safe stop condition.
Completion signal
For a normal run, report exact target/selector, executed totals, failures, report/job evidence, and update effects. For debug-only work, report bounded frame evidence and cleanup without claiming pass/fail totals; include zero-test or other inconclusive states explicitly.
Роли, права доступа, RLS и границы чтения в 1С
Используй навык, когда создаётся новый объект метаданных, настраиваются полномочия роли, разбирается отказ по правам или пустая выборка у пользователя, сужаются избыточные административные права либо проверяется безопасный доступ только на чтение.
Для работы с серверным API подсистемы УправлениеДоступом БСП дополнительно сверяйся с картой подсистемы в навыке onec-bsp-api.
Отличай определение роли в метаданных от действующего доступа пользователя
Наличие роли в дереве конфигурации не означает, что конкретный пользователь реально получил разрешение на строку данных. Итоговый доступ складывается из четырёх независимых уровней:
- Глобальные и базовые системные права роли — у неадминистративных ролей обязательно сбрасывай флаг
УстанавливатьПраваДляНовыхОбъектови учитывайНезависимыеПраваПодчиненныхОбъектов. При создании новой базовой роли пользователя не забывай системные права запуска клиента (ТонкийКлиент,ВебКлиент,СохранениеДанныхПользователя,Вывод— если пользователю разрешены печать и копирование), никогда не выдаваяАдминистрирование,АдминистрированиеДанныхиРежимВсеФункции. - Функциональные права роли на объект и реквизиты — раздельно проверяй пары:
Чтение(программный доступ и запросыРАЗРЕШЕННЫЕ) иПросмотр(интерактивное открытие списка и формы);Добавление/Изменение(серверная запись) иИнтерактивноеДобавление/ИнтерактивноеИзменение(доступность команд создания и редактирования в клиенте);Проведение,ОтменаПроведения,ИнтерактивнаяПометкаУдаленияи никогда не выдаваемое рядовым ролямИнтерактивноеУдаление/Удаление;- для нового объекта не забывай право
Использованиена основную форму, команды и родительскую подсистему (Просмотр), иначе объект останется невидимым в интерфейсе даже при наличииЧтение.
- Ограничения доступа к данным на уровне записей (RLS) — условия и шаблоны
#Если ...в правахЧтение,Добавление,Изменение, зависящие от параметров сеанса и таблиц групп доступа БСП. Пиши условия RLS только по индексированным измерениям/реквизитам (Организация,Подразделение,Склад), без вызова функций над полями, ведущих%вПОДОБНОи многоступенчатых разыменований через точку: условие RLS добавляется к каждому запросу роли и при тяжёлом шаблоне обрушивает скорость списков и отчётов. - Назначение пользователю в ИБ — через профили групп доступа и группы доступа БСП (с заполненными разрезами организаций, подразделений, складов, партнёров) и рассчитанные таблицы сведений доступа.
Видимость на форме не заменяет серверную защиту
- Скрытие кнопки или отключение доступности поля в модуле управляемой формы (
Элементы.Провести.Видимость = Ложь) — это удобство интерфейса, а не ограничение безопасности: пользователь или обработка по-прежнему может выполнить команду через другой список, групповое изменение, OData или внешний вызов, если право разрешено в роли. - Обязательные ограничения доступа обеспечиваются ролями метаданных, RLS и серверными проверками в модуле объекта / менеджера / HTTP-сервиса. И наоборот: использование
УстановитьПривилегированныйРежим(Истина)допустимо только на минимальном служебном участке после явной проверки прав вызывающего пользователя на бизнес-операцию и никогда не должно возвращать наружу неотфильтрованные чужие записи.
Диагностика «Недостаточно прав» и «пропавших» строк
- Сравни проблемного пользователя с контрольным (не с «Полными правами», а с коллегой нужной рабочей должности): выпиши различия их групп доступа, профилей и значений разрезов доступа (Организация, Подразделение, Склад).
- Раздели ошибку права на метаданные и отсечение RLS:
- Исключение нарушения прав доступа при открытии или записи указывает на отсутствующее право роли на конкретный объект/реквизит (включая связанный справочник, регистр сведений или последовательность, к которым обращается подписка при проведении) либо на срабатывание ограничения RLS
Добавление/Изменениепо незаполненному разрезу документа. - Тихое исчезновение строк в списке или отчёте с
ВЫБРАТЬ РАЗРЕШЕННЫЕуказывает на фильтр RLSЧтениеили неучтённоеNULL/пустое значение разреза в условии шаблона ограничения.
- Исключение нарушения прав доступа при открытии или записи указывает на отсутствующее право роли на конкретный объект/реквизит (включая связанный справочник, регистр сведений или последовательность, к которым обращается подписка при проведении) либо на срабатывание ограничения RLS
- При проектировании новой роли с шаблонами RLS БСП проверь расширение шаблона для конкретного вида метаданных в
edt-mcpи убедись, что объект включён в соответствующие определяемые типы владельцев/значений доступа, если этого требует архитектура конфигурации.
Граница только на чтение (Read-Only Boundary)
При настройке учётной записи для аналитики, внешней витрины, OData-интеграции или диагностического подключения:
- Создавай выделенную минимальную роль без
Добавление,Изменение,Проведение,Администрирование,Конфигуратор,РежимВсеФункциии без доступа к регистрам секретов, персональных данных и токенов интеграций. - Проверяй границу на тестовой базе прямыми запросами не только на успешное чтение разрешённых сущностей, но и на гарантированный отказ при попытке
POST/PATCH/DELETEчерез OData, вызова команд проведения и чтения закрытых справочников/регистров.
Парный инструментальный навык EDT-MCP
- Для чтения и безопасного изменения ролей, прав и шаблонов RLS в открытом проекте EDT применяй в паре
edt-mcp-project-metadata.
Выбор API и точек расширения БСП
Используй навык, когда решение задачи зависит от Библиотеки стандартных подсистем 1С: выбор общего модуля или метода, вызов на клиенте/сервере, расширение поведения, проверка устойчивости API.
Навык описывает предметные различия. Состояние конфигурации и структурированные изменения выполняются через EDT MCP и соответствующие предметные навыки.
Сначала установи версию и наличие БСП
БСП не предполагай по наличию BSL-кода, общих модулей или сходству имён. Установи точный проект EDT и доступные сведения о конфигурации. Если модель EDT не подтверждает наличие и версию БСП, скажи, что вызов не проверен для этого проекта. Не переключайся на XML-выгрузку после отказа EDT; это отдельный источник фактов, допустимый только когда пользователь явно выбрал такую выгрузку.
Подробности ниже подтверждены для БСП 3.1.11. Для другой версии используй их только как карту понятий: имя модуля, сигнатуру, регион, свойства общего модуля и совместимость сверяй с исходниками или документацией именно этой версии. Не показывай пример 3.1.11 как проверенный вызов иной версии.
Выбери подсистему и полный модуль
Поставка библиотеки — ещё не прикладная база
При подготовке нового стенда отличай исходники поставки БСП от конфигурации, в которую БСП уже внедрена. Успешная загрузка XML или расширения не подтверждает запуск приложения. Сообщение «Файл поставки ... не предназначен для создания информационных баз по шаблону» означает отсутствие регистрации прикладной конфигурации, а не запрос доверия внешней обработке. Не повторяй запуск и не отключай эту проверку. Используй предусмотренную версией точку ПодсистемыКонфигурацииПереопределяемый.ПриДобавленииПодсистем: зарегистрируй серверный модуль приложения с его именем, версией, зависимостью от БСП и обработчиками обновления. После подключения выполни штатное начальное заполнение. Проверки совместимости БСП сохраняй.
У общих модулей БСП нет общего префикса БСП_. Имя обычно связано с предметной подсистемой: например, УправлениеПечатью, Пользователи, АдресныйКлассификатор. Найди модуль по назначению подсистемы, затем укажи его полное имя. Не придумывай варианты по аналогии.
Суффиксы помогают понять назначение модуля, но окончательную конфигурацию задают свойства самого общего модуля:
| Признак | Значение |
|---|---|
| без суффикса | Обычно серверный контекст |
| Клиент | Клиентский код |
| КлиентСервер | Общий код клиента и сервера; не обращается напрямую к базе |
| ВызовСервера | Серверный модуль, метод которого может вызвать клиент; исполнение остаётся на сервере и вне контекста формы |
| Служебный | Внутренний API; совместимость не гарантируется |
| ПовтИсп | Кэширование возвращаемого значения; длительность определяется свойством модуля |
| Переопределяемый | Точка расширения: БСП вызывает метод, прикладная конфигурация реализует его |
| Глобальный | Доступность по короткому имени; контекст исполнения всё равно определяется свойствами модуля |
| РФ, Локализация | Региональный или языковой вариант |
Суффиксы могут сочетаться. Инициатор вызова и место исполнения — разные факты: ВызовСервера не означает клиентское исполнение. Не считай Экспорт или разрешение серверного вызова доказательством стабильности.
Определи, что именно перед тобой
Проверяй регион метода и роль модуля отдельно:
| Регион | Прикладное использование |
|---|---|
| ПрограммныйИнтерфейс | Основной публичный API; стабильность заявляй только для подтверждённой версии БСП |
| СлужебныйПрограммныйИнтерфейс | Служебный API, обратная совместимость не гарантируется; выбирай лишь при отсутствии публичного аналога и отмечай риск |
| СлужебныеПроцедурыИФункции | Внутренняя реализация, не вызывай из прикладного кода |
| УстаревшиеПроцедурыИФункции | Устаревший API; для нового кода ищи публичную замену |
| прочие внутренние регионы | Не считай прикладным API без явного подтверждения назначения |
Модуль Переопределяемый — не обычная библиотека функций. БСП вызывает описанный в нём хук; прикладной код реализует его в своей конфигурации по правилам этой версии. Не предлагай вызвать такой метод как Модуль.Метод(...). Это остаётся хуком, даже если регион называется ПрограммныйИнтерфейс: регион и роль — независимые классификации.
Не принимай похожее имя за факт
Для БСП 3.1.11 проверены частые ошибки:
- ОбщегоНазначенияСлужебный без дополнительного суффикса отсутствует; встречаются ОбщегоНазначенияСлужебныйКлиент и ОбщегоНазначенияСлужебныйКлиентСервер.
- РегламентныеЗадания — подсистема, а не общий модуль; серверный общий модуль называется РегламентныеЗаданияСервер.
- БизнесПроцессыИЗадачи без суффикса отсутствует; серверный модуль — БизнесПроцессыИЗадачиСервер.
- БезопасноеХранилище — не общий модуль; в БСП 3.1.11 это регистр БезопасноеХранилищеДанных, работа с которым выполняется через публичные методы общего модуля ОбщегоНазначения.
Используй эти примеры только в границе версии 3.1.11. При другой версии перепроверь каждый факт.
Карты подсистем
Если задача касается одной из подсистем ниже, открой её карту до выбора метода. Карта называет реальные модули, отсутствующие имена и ловушки; она не заменяет проверку сигнатуры в модели EDT.
- Бизнес-процессы и задачи исполнителей: принятие, перенаправление, адресация задачи, форма выполнения.
- Пользователи и управление доступом: пользователь сеанса, роли, RLS, права на объект.
- Фоновые операции и регламентные задания: работа из формы в фоне, обработчик и управление регламентным заданием.
- Дубли, замена ссылок и групповое изменение: поиск дублей, стабильная замена ссылок, связанные документы.
- Контактная информация и адреса: хранение, чтение, запись и сравнение адресов.
- Запрет редактирования, свойства и даты запрета: защита реквизитов, дополнительные реквизиты, закрытый период.
- Обновление версии ИБ и конфигурации: обработчики миграции, запись без бизнес-логики, версии подсистем, блокировка формы.
- Присоединённые файлы, печать, общие модули и безопасное хранилище: тома файлов, пакетное чтение реквизитов, сообщения у поля, хранение секретов.
- ЭП и МЧД, защита ПДн, обмен данными, области данных и локализация БСП: криптография, 152-ФЗ, планы обмена БСП, префиксы/разделители, НСтр.
Регистрация основной прикладной конфигурации должна находиться в основной конфигурации, а не только в расширении. В БСП 3.1.12 обновление параметров работы программы запускается с БезРасширений = Истина; регистрация из расширения может пройти интерактивный старт, но исчезнуть в фоновом начальном заполнении. Не отключай этот режим фоновой операции ради обхода ошибки. Проверяй завершение начального заполнения, а не только появление рабочего стола или индикатора прогресса.
Если журнал сообщает «расширение модуля запрещено ... подключено в безопасном режиме», перехват не исполнялся. Настройка свойств расширения после обычного старта не поможет, если старт падает раньше. Для разрешённой служебной настройки используй предусмотренный БСП режим ОтключитьЛогикуНачалаРаботыСистемы, получи результат изменения свойств от обработчика, затем верни обычный запуск. Служебный режим не является готовым пользовательским результатом и не заменяет регистрацию основной конфигурации.
Перед ответом или предложением изменения
При подключении истории изменений в БСП 3.1.12 проверь оба определяемых типа:
ссылочный ВерсионируемыеДанные и объектный ВерсионируемыеДанныеОбъект.
Подписка ЗаписатьВерсиюОбъекта получает источник из объектного типа.
Настройка версионирования и доступная кнопка истории сами по себе не доказывают,
что запись версий подключена. Выполни реальные изменения реквизитов под именованным
пользователем и проверь версии, автора и время в штатной истории. Пустая открытая
форма не является успешным результатом. Учитывай, что история появляется после
подключения механизма, а не восстанавливает прежние изменения задним числом.
- Зафиксируй проект, наличие и версию БСП по доступным фактам.
- Назови полное имя модуля и метод; укажи контекст исполнения и объясни, кто вызывает код — приложение или сама БСП.
- Различи стабильный публичный вызов, служебный/устаревший метод, внутреннюю процедуру и хук. Не выводи статус API только из Экспорт.
- Если метод, версия, регион или свойства модуля не подтверждены, обозначь конкретный неизвестный факт и не выдавай предполагаемую сигнатуру за проверенную.
- Для хука опиши, где приложение реализует расширение; не давай пример прямого вызова.
- Если проект доступен через EDT MCP, прочитай фактический прикладной обработчик и форму сам. Не проси пользователя прислать доступный код и не подменяй исследование конкретного объекта общими советами или предполагаемой сигнатурой.
Существующая EDT-модель — источник фактов для выбранного проекта. Используй только штатные возможности и руководства edt-mcp. Не добавляй отдельный экспортный парсер, CLI, исполнитель, hook или маршрут задачи в этот навык.
Что затронет изменение решения
Я как аналитик 1С хочу добавить новое поведение и сохранить уже работающие операции, чтобы получить развитие решения без незаметного изменения учёта.
От потребности к границе изменения
Установи роль, действие и наблюдаемый результат. Раздели новое требование и неизменяемые условия: единицы хранения, уже выполненные операции, закрытые периоды, документ-основание, согласованные правила расчёта. Не превращай пожелание о новом поведении в выдуманный дефект и не ограничивай результат перечнем найденных файлов. Учитывай уже данное разрешение на реализацию.
Исследуй подтверждённую основную конфигурацию и применяемые расширения через доступные инструменты. Проследи конкретную цепочку: пользовательская команда → обработчик → общий метод → запись/движение → потребитель данных. Для каждого звена укажи найденный объект или метод и его роль в требовании.
Три разных вида зависимости
- Декларативная: тип реквизита, измерение регистра, состав формы. Принадлежность одной подсистеме не означает вызов; диаграмма метаданных не доказывает запись.
- Исполняемая: вызов процедуры, запрос, обработка проведения, подписка на событие. Для регистра найди все источники записи, включая наборы записей без регистратора.
- Динамическая: строковое имя команды, оповещение, настройка обмена, публичный API, внешняя обработка. Нулевой результат статического поиска не исключает использование.
Помечай неподтверждённые связи как предположения. Не заявляй полноту по частичной выгрузке или нескольким найденным модулям. Проверяй только неопределённость, которая может изменить решение; не запускай повторное исследование без причины.
Новое представление или новая модель
Сортировка и отбор изменяют представление, но не должны перепроводить документы или перераспределять ресурсы. Отдельно проверь общий итог и итог выбранного среза.
Для единиц измерения явно задай направление пересчёта и место округления. До предложения формулы прочитай производителя и потребителя каждого операнда: количество документа уже может хранить штуки, а потребность регистра — итоговую норму на весь заказ. Название поля не доказывает единицу. Зафиксируй смысл каждого множителя по коду. Умножение готового итога повторно на количество или коэффициент упаковки недопустимо. При неизвестной единице сначала установи её, не придумывай расчёт. Различай единицу заказа, хранения, расчёта потребности и печати; не меняй хранимое количество только ради удобной подписи. Проверяй частичную обработку, неполную упаковку и сохранность уже выполненной части.
Новая аналитика меняет ключ записи, группировку и итог. Установи значение для существующих данных и поведение пустого значения. Не распределяй старые записи по новым разрезам без основания. Если требуется переход, сделай повтор команды безопасным и проверь сохранность количества и связей.
Реализация и проверяемый результат
В разрешённом объёме измени нужные звенья цепочки, а не все найденные объекты. Подходящие навыки формы, СКД, расширения и тестирования выбирай по выявленной задаче. Сохрани стандартные механизмы, где они покрывают потребность.
Проверка вспомогательной функции не заменяет выполнение вызывающей команды. Проверь новое действие и один существенный сохраняемый сценарий: результат виден человеку, запись сохраняется, повтор не искажает данные. Отдельно сообщай вывод из исходников, выполненное изменение и фактический результат проверки. Не объявляй тест пройденным по наличию feature-файла или фонового запуска.
Итог для аналитика: что стало возможно, какие связанные операции затронуты, что осталось неизменным и чем это подтверждено. Полезные артефакты — рабочая форма или отчёт, краткая карта подтверждённых связей и результат проверки.
Развитие существующего поведения
При разрешённой доработке анализ влияния обслуживает новую возможность, а не становится самостоятельным аудитом. Назови добавленное действие роли и уже существующую договорённость, которую требуется сохранить. Например, новые коммерческие условия действуют на новые заказы, а согласованный заказ содержит собственный снимок. Подтверждение сохранности относится к этому поведению, а не заменяет его демонстрацией тестового инструмента.
Дополнительная памятка
Двухпроходное ревью кода 1С и предкоммитный контроль качества
Используй навык, когда пользователь просит провести ревью модуля, запроса, расширения или набора изменений (PR / MR / diff), а также как финальный контур самопроверки перед сдачей собственной доработки 1С.
Проход 1 (Аудитор) → Проход 2 (Критик по модели EDT)
Никогда не выдавай список замечаний по первому впечатлению от изолированного фрагмента текста. Работай строго в два прохода:
- Проход Аудитора — собери кандидатов в дефекты по приоритету: искажение учёта и данных → гонки и транзакции → права и безопасность → производительность (
N+1, тяжёлые запросы, клиент-сервер) → совместимость с веб-клиентом и расширениями → стандарты оформления модулей. - Проход Критика (самофальсификация через
edt-mcp) — перед включением любого замечания в отчёт попытайся опровергнуть его фактами проекта:- Прежде чем писать «нет
РАЗРЕШЕННЫЕ», проверь свойства общего модуля: если модульПривилегированныйили вызывается внутри системного пересчёта с намеренным полным охватом,РАЗРЕШЕННЫЕтам было бы ошибкой! - Прежде чем писать «запрос или серверный вызов в цикле», проверь источник коллекции: обход фиксированного перечня из 2–3 видов учёта и обход табличной части товаров документа на 1 000 строк имеют разную критичность; проверь также, не является ли вызываемый общий модуль кэшируемым (
ПовтИсп). - Прежде чем объявлять реквизит несуществующим или метод неиспользуемым, проверь базовую конфигурацию вместе с проектами расширений, определяемыми типами и подписками на события в
edt-mcp.
- Прежде чем писать «нет
Отбрасывай неподтверждённые догадки и вкусовщину; оставляй только верифицированные замечания с точной строкой, объяснением последствия и конкретным вариантом исправления.
Ключевые измерения стандартов разработки 1С
1. Распределение логики и директивы компиляции
- Прикладные расчёты, проверки инвариантов и запись данных размещаются в модуле объекта, модуле менеджера или серверном общем модуле, а не в модуле управляемой формы.
- В модуле формы предпочитай
&НаСервереБезКонтекста(или вызов серверного общего модуля с флагомВызовСервера), передавая только нужные примитивы и ссылки; контекстный&НаСервереоставляй только там, где реально меняется дерево элементов или реквизитОбъектформы. - Обращение к базе данных, объектным типам (
ДокументОбъект,СправочникОбъект) и запросам в процедурах&НаКлиентенедопустимо.
2. Современный асинхронный клиент вместо модальных вызовов
- Устаревшие синхронные методы
Вопрос(),Предупреждение(),ВвестиСтроку(),ВвестиЧисло(),ОткрытьФормуМодально()блокируют поток браузера и запрещены в современном управляемом и веб-клиенте. - На платформе 8.3.18+ предпочтителен линейный стиль
Асинх/Ждать(ВопросАсинх,ПредупреждениеАсинх,ОткрытьФормуАсинх); на более ранних режимах совместимости — неблокирующие методыПоказатьВопрос/ОткрытьФормусОписаниеОповещения(сверь режим совместимости конфигурации вget_configuration_properties!). Не ставьАсинхна серверные процедуры.
3. Структура модуля, именование, локализация и обработка исключений
- Соблюдай стандартный порядок областей
#Область ... #КонецОбласти(в общих и объектных модулях:ПрограммныйИнтерфейс→СлужебныйПрограммныйИнтерфейс→ОбработчикиСобытий→СлужебныеПроцедурыИФункции; в модулях форм: события формы → события элементов шапки → события таблиц → команды формы → служебные процедуры). - Заменяй «магические» коды, строки статусов и зашитые УИД на перечисления, предопределённые элементы и константы. Избегай
Выполнить()иВычислить()на динамических строках. - Все выводимые пользователю сообщения и заголовки оборачивай в
НСтр(...)на языках конфигурации. - Пустой блок
Исключение ... КонецПопыткизапрещён: при перехвате сбоя откати открытую транзакцию (Если ТранзакцияАктивна() Тогда ОтменитьТранзакцию()), запиши техническую деталь черезЗаписьЖурналаРегистрации(..., ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()))и верни пользователю понятный предметный отказ без SQL и внутренних путей.
Двухэтапная проверка перед сдачей доработки (Статика + Проба ИБ)
Не ограничивай самопроверку одним чтением собственного диффа:
- Этап 1 — Быстрая статика в
edt-mcp(без запуска 1С): перечитай изменённые методы и метаданные, прогониvalidate_queryдля всех затронутых запросов/СКД иget_project_errorsдля изменённых объектов базового проекта и расширения. - Этап 2 — Динамическая проба в тестовой копии ИБ (
vanessa-runner): статика не ловит ошибки обновления таблиц СУБД, конфликт применения расширения.cfe, отсутствие прав у рабочей роли и ошибку типа в табличной части формы. Загрузи изменения в копию базы, обнови конфигурацию БД и выполни целевой сценарий под рабочей ролью (а не только под «Полными правами»).
Обзор конфигурации
Вход: точный проект, формат исходника и границы исследования. Выбрать интерфейс по формату ДО исполнения: это разные источники фактов.
- Проект 1С:EDT: нативный обзор через edt-mcp. Исследовать текущую модель EDT; экспорт для этого не требуется.
- Явно выбранная выгрузка Конфигуратора: обзор Configuration.xml. Результат относится к прочитанному файлу, не к состоянию EDT или базы.
Не переключаться на другой источник после отказа. Не подменять текущую модель исторической выгрузкой. Для сравнения требуется отдельное задание с обеими идентичностями и подтверждённой связью версий.
Собрать идентичность, свойства, состав по типам и ограничения полноты. Материалы проекта сохранять в журнале своей операции хоста. Совпадение имён или счётчиков не доказывает совпадение версий либо корректность. Не выводить право изменения или состояние поддержки из отсутствия данных.
Ошибка чтения, неоднозначный проект, неполный ответ или недоступный инструмент фиксируются как отказ либо явно ограниченное наблюдение. Навык описывает предметное исследование. Следующий этап, повтор и приёмка определяются задачей и процессом разработки; инструменты принадлежат соответствующим MCP-серверам.
Хранилище конфигурации 1С и гибридный процесс с Git / EDT
Используй этот навык, когда проект конфигурации или расширения подключён к Хранилищу конфигурации 1С (напрямую в Конфигураторе, через пакетный CLI 1cv8 DESIGNER или в гибридной связке с Git и 1С:EDT).
1. Главные инварианты безопасности
- Никогда не выполняй
/ConfigurationRepositoryUnbindCfgбез прямого письменного поручения человека. Отключение рабочей базы от хранилища разрушает историю захватов и блокирует штатное помещение правок. - Нулевой код возврата
1cv8не доказывает успех операции с хранилищем. Всегда передавай/Out <лог> -NoTruncateи проверяй текст лога на сообщения о блокировках, несовпадении версий, отсутствующих правах пользователя хранилища и ошибках объединения. - Основная конфигурация и каждое расширение (
-Extension <Имя>) имеют собственные независимые хранилища. Не смешивай параметры подключения хранилища основной конфигурации и расширения. - Не правь на диске незахваченные объекты в общей базе разработки. Если объект не захвачен в хранилище до начала правок, параллельное помещение от другого разработчика приведёт к перезаписи чужого кода при полной загрузке.
2. Строгий протокол изменения объекта через Хранилище
При работе через файловую выгрузку (DumpConfigToFiles / LoadConfigFromFiles) соблюдай неизменную последовательность из 6 шагов:
- Актуализация базы из хранилища (
ConfigurationRepositoryUpdateCfg):- Перед захватом обнови конфигурацию рабочей ИБ до актуальной ревизии хранилища, чтобы видеть последние версии связанных метаданных и сигнатур общих модулей.
- Захват целевых объектов (
ConfigurationRepositoryLockObjects):- Захватывай минимально необходимый перечень объектов по точному списку (не захватывай всю конфигурацию рекурсивно без необходимости).
- Добавление нового объекта верхнего уровня (новый справочник, документ, общий модуль, роль, подсистема) требует захвата корня
Configuration(и затрагиваемых подсистем, если объект включается в их составContent). - Добавление вложенного элемента (реквизита, табличной части, формы, макета, команды существующего объекта) требует захвата объекта-владельца (или конкретной подчинённой формы/макета, если меняется только она).
- Обязательная перевыгрузка захваченных объектов на диск (
DumpConfigToFiles -update/ частичная выгрузка):- Между прошлым обновлением Git-ветки и моментом захвата коллега мог поместить в хранилище новую версию этого же объекта. Если пропустить перевыгрузку после
LockObjectsи загрузить старый файл с диска, ты тихо сотрёшь чужие изменения!
- Между прошлым обновлением Git-ветки и моментом захвата коллега мог поместить в хранилище новую версию этого же объекта. Если пропустить перевыгрузку после
- Внесение точечных изменений и проверка гигиены файлов:
- В выгрузке Конфигуратора сохраняй
UTF-8 с BOMдля.bslв каталогахExt/, не трогай вручную служебныйConfigDumpInfo.xmlи бинарныйParentConfigurations.bin.
- В выгрузке Конфигуратора сохраняй
- Частичная загрузка и проверка (
LoadConfigFromFiles -files .../-listFile ...→CheckConfig/UpdateDBCfg):- Загружай только изменённые файлы, а не весь каталог конфигурации целиком.
- Перед помещением в хранилище выполни синтаксический контроль и убедись, что конфигурация БД обновляется без потери данных и битых ссылок в ролях/подсистемах/подписках.
- Помещение в хранилище (
ConfigurationRepositoryCommitObjects) с осмысленным комментарием:- Передавай явный комментарий задачи/тикета и список помещаемых объектов. Если правка отменена — освободи объекты через
ConfigurationRepositoryUnlockObjectsс повторным обновлением конфигурации из хранилища.
- Передавай явный комментарий задачи/тикета и список помещаемых объектов. Если правка отменена — освободи объекты через
3. Гибридный контур Хранилище 1С ↔ Git ↔ 1С:EDT
Во многих командах Хранилище 1С остаётся мастер-источником поставки, а Git и 1С:EDT используются для код-ревью, статического анализа и прогона тестов:
| Сценарий | Правило согласования |
|---|---|
| Хранилище → Git (зеркалирование ревизий) | Синхронизатор выгружает ревизии хранилища в служебную ветку (storage-sync) с автором и номером версии хранилища. Агент не редактирует ветку зеркала напрямую. |
| Git / EDT → Хранилище (перенос одобренного PR) | Конвертация EDT ↔ XML Конфигуратора (ring edt workspace export / импорт) может менять порядок узлов XML и форматирование. Переноси в хранилище только список реально затронутых задачей объектов, сверив diff модулей и реквизитов после экспорта. |
Конфликт ConfigDumpInfo.xml | В Git-ветках файл ConfigDumpInfo.xml часто даёт конфликты слияния версий объектов. Не склеивай его вручную построчно: используй частичную загрузку по явному списку файлов (-files / -listFile) либо переформируй индекс штатной выгрузкой Конфигуратора. |
| Объекты типовой конфигурации на поддержке | Если объект находится на замке поставщика («Объект поставщика не редактируется»), захват в хранилище сам по себе не снимает правила поддержки. Сначала согласуй с архитектором перенос доработки в расширение (CFE) — см. onec-extension-change. |
4. Типовые аварии и диагностика
- «Объект уже захвачен пользователем ...»: не пытайся обойти блокировку прямой правкой локальной ИБ. Сообщи имя захватившего пользователя из лога
/Outи предложи дождаться помещения либо разделить точку расширения (подписка на событие, собственный общий модуль, расширение). - Сирота в составе подсистемы или роли после частичного помещения: разработчик поместил новый справочник, но забыл захватить и поместить
Configuration/Subsystem/Role(или наоборот — поместил ссылку в подсистеме без самого объекта). Всегда помещай объект и его регистрацию вConfiguration/ подсистемах / базовых ролях атомарным набором в одной ревизии хранилища. - Сброс кэша хранилища в рабочей ИБ: при повреждении локального кэша хранилища в каталоге базы проверяй целостность через копию ИБ, не отвязывая боевую сборочную базу без резервной выгрузки
.cfи списка захваченных объектов.
Связанные навыки
- Доработка расширений вместо снятия типовой конфигурации с поддержки:
onec-extension-change - Сборка внешних обработок, расширений и версий формата выгрузки:
onec-external-processors-and-delivery - Работа с моделью проекта 1С:EDT через MCP:
edt-mcp-project-maintenance
Конвертация данных 1С: КД 2 и КД 3 (EnterpriseData)
Используй этот навык, когда обмен строится на правилах конвертации данных КД 2 (XML-правила ПВД / ПКО / ПКС) или на универсальном формате EnterpriseData (КД 3.1 + подсистема обмена БСП). Для транспортного уровня (HTTP/OData/файловые каналы и регистрация планов обмена) сочетай его с onec-integration-and-exchange.
1. Сначала установи технологию обмена в проекте
В реальных базах 1С параллельно живут оба поколения конвертации — не угадывай архитектуру без проверки метаданных и макетов:
| Признак в исходниках | Поколение | Где лежит логика |
|---|---|---|
Макет ПравилаОбмена (XML с тегами <ПравилаОбмена>, <ПКО>, <ПКС>, <ПВД>), обработка УниверсальныйОбменДаннымиXML или КонвертацияОбъектовИнформационныхБаз | КД 2 (2.1) | XML-файл правил + вызовы из подсистемы обмена БСП (ОбменДаннымиСервер) |
Пакеты XDTO EnterpriseData_*, общий модуль менеджера обмена (ОбменДаннымиXDTOСервер, МенеджерОбменаЧерезУниверсальныйФормат), процедуры ПриОтправкеДанныхПотребителю / ПриПолученииДанныхОтКорреспондента | КД 3 / EnterpriseData | BSL-код общего модуля менеджера обмена внутри самой конфигурации (или расширения) |
2. Инварианты и ловушки КД 2 (XML-правила ПВД / ПКО / ПКС)
Поиск объектов и защита от дублей / затирания НСИ
- Поиск по внутреннему УИД vs по полям поиска:
- Если
ИскатьОбъектПриЗагрузкеПоВнутреннемуИдентификаторувключён, но базы создавались независимо (не распределённая ИБ и без первичной синхронизации УИД), одинаковая номенклатура или контрагент имеют разныеУникальныйИдентификатор(). Задай детерминированные поля поиска (ИНН+КППдля юрлиц,Артикул/Код/ внешний ключ сопоставления) и порядок вариантов поиска (НомерВариантаПоиска). - Никогда не используй одно только
Наименованиекак единственное поле поиска для справочников с омонимами или редактируемыми названиями.
- Если
- Классическая авария КД 2 — затирание существующего справочника при выгрузке по ссылке:
- Когда документ выгружает контрагента или номенклатуру по ссылке с урезанным набором ПКС (только поля поиска), а флаг ПКО «Не замещать существующие объекты при загрузке» (
НеЗамещать) выключен, приёмник находит карточку НСИ и обнуляет непереданные реквизиты или табличные части! - Разделяй полное ПКО для прямой выгрузки НСИ и ссылочное ПКО (
СвойстваПоиска+ запрет перезаписи существующего объекта при загрузке по ссылке) либо включайНеЗамещатьдля ссылочной синхронизации.
- Когда документ выгружает контрагента или номенклатуру по ссылке с урезанным набором ПКС (только поля поиска), а флаг ПКО «Не замещать существующие объекты при загрузке» (
Порядок обработчиков событий КД 2 и передача данных
Не путай контекст переменных на стороне источника и приёмника:
| Этап | Событие | Ключевые переменные и ограничения |
|---|---|---|
| Выгрузка выборки | ПВД.ПередОбработкой / ПриВыгрузке | Формирование ВыборкаДанных или обход коллекции; для каждого элемента вызывается ВыгрузитьПоПравилу(Источник, , ВходящиеДанные, , ИмяПКО). |
| Выгрузка объекта | ПКО.ПередВыгрузкой | Доступен Источник, можно установить Отказ = Истина или подготовить ВходящиеДанные (Структура) для дочерних ПКС. |
| Выгрузка свойства | ПКС.ПередВыгрузкой / ПриВыгрузке | Если источник ПКС не совпадает с реквизитом Источника, заполняй Значение в ПриВыгрузке либо помечай получение из ВходящиеДанные. При пустом Источник и отсутствии кода ПКС не выгрузит ссылочный узел. |
| Загрузка в приёмнике | ПКО.ПриЗагрузке → ПослеЗагрузки | В ПриЗагрузке ссылка нового объекта может ещё не быть записана в БД; заполнение зависимых регистров сведений или подчинённых объектов по ссылке выполняй в ПослеЗагрузки, когда Объект уже имеет Ссылка (или управляй ПараметрыОбъекта). |
- Передача служебных реквизитов между источником и приёмником: если в приёмнике нет прямого реквизита, передавай значение через параметр ПКС →
ПараметрыОбъекта(флаг передачи в параметр на ПКС), чтобы прочитать его вПКО.ПослеЗагрузкичерезПараметрыОбъекта["..."]. - Движения документов в КД 2: не выгружай одновременно и проведение документа в приёмнике, и его наборы записей регистров по тем же регистраторам без согласованного режима
РежимЗаписи = Запись— иначе проведение приёмника перезапишет загруженные движения или удвоит остатки.
3. Инварианты КД 3 и универсального формата EnterpriseData
В современном обмене БСП конвертация исполняется BSL-модулем менеджера обмена внутри конфигурации:
- Двустороннее соответствие версий формата (
1.x):- Проверь зарегистрированные версии формата в
ПолучитьВерсииФорматаОбменана обеих сторонах. Попытка заполнить свойство XDTO, появившееся в более старшей версииEnterpriseData, падает с ошибкой валидации схемы XDTO на этапе сериализации.
- Проверь зарегистрированные версии формата в
- Сопоставление ссылок (
СведенияОбОбъектахОбменаБСП/ регистрПубличныеИдентификаторыСинхронизируемыхОбъектов):- Не подменяй публичный идентификатор синхронизации случайным
Новый УникальныйИдентификатор()при каждой отправке — это плодит дубли при каждом повторном сеансе обмена.
- Не подменяй публичный идентификатор синхронизации случайным
- Идемпотентность повторной загрузки документа и табличных частей:
- При повторном приходе изменённого документа через
ПриПолученииДанныхОтКорреспондентаочищай и пересобирай перезаполняемые табличные части детерминированно, но сохраняй локальные реквизиты приёмника, которые не входят в составEnterpriseData(например, локального ответственного, комментарий склада или статус согласования в базе-приёмнике!).
- При повторном приходе изменённого документа через
- Даты запрета загрузки:
- Вызовы записи из обмена проходят через проверку дат запрета загрузки для конкретного
УзелОбмена(см.onec-bsp-api). Не отключайОбменДанными.Загрузка = Истинабез понимания последствий: этот признак одновременно управляет подписками БСП и повторной авторегистрацией изменений на узлах плана обмена (защита от «пинг-понга» бесконечной пересылки объекта туда-обратно).
- Вызовы записи из обмена проходят через проверку дат запрета загрузки для конкретного
4. Чеклист верификации правил обмена
- Первичная выгрузка + повторная выгрузка без изменений: повторный пакет того же объекта не должен создавать дубль справочника/документа, менять сумму/количество или перезатирать локальные поля приёмника.
- Ссылочная целостность на границе: новый элемент НСИ, впервые приехавший по ссылке внутри табличной части документа, корректно создаётся и при последующей полной выгрузке карточки НСИ обогащается, а не дублируется.
- Пометка удаления и отмена проведения: проверь оба перехода (
ПометкаУдаления = Истинаи снятие проведенияПроведен = Ложь) — в приёмнике движения регистратора должны очищаться, а не зависать «сиротами». - Пакетная проверка через EDT / ИБ: синтаксис модуля менеджера обмена проверяй через
edt-mcp-project-local-fix, а сквозной сценарий «выгрузка → загрузка → повторная загрузка» — на изолированных файловых базах черезvanessa-runner.
Проектирование и изменение СКД
Вход: утверждённая задача, проект EDT, владелец схемы, набор данных, вариант или настройки по умолчанию и критерии приёмки. Результат: карта зависимостей и предметное предложение владельцу EDT.
- Подтвердить проект и владельца через list_projects и get_metadata_details. Прочитать текущие схемы инструментов и get_tool_guide для dcs и validate_query. Для основного макета отчёта подтвердить свойство Main Data Composition Schema. Другая схема адресуется точным FQN макета. Работать через существующий edt-mcp; отсутствие возможности сообщить как явное ограничение. Прямой редактор .dcs/.mdo/Template.xml не вводить.
- Получить dcs(action="get", type="schema") для выбранного корня. По адресам ответа прочитать нужные наборы, параметры, ресурсы, вычисляемые поля, связи и варианты. Корневая сводка не доказывает полноту. Выбрать набор и вариант по сценарию; первый в списке не является целью. defaultSettings и settings именованного варианта — разные области.
- Получить полный запрос по отдельному адресу #/dataSets/<имя>/query, если он указан ответом. На страницах соблюдать единицы offset/limit, Next offset и hash; читать до конца. Извлечь именно текст запроса из оформленного ответа, исключив Markdown-обрамление. Не обрезать запрос, не переводить идентификаторы и не нормализовать его содержимое. Разные hash означают несогласованное чтение: зафиксировать конфликт чтения.
- Собрать карту зависимостей и правила изменения. Различать поле запроса, dataPath набора, вычисляемое поле, ресурс и выборку варианта. Для параметров связать объявление, выражение, использование в запросе и значение выбранных настроек. Проверить область группировок и условия, use, пользовательскую доступность, типы и порядок. Не создавать поле вывода вместе с полем набора молча.
- Обосновать зерно данных, соединения и агрегации. Перечитать затронутые метаданные источников. Изменённый полный запрос проверить validate_query(projectName=<тот же проект>, dcsMode=true). success/isError описывают вызов; valid и issues — результат проверки. Параметры могут пройти синтаксическую проверку без значений: сопоставить их объявления отдельно. Ресурс и выражение СКД этим вызовом не доказаны.
- Составить адресные изменения только для задачи. Копировать канонические адреса из get; учитывать hash и фактическую поддержку каждого свойства текущим guide. Предпочитать update существующего узла; создание требует явной цели upsert. replace сбрасывает пропущенное, remove удаляет узел. Диаграмма, неподдержанный тип значения или шаблон расшифровки не должны исчезнуть при замене родителя. Нет доказанного безопасного изменения — зафиксировать явное ограничение, сохранив предметное предложение.
- Передать предложение существующему edt-mcp для разрешённой записи. Само исследование запись не разрешает. После записи владелец перечитывает целевой узел и затронутые зависимости, проверяет полный итоговый запрос в dcsMode и диагностику EDT. По критериям задачи проводится проверка строк, итогов, границ периода, прав, производительности и клиентского поведения согласно критериям; статическая модель их не подтверждает.
Предметное предложение
Указать проект, корень схемы и основной/иной макет, точный набор данных, выбранные настройки и сценарий. Для зависимости записать источник, потребитель, канонический адрес, подтверждённое значение и неизвестное.
Для каждой правки указать цель, текущее и предлагаемое значение, причину, затронутые зависимости, действие/type/body по актуальному контракту dcs, нужный hash и проверяемый результат. При предложении нескольких записей указать зависимости между ними; не объявлять несколько вызовов атомарными. Порядок операций определяется зависимостями между узлами схемы.
Отдельно назвать сохраняемые настройки и неподдержанный материал. Если текущая схема подходит задаче, обосновать её сохранение. Полные данные проекта хранить в операции хоста; полноту чтения ограничить явно. Успешное чтение и проверка запроса не означают, что отчёт изменён или выполнен в информационной базе.
Если пользователь не понимает показатель
Обычный вопрос «откуда берётся этот процент?» — повод проверить не только выражение, но и то, как отчёт объясняет результат человеку. Сначала установи числитель, знаменатель, единицы измерения, состав строк и уровень итогов. Процент по сумме и процент по количеству — разные показатели; совпадение сумм не доказывает выполнение заказа по количеству. Причину расхождения цен, состава или документов не придумывай: отделяй формулу от гипотезы о данных.
Дай прикладное объяснение и предложи минимальное улучшение: точное название колонки, исходные значения рядом с процентом, доступная расшифровка. Если изменение представления уже разрешено условиями задачи, выполни его через EDT MCP в этом же проходе. Если разрешено только исследование, оставь предложение. Не меняй формулу, отборы, пользовательские варианты и учётную логику под видом косметики; новый показатель согласуется отдельно.
Для существующего отчёта не создавай второй отчёт только ради объяснения. Подсказку или расшифровку показывай лишь там, где её поддерживает фактическая форма и текущий контракт инструмента. Сохранённое свойство не доказывает, что подсказка появилась в окне 1С. В ответе разделяй прочитанную формулу, сделанную правку и проверенный экран; не называй предложение выполнением.
При отказе записи исправляй причину из ответа инструмента, а не повторяй тот же
вызов. Например, логическое use передаётся JSON-значением true, не строкой
"true"; поле выбора — { "kind": "field", "value": "ИмяПоля" }.
expectedHash передаётся на верхнем уровне аргументов, вне body, и обновляется
после успешной записи. Если исправленный вызов снова отклонён, перечитай guide
и адрес целевого узла; не запускай цикл одинаковых неуспешных записей.
Дополнительная памятка
- Учётная достоверность отчётов, регистры-источники и сравнение выборок
- Парный инструментальный навык EDT-MCP для работы с запросами и СКД:
edt-mcp-project-query-dcs
Разработка и проверка решений на 1С:Предприятие.Элемент
Используй навык, когда в репозитории обнаружены признаки проекта 1С:Предприятие.Элемент (Project.yaml / Проект.yaml, модули на языке Элемента / xBSL, декларации компонентов и сервисов Элемента).
Не смешивай 1С:Элемент с классической платформой 1С:Предприятие 8
Это разные технологические стеки, языки, модели метаданных и среды исполнения:
- Не переноси в проект 1С:Элемент директивы компиляции управляемых форм
&НаКлиенте/&НаСервере, глобальные методы классического BSL, объектные модели.mdo/.form, вызовы БСП 8.3 и инструментыedt-mcp, предназначенные исключительно для проектов 1С:EDT 8.3. - Синтаксис конструкций языка (строгая/уточнённая типизация, коллекции, исключения, аннотации HTTP-конечных точек, сущностей хранения и клиентских представлений) сверяй с фактической версией SDK/среды проекта в
Project.yaml(Проект.yaml) и существующими модулями этого репозитория.
Идентичность исходников, сборки и облачного стенда
При разработке и диагностике в 1С:Элемент разделяй четыре состояния:
- Локальная ветка Git с исходными файлами YAML и модулями кода;
- Облачная или локальная среда разработки (IDE Элемента) — несинхронизированные изменения в облачном воркспейсе и локальном Git легко перезаписывают друг друга без проверки статуса синхронизации;
- Результат компиляции и сборки приложения — синтаксически похожий на BSL код может быть отклонён компилятором Элемента из-за несовпадения типов, области видимости или сигнатур SDK;
- Развёрнутый экземпляр приложения и применённые миграции БД — добавление или изменение хранимой сущности в исходниках не меняет схему развёрнутого стенда без успешного прогона сборки и обновления/миграции базы стенда.
Успешное сохранение файла на диске не доказывает ни прохождение компилятора Элемента, ни применение схемы хранения.
Политики доступа и безопасность операций в 1С:Элемент
- Проектируй и проверяй права на трёх уровнях: доступ к типу сущности, фильтрация на уровне конкретных записей (по владельцу, организации, роли участника) и разрешение на выполнение прикладной команды / HTTP-операции.
- Не полагайся на скрытие элементов в веб-клиенте Элемента: любой опубликованный серверный метод или HTTP-обработчик обязан проверять полномочия текущего субъекта и валидировать входные параметры на сервере.
- Проверяй целевой сценарий под учётной записью конечной прикладной роли (а не только администратора проекта/стенда), подтверждая как успешное выполнение разрешённого действия, так и отказ при обращении к чужим данным или запрещённой операции.
Подписки на события, функциональные опции и регламентные задания 1С
Используй навык, когда правило должно срабатывать для группы видов объектов (справочников, документов, наборов записей регистров), функциональность должна включаться/выключаться настройкой без ветвлений в каждом модуле либо обработка выносится в регламентное или фоновое задание.
Матрица выбора точки размещения серверной логики
Не дублируй один и тот же код в модулях десятка документов, но и не вешай глобальную подписку ради одного объекта:
| Механизм | Когда выбирать | Ограничение и риск |
|---|---|---|
Модуль конкретного объекта (ПередЗаписью, ОбработкаПроведения, ОбработкаПроверкиЗаполнения) | Логика специфична только для этого одного документа или справочника | Дублирование кода, если то же правило нужно ещё 10 документам |
Подписка на события (EventSubscription) по определяемому типу | Единое сквозное правило для открытого перечня объектов (версионирование, заполнение автора/подразделения, регистрация в очереди обмена, контроль даты запрета) | Выполняется на горячем пути каждой записи; порядок между несколькими подписками на одно событие платформой не гарантирован! |
Переопределяемый общий модуль БСП (...Переопределяемый) | Подключение прикладного объекта к уже существующей подсистеме БСП (печать, права, свойства, обновление ИБ, запрет изменения) | Сигнатура и момент вызова жёстко заданы версией БСП |
Перехватчик в расширении (&Перед, &После, &Вместо) | Точечная доработка типового объекта на поддержке, когда нет штатного хука БСП и подписки недостаточно | Зависимость от сигнатуры базового метода поставщика |
Предпочитай подписку на ОпределяемыйТип, а не ручной список из 30 документов в свойстве Источник: тогда подключение нового документа сводится к добавлению одного чекбокса в состав определяемого типа.
Сигнатуры и ловушки подписок на события
Серверный общий модуль обработчика подписки должен иметь флаг Сервер (без Клиент и без ВызовСервера!). Точно соблюдай сигнатуру по виду источника и события:
- Справочник / План видов характеристик (
ПередЗаписью,ПриЗаписи):(Источник, Отказ); - Документ (
ПередЗаписью,ПриЗаписи):(Источник, Отказ, РежимЗаписи, РежимПроведения)— всегда проверяйРежимЗаписи(Запись,Проведение,ОтменаПроведения) иИсточник.ПометкаУдаления, чтобы не блокировать пометку на удаление или отмену проведения проверками проведения! - Документ (
ОбработкаПроведения):(Источник, Отказ, РежимПроведения); - Набор записей регистра (
ПередЗаписью,ПриЗаписи):(Источник, Отказ, Замещение)— критическая ловушка: при отмене проведения или очистке регистратора подписка вызывается для пустого набора записей (Источник.Количество() = 0), где отбор поРегистраторустановлен, а строк нет! Всегда учитывай пустой набор и проверяйИсточник.ОбменДанными.Загрузка.
Внутри обработчика подписки запрещены тяжёлые некоррелированные запросы без индекса, сетевые вызовы и повторный Источник.Записать() в ПриЗаписи (приведёт к бесконечной рекурсии записи!).
Функциональные опции и параметры функциональных опций
- Для управления видимостью подсистем, объектов, реквизитов, команд и колонок форм используй декларативные
ФункциональныеОпции(привязанные к константе или ресурсу регистра сведений), вместо ручногоЭлементы.<Имя>.Видимость = ...в десятках форм. - Если опция действует в разрезе организации, склада или вида операции, задай
ПараметрыФункциональныхОпцийи в управляемой форме вызывайУстановитьПараметрыФункциональныхОпцийФормы(Новый Структура("Организация", Объект.Организация))при открытии и смене организации. - Помни: функциональная опция скрывает элементы интерфейса, но не отменяет права доступа и не защищает серверный API сама по себе — в серверном коде проверяй
ПолучитьФункциональнуюОпцию(...).
Дисциплина регламентных и фоновых заданий
- Тонкая точка входа в серверном общем модуле: код регламентного задания размещай в экспортной процедуре общего модуля, чтобы его можно было вызывать как по расписанию (для предопределённого
РегламентноеЗадание), так и вручную или из автотеста. - Идемпотентность, порционность и защита от наложения:
- Расписание может запуститься повторно до завершения предыдущего тяжёлого прогона: защищай вход управляемой блокировкой пространства задания или проверкой активного задания по ключу;
- Обрабатывай очередь пачками с фиксацией прогресса каждой пачки в короткой транзакции, чтобы сбой на 950-м элементе не откатывал 900 успешно обработанных и позволял продолжить со следующего шага;
- Не предполагай наличие интерактивного пользователя, открытой формы или заполненных клиентских параметров: регламентное задание стартует в фоновом серверном сеансе, а все итоги и ошибки обязано писать в
ЗаписьЖурналаРегистрациис понятным событием и контекстом объекта.
Доработка через расширение конфигурации
Используй навык, когда задача меняет поведение, форму или состав объекта конфигурации, которую проект получает от поставщика или из типового решения: модуль объекта или менеджера, общий модуль, форму, реквизит, табличную часть.
Навык задаёт предметное решение. Заимствование, чтение и запись метаданных и модулей выполняет EDT MCP: навык edt-mcp-project-metadata для заимствования и состава, edt-mcp-project-forms для форм, edt-mcp-project-local-fix для текста метода.
Сначала установи, чей объект
Не предполагай путь по названию конфигурации или по наличию расширений в проекте. Установи через EDT:
- точный проект базовой конфигурации и проекты расширений, связанные с ней;
- стоит ли конфигурация или объект на поддержке поставщика и разрешено ли его изменение;
- есть ли у объекта собственный префикс проекта или он типовой;
- какое расширение уже служит этой задаче или этому функциональному блоку, его префикс имён и назначение.
Если факты недоступны, назови их неизвестными в исследовании и не выбирай путь за пользователя.
Выбери путь
| Ситуация | Путь |
|---|---|
| Объект типовой, конфигурация на поддержке, изменение выражается расширением | Расширение. Типовой код и метаданные не правь |
| Объект собственный (префикс проекта, снят с поддержки, создан проектом) | Прямая правка в базовой конфигурации |
| Нужное свойство нельзя изменить расширением на этой платформе и в этом режиме совместимости | Не обходи ограничение. Опиши ограничение и варианты владельцу; снятие с поддержки — решение владельца, не исполнителя |
Выбор пути и его основания запиши в спецификации: проект, расширение, заимствуемые объекты, перехватываемые методы.
Заимствуй только нужное
- Заимствуй объект, форму или общий модуль через
adopt_metadata_object: базовая конфигурация —projectName, расширение — явныйextensionProjectName, если расширений больше одного. - Заимствуй минимальный состав. Заимствованная форма без реквизитов объекта показывает только свои элементы; чтобы вывести на неё данные объекта, заимствуй используемые реквизиты.
- Реквизиты заимствуются у объекта из типа основного реквизита формы. Обычно это владелец формы; у формы обработки с основным реквизитом другого объекта — этот объект.
- Отдельный реквизит, табличную часть, реквизит табличной части, измерение или ресурс заимствуй без формы:
adopt_metadata_objectс FQN элемента, напримерCatalog.Товары.Attribute.ВесилиDocument.Заказ.TabularSection.Товары.Attribute.Цена. Родитель заимствуется вместе с ним. - Код модулей расширения читает реквизиты базового объекта без заимствования. Заимствуй реквизит, только когда его выводит собственная форма расширения или табличной части нужны собственные реквизиты.
- Собственная форма расширения видит только заимствованные реквизиты объекта; путь к незаимствованному — ошибка «Неверный путь к данным».
- Собственный реквизит в заимствованной табличной части не принимается при обновлении базы у плана видов характеристик, плана счетов и плана видов расчёта; у бизнес-процесса и задачи — только начиная с платформы 8.3.25. До такого решения сверь вид объекта и версию платформы проекта; если ограничение действует, иди по третьей строке таблицы путей.
- Новый реквизит, табличную часть, команду или форму добавляй в объект расширения, а не в базовый объект. Имена новых объектов и реквизитов следуют правилам проекта; имена новых методов расширения — префиксу этого расширения, чтобы не столкнуться с другими расширениями.
- Новый элемент формы связывай с реквизитом формы или объекта. Связь и видимость проверяй по модели EDT, а не по совпадению имён.
Выбери перехватчик метода
Перехватчик связывается с методом базового модуля по имени и списку параметров. Сигнатуру, директиву компиляции модуля формы и условие препроцессора бери из актуального базового метода через EDT, а не из памяти или примера.
| Аннотация | Когда | Ограничения |
|---|---|---|
&Перед | Добавить действия до неизменного базового метода | Только для процедуры |
&После | Добавить действия после неизменного базового метода | Только для процедуры |
&Вместо | Заменить поведение или выполнить базовый метод по условию | ПродолжитьВызов() вызывает базовый метод и для функции возвращает его значение. Без этого вызова базовое поведение не выполняется: это полная замена, её нужно обосновать |
&ИзменениеИКонтроль | Точечно изменить тело базового метода | Тело — контролируемая копия базового метода. Добавленные строки обрамляются #Вставка и #КонецВставки, исключённые — #Удаление и #КонецУдаления. ПродолжитьВызов() здесь не используется |
Порядок выбора: сначала &Перед или &После, затем &Вместо с ПродолжитьВызов(), затем &ИзменениеИКонтроль, и только затем &Вместо без базового вызова. Более сильный вид выбирай, когда слабый не выражает требование, и называй причину.
&ИзменениеИКонтроль связывает расширение с текстом базового метода. После обновления поставщика расширение может не примениться, пока копия не сверена с новой редакцией. Сверку с базовым методом, сохранение правок и проверку применимости расширения проводи явно перед завершением задачи.
Не правь текст заимствованного модуля вне перехватчиков: заимствованный модуль содержит только методы расширения.
Чем доказывается результат
Разделяй три факта: диагностика EDT проекта расширения без ошибок, применимость расширения к базе на платформе и в режимах совместимости проекта, поведение пользователя в сценарии. Успешная запись файла или заимствования не доказывает ни применимость, ни поведение. В плане проверки укажи, какой из фактов подтверждает каждый критерий.
Дополнительная памятка
Внешние отчёты и обработки, поставка релизов и восстановление баз 1С
Используй навык при разработке или обновлении внешних обработок (.epf) и внешних отчётов (.erf), их регистрации в БСП, подготовке пакетов поставки (.cf, .cfu, .cfe) и проверке резервного копирования / развёртывания копий информационных баз.
Операции с проектами внешних объектов в EDT выполняй через навык edt-mcp-project-external-objects.
Тройная идентичность внешнего отчёта или обработки (EPF / ERF)
При доработке внешней обработки или печатной формы не путай три отдельных представления:
- Исходники внешнего объекта в проекте EDT (модуль объекта, формы, макеты);
- Собранный бинарный файл
.epf/.erfна диске (требует пересборки из исходников после каждой правки); - Экземпляр в справочнике
ДополнительныеОтчетыИОбработкиинформационной базы (хранит бинарные данные во внутреннем хранилище значения — замена файла в папке на диске не обновляет обработку внутри базы до перезагрузки файла в карточку справочника!).
При обновлении карточки в ДополнительныеОтчетыИОбработки сохраняй назначение объектам, размещение в разделах, расписание регламентных вызовов и список пользователей быстрого доступа; не удаляй существующий элемент справочника с созданием нового Ссылка, чтобы не разрушить настройки пользователей и задания.
Контракт СведенияОВнешнейОбработке в БСП
Для подключаемых отчётов, обработок заполнения, создания на основании и внешних печатных форм проверь экспортную функцию модуля объекта СведенияОВнешнейОбработке():
- Явно укажи
Вид(ПечатнаяФорма,ЗаполнениеОбъекта,СозданиеСвязанныхОбъектов,Отчет,ДополнительнаяОбработка),ВерсияБСП,Версиясамой обработки иБезопасныйРежим(Истинавезде, где не требуются привилегии вне песочницы; отключение безопасного режима требует явного обоснования). - Для каждой строки таблицы
КомандысогласуйВариантЗапускас фактической реализацией:ОткрытиеФормы— открывает управляемую форму обработки на клиенте;ВызовКлиентскогоМетода— вызывает экспортную процедуру модуля формы;ВызовСерверногоМетода— вызывает экспортную процедуруВыполнитьКомандув модуле объекта (для фоновых/пакетных команд и формирования печатных форм без предварительного диалога).
- Для печатной формы идентификаторы макетов и названия команд в
УправлениеПечатьюобязаны совпадать со строками таблицыКоманды. - Ловушка потери ссылочных типов при разборке/сборке
.epfи.erf: никогда не разбирай в исходники и не собирай внешнюю обработку/отчёт с ссылочными реквизитами или набором записей регистра на форме в пустой базе без целевой конфигурации — платформа без ошибки заменитСправочникСсылка.<Имя>на строку или висячий идентификатор типа и сброситПутьКДаннымколонок! Всегда выполняй сборку и выгрузку на базе с соответствующей конфигурацией и совместимымFormatVersionцелевой платформы.
Пакеты поставки (CF, CFU, CFE), хранилище конфигурации и окно обновления
- При работе с базой, подключённой к хранилищу конфигурации 1С, полная загрузка из файлов недоступна: соблюдай строгую последовательность
обновление из хранилища → захват нужных объектов (и корня конфигурации при создании нового объекта) → обязательная частичная выгрузка захваченных объектов на диск (чтобы не затереть чужие свежие изменения в хранилище!) → внесение правок → частичная загрузка и обновление БД → помещение в хранилище. У каждого расширения — собственное хранилище. - Различай полный файл поставки
.cf(загружает конфигурацию целиком) и файл обновления.cfu(применяется строго к перечисленным в его манифесте исходным версиям конфигурации поставщика). Перед выпуском сверяй номер версии и поставщика в свойствах конфигурации. - При регламентном обновлении рабочей базы фиксируй полный цикл: проверка актуальной резервной копии → установка блокировки сеансов и регламентных заданий с кодом разрешения → завершение активных фоновых задач → загрузка и обновление конфигурации БД → запуск обработчиков обновления БСП в монопольном/служебном режиме → обязательное снятие блокировки сеансов и включение регламентных заданий (включая ветку аварийного отката!).
Доказательство резервного копирования и изоляция тестовой копии
Наличие файла бэкапа в каталоге не доказывает возможность восстановления (RPO / RTO проверяются только тестовым развёртыванием).
- Различай свойства способов копирования:
- Выгрузка
.dtудобна для переноса небольших тестовых и файловых баз, но требует монопольного режима, сильно нагружает память и не позволяет восстановить базу на произвольную секунду транзакционного лога; - Штатный бэкап СУБД (PostgreSQL / MS SQL Server) обеспечивает консистентность на горячей базе и Point-in-Time Recovery;
- Снимок виртуальной машины без координации с СУБД соответствует аварийному отключению питания и требует проверки целостности таблиц после подъёма.
- Выгрузка
- Обязательная изоляция восстановленной копии: сразу после восстановления рабочей базы в тестовый/разработческий контур (до запуска регламентных заданий!) заблокируй выполнение регламентных заданий на уровне кластера ИБ, очисти или перенаправь учётные записи электронной почты, СМС, ЭДО, банковских обменов, вебхуков, касс и узлов РИБ. Иначе тестовая копия начнёт рассылать реальным клиентам дубли писем, забирать сообщения из продуктовой очереди или списывать коды маркировки!
Дополнительная памятка и парные навыки
- Совместимость
FormatVersion, ловушки разборкиEPF/ERFи заимствованияCFE - Протокол захватов и частичной загрузки в Хранилище 1С:
onec-configuration-repository - Для импорта, проверки и сборки внешних обработок и отчётов (
.epf/.erf) через EDT-MCP применяй в пареedt-mcp-project-external-objects.
Интеграции, файловый импорт и обмен данными в 1С
Используй навык при разработке и разборе обменов между 1С и внешними системами: загрузка табличных/банковских файлов, HTTP и Web-сервисы, планы обмена БСП, правила конвертации EnterpriseData / КД 3, обмен с сайтом (CommerceML), государственные контуры маркировки и внешние сервисы распознавания или ИИ.
Для специализированной загрузки произвольных XML-схем по XSD через пакеты XDTO дополнительно сверяйся с навыком onec-xdto-import.
Контракт файлового импорта (CSV, таблицы, выписки, OCR)
До написания разбора зафиксируй физический и предметный контракт файла:
- Кодировка, разделитель полей и экранирование кавычек: запятая внутри значения в кавычках или десятичный разделитель
1,234не должны разрезать колонку и превращать дробное количество в две ячейки или в тысячу. - Ведущие нули и длинные числовые идентификаторы: ИНН, КПП, БИК, расчётные счета, штрихкоды GTIN/EAN, коды маркировки и внешние артикулы читай только как строку; преобразование через число обрезает ведущие нули (
044525...→44525...) и искажает разряды длинных кодов свыше 15–16 цифр. - Стадия предпросмотра и сопоставления (особенно для клиент-банка и распознанных сканов/OCR): разделяй загрузку распознанного буфера и проведение учётного документа. Потерянные или нераспознанные строки и реквизиты явно помечай для проверки оператором, а не заполняй пустыми значениями или первым попавшимся контрагентом по подстроке наименования.
- Идемпотентность повторной загрузки: ключ дубля строится по бизнес-идентификатору операции (номер и дата выписки/внешнего документа + счёт/источник), а не по имени файла на диске.
HTTP-сервисы, Web-сервисы и внешние вызовы API
- Разделяй транспортный и прикладной статус: HTTP
200 OKс телом{"error": ...}не является успешной бизнес-операцией, а сетевой таймаут чтения ответа не доказывает, что удалённая система не приняла запрос. - Идемпотентность и корреляция: передавай устойчивый ключ идемпотентности (
Idempotency-Key/MessageID/УИДдокумента или сообщения очереди) и сквозной идентификатор запроса в лог. При повторе после обрыва связи принимающий HTTP-сервис 1С обязан вернуть статус уже обработанной операции по этому ключу, а не создать дубль заказа или оплаты. - Безопасность границы доверия и TLS: для исходящих HTTPS-соединений передавай
Новый ЗащищенноеСоединениеOpenSSLи явный таймаут вНовый HTTPСоединение(...), а токены читай из безопасного хранилища. Внутри входящего HTTP-сервиса проверяй права и допустимость параметров на сервере, не полагаясь на проверки клиентской формы, заголовок отправителя или совпавшийRequestID. В ответах об ошибках возвращай согласованный машинный код и безопасное описание без текста SQL, серверных путей и токенов авторизации. - Стандартный интерфейс OData (
standard.odata): учитывай, что для доступа через OData объект должен быть явно включён в состав стандартного интерфейса OData и опубликован на веб-сервере, а имена сущностей и навигационных свойств чувствительны к регистру и виду объекта (Catalog_...,Document_...,InformationRegister_..._RecordType). Для операций записи через внешний шлюз предусматривай режим предварительного просмотра (dry-run) до модификации учётных данных.
Планы обмена, EnterpriseData (КД 3) и частичные обновления
- Регистрация изменений и квитанции номеров сообщений: наличие объекта в таблице регистрации узла плана обмена (
ПланыОбмена.ЗарегистрированныеИзменения) означает лишь поставленную метку; фактический состав пакета определяют правила регистрации и конвертации (МенеджерОбменаЧерезУниверсальныйФормат), а подтверждение доставки — номераОтправленныйНомер/ПринятыйНомерв заголовке сообщения обмена (удаление регистрации выполняется только после подтверждённой квитанции приёмника). - Семантика пустых и отсутствующих полей при частичном обмене: различай три случая во входящем сообщении — поле не передано вовсе (сохранить текущее значение приёмника, если согласован частичный патч), передано явное пустое значение (очистить реквизит) и передано новое значение. Аналогично для табличных частей зафиксируй контракт: полная замена всех строк таблицы документом источника или слияние по ключу строки.
- При записи по обмену аккуратно используй
ОбменДанными.Загрузка = Истина: он отключает повторную регистрацию на узел-отправитель и часть интерактивных проверок, но не должен оставлять проведённый документ без обязательных движений в приёмнике, если сами движения не передаются отдельными наборами записей.
Типовые отраслевые протоколы (CommerceML, маркировка, внешние ИИ-сервисы)
- CommerceML (обмен с интернет-магазином): различай выгрузку каталога товаров (
import.xml), пакетов предложений/цен/остатков (offers.xml, с учётом характеристик/SKU против карточки номенклатуры) и двусторонний обмен заказами. При порционной выгрузке изменений не сбрасывай на сайте остатки не попавших в дельту товаров как нулевые. - Системы прослеживаемости и маркировки (Честный ЗНАК / ГИС МТ, ЕГАИС, ВетИС): моделируй явную карту состояний кода маркировки / документа (сформирован → отправлен → принят оператором → введён в оборот / выведен из оборота → отклонён с кодом ошибки). Запрещай повторную отгрузку одного кода маркировки в другой документ до снятия резерва или отмены предыдущей операции.
- Интеграция с внешними сервисами анализа / ИИ и минимизация данных: фиксируй версию промпта/контракта, хэш входов для кэширования и признак «требует подтверждения пользователя». Выполняй сетевой вызов в фоновом задании вне транзакции БД, предварительно удаляя секреты и псевдонимизируя чувствительные реквизиты (ФИО, ИНН, счета, телефоны), включая их вхождения в представления ссылок и свободный текст комментариев.
Маршрутизация учётных инцидентов КА
Используй навык, когда продукт — Комплексная автоматизация (или близкий учётный контур ERP), а симптом связан с себестоимостью, закрытием месяца, взаиморасчётами, НДС, складом/сериями, производством или правами доступа в учётном сценарии.
Навык задаёт выбор сценария, предметные проверки и критерии доказанного результата. Универсальная цепочка документ→движение→регистр — навык onec-movement-diagnosis. Чтение метаданных — edt-mcp. Этот навык не подключай для ЗУП и для задач без учётного симптома.
Сначала симптом, не причину
Классифицируй кейс по наблюдаемому результату и имеющимся материалам. Не выбирай сценарий по одному слову пользователя.
Основной сценарий
| Сценарий | Когда |
|---|---|
| Себестоимость и закрытие месяца | Расчёт себестоимости, отклонения стоимости, операции закрытия, остатки после закрытия, иной результат после перезакрытия |
| Постатейные расходы | Статьи расходов, база/направление распределения, нераспределённые суммы, аналитика заказа/реализации/подразделения, попадание в финрезультат или себестоимость |
| Взаиморасчёты | Расхождения задолженности, авансов, зачётов; остатки по партнёру/контрагенту/договору/документу расчётов; несовпадение регистров и бухгалтерского учёта |
| НДС | НДС, счета-фактуры, книги покупок/продаж, корректировки в закрытом налоговом периоде, расхождение регистра НДС и проводок |
| Склад, серии, назначения | Количество, склад, серии, назначения, отбор/размещение, отрицательные или раздвоенные остатки при разных аналитиках одной номенклатуры |
| Производство | Заказы/этапы, передача материалов, выпуск, возврат, ремонт, давальческая схема, разрыв связи этапа и движений |
| Права доступа | Роли, профили, группы доступа, полномочия, оргразделение; снятие административных возможностей без поломки рабочих функций |
После выбора используй Предметные проверки: различающие гипотезы наблюдения, фактические аналитики и проверка эффекта. В спецификацию перенеси подтверждённый механизм и критерии результата; при доработке повторно проверь изменившиеся предпосылки.
Комбинации
Второй сценарий подключай только после фиксации точки пересечения. Примеры: склад → себестоимость, если складская аналитика доказанно влияет на стоимость; расход → закрытие, если нераспределённый расход виден на закрытии; производство → склад, если разрыв серии внутри производственной цепочки; НДС → взаиморасчёты при одновременном налоговом и расчётном вопросе.
Не подключай сценарий «для полноты», если в материалах нет признаков домена. Не переноси имена объектов и регистров из другого кейса.
Доказательства и стоп
Имена документов, регистров, полей, счетов и ролей бери только из материалов дела, модели EDT, кода или документации проекта. Не выдумывай типовые имена ERP.
Если нельзя связать симптом с конкретной записью и механизмом, который её потребляет, корневая причина не установлена: верни вероятностную оценку или запрос проверки и запроси минимальный недостающий набор доказательств. Исправление без этой связи не предлагай как доказанное.
Дополнительная памятка
Композиция управляемой формы
Вход: утверждённая задача, точный проект и форма, критерии приёмки. Результат зависит от поручения: при анализе — предметное предложение и карта изменений; при разрешенной разработке — примененная через EDT композиция формы и проверенный пользовательский сценарий. Предложение не равно готовому АРМ. Этот навык не утверждает задание и сам по себе не запускает 1С. Явное поручение создать или доработать АРМ является разрешением на согласованные изменения. Не требовать повторного подтверждения того же объема. Инструменты записи выполняются через EDT MCP в пределах разрешённого объёма задачи.
- Получить факты через существующий edt-mcp: list_projects, get_configuration_properties, get_metadata_details для объекта и формы. Обработчики исследовать через get_module_structure и read_method_source; modulePath подтвердить по проекту. Проект задавать явно. Схемы и get_tool_guide читать до вызова. Отсутствие инструмента зафиксировать явно; не переходить к ручной правке .mdo/.form/XML.
- Для запроса на АРМ применить паттерн рабочего места из patterns.md: роль, несколько связанных объектов, очередь, действия и сохраненный результат. Не переопределять создание рабочего места как исправление дефекта. Установить сценарий: какие данные вводят, что выбирают, что вычисляют, какая команда завершает работу, какие ошибки пользователь должен исправить. Не додумывать поля, события и бизнес-логику из типового архетипа.
- Выбрать композицию из предметных паттернов. Сохранить принятую структуру продукта, если задача не требует её изменения. Двухколоночность, вкладки, модальность и имена групп — проектные решения, не стандарты 1С.
- Для каждого нового или изменяемого элемента записать: назначение, владельца и родительскую группу; точный dataPath и тип; редактируемость; команду, событие, обработчик и контекст там, где они действительно нужны. Имена объектов брать из модели, а не из локализованных синонимов. Пустое имя события, отсутствующий тип или обработчик — неподтверждённая привязка; не заполнять пробел догадкой и не выдавать карту за полную.
- Проверить привязки: существующий реквизит/колонка, команда и обработчик,
допустимый контекст и отсутствие дублей. События из образца не создавать
автоматически. Реквизит формы, реквизит объекта и видимый элемент различать.
Для длинного строкового описания сначала проверить тип и ограничения
реквизита, его
multiLine/extendedEditи свойства связанного поля ввода. НазваниеTextDocumentFieldсамо по себе не доказывает пригодность для редактирования строки. Не менять вид элемента догадкой: подтвердить совместимость привязки и проверить сохранение значения после открытия формы.InputFieldтакже не означает однострочность: она зависит от свойств связанного реквизита и поля. Перед выводом о рассинхронизации модели и базы прочитать эти свойства; одного имени типа элемента недостаточно. - При разрешенной разработке выполнить согласованные изменения через существующий edt-mcp по точным целям. При запросе только на анализ вернуть предложение без записи. Поддержку конкретного свойства проверить по текущему guide create_metadata/modify_metadata. Не расширять согласованный объем изменений.
- После изменения перечитать структуру через владельца EDT. Статическая модель доказывает структуру, но не расположение пикселей и не поведение. Если сериализованная форма пуста, исследовать ПриСозданииНаСервере и вызванные методы: элементы и команды могут создаваться программно. Не объявлять АРМ отсутствующим только по пустому дереву формы в EDT. Снимок дизайнера не выполняет серверный код; для такого АРМ нужен клиентский сценарий. Визуальное подтверждение и клиентский сценарий выполняются по критериям приёмки.
Материалы проекта хранить в своей операции хоста. Полноту явно ограничивать. Для get_metadata_details учитывать секцию Errors даже при isError=false. Формат FQN для других инструментов сверять отдельно: Form/Forms могут различаться.
get_form_layout_snapshot с formPath открывает и активирует редактор: вызов должен входить в разрешённое действие. Его live guide различает nativeFormLayoutRender и nativeFormBufferedLayoutRender. Нулевые bounds при native render не доказывают пустоту формы и не исправляются повтором. Не менять flags и не перезапускать EDT ради исследования. get_form_screenshot требует отдельной проверки доступности; после изменения использовать refresh по актуальному контракту инструмента.
Предметное предложение
Указать проект и FQN формы, сценарий, выбранный архетип и его обоснование. Для элементов перечислить точные имена, родителя, dataPath, тип данных, редактируемость и назначение. Для действий — команду, событие, метод, модуль, контекст исполнения и подтверждённую связь. Неизвестное назвать явно.
Каждое предлагаемое изменение адресовать владельцу: FQN/элемент/свойство, текущее и предлагаемое значение, причина и проверяемый результат по критерию. Если текущая композиция подходит сценарию, вернуть обоснованное сохранение структуры; шаблон сам по себе не создаёт работу на изменение.
Например, карточка справочника с основной группой и двумя полями не требует второй колонки. Путь к данным подтверждается моделью, фокус — кодом обработчика. Чтение кода не подтверждает вызов события в клиенте: это отдельная проверка поведения по критериям задачи.
Навигация рабочего интерфейса
У каждой пользовательской подсистемы должен быть осмысленный графический элемент: подходящая штатная картинка или подготовленная общая картинка. Картинку выбирай по роли раздела и проверяй в работающем интерфейсе. Служебные разделы тестового движка и генератора кода не должны становиться основными разделами рабочего места. Исключай их из командного интерфейса, сохраняя сам движок и возможность запуска тестов. Изменяй фактически установленное расширение, а не одноимённую копию в другом проекте.
Дополнительная памятка
- Режимы исполнения форм, динамические списки, асинхронность и ввод данных
- Обычные формы (
Form.bin) и асинхронный клиентский код (Асинх/Ждать) - Парный инструментальный навык EDT-MCP для чтения и безопасной правки форм:
edt-mcp-project-forms
Диагностика по движениям и регистрам
Используй навык, когда симптом — неверная сумма, количество, остаток, проводка, исчезнувшая или лишняя запись, и причину нужно доказать по данным, а не по догадке.
Навык описывает порядок исследования. Чтение метаданных и кода выполняется через EDT MCP; воспроизведение — через доступный Runner.
Порядок работы в локальной тестовой среде
- Через EDT MCP прочитай модуль отчёта, модуль проведения документов и связанные серверные модули. Перечень метаданных не заменяет чтение кода.
- Сформулируй проверяемую гипотезу по прочитанному коду.
- Перед созданием feature вызови навык
onec-vanessa-scenario. Перед запуском вызови навыкvanessa-runner. Эти навыки содержат разные обязательные контракты: первый — существующие шаги, второй — запуск и отчёт. Не переходи к запуску только по найденной сигнатуре инструмента. - Подготовь сценарий из существующих определений шагов. Если обращение о том, что показывает отчёт, открой и сформируй именно этот отчёт в TestClient и сравни его видимые строки с документами. Вызов серверной функции не заменяет эту проверку. Ожидаемое значение следует из документов и запроса пользователя, а не из подозрительного отчёта.
- Запусти через MCP Runner; прочитай свежий результат и передай артефакт с ожидаемым и фактическим значением. Ошибки инфраструктуры устраняй и повторяй самостоятельно в разрешённой области.
Только исходники и локальная тестовая база
Если пользователь сравнивает отчёт и документы, сначала исследуй код самого отчёта: запрос, соединения, группировки, параметры и потребляемые движения. Название товара — данные, а не имя объекта метаданных. Найди отчёт по модели проекта; не ищи каждый товар среди метаданных.
Если рабочая база недоступна, но есть разрешённая локальная база из этих исходников, не останавливайся на просьбе прислать production-данные. По исходникам установи гипотезу, выбери навык подготовки сценария, подготовь минимальные контрольные данные и исполнимый feature. Найденные в проекте методы подготовки данных используй после чтения кода и проверки области записи. Не меняй прикладной дефект в ходе диагностики.
Получить свежий отчёт — часть исследования: выполни сценарий через доступный Runner, дождись результата и прочитай исходный JUnit/Allure. Старый отчёт и мысленный расчёт не доказывают новый прогон. Если проверка упала на ожидаемом бизнес-расхождении, это воспроизведение; ошибка шага, компиляции или запуска — препятствие, которое надо исправить, а не корневая причина обращения. Отчёт должен содержать ожидаемое и фактическое значения. Сохрани исполнимый сценарий и отчёт как отдельные артефакты, пригодные для передачи разработчику.
Не приписывай рабочей базе состояние контрольного примера. Если доступных данных и исходников недостаточно даже для минимального воспроизведения, укажи конкретный недостающий факт.
Цепочка доказательства
- Отдели установленные факты, интерпретации, гипотезы и недостающие данные.
- Построй хронологию с самого раннего значимого регистратора, а не с конечного симптома.
- Сравни проблемный пример с контрольным (или до/после) по одинаковым аналитикам — только по измерениям, которые реально есть в данных.
- Найди раннюю точку расхождения, а не последнее видимое следствие.
- Собери цепочку: документ → движение → запись регистра → использующий механизм → результат (остаток, расчёт, доступ) → наблюдаемый симптом.
- Для каждой гипотезы зафиксируй опору, противоречие, условие подтверждения и условие опровержения.
- Не называй корневую причину, пока не показан механизм, который потребляет расходящуюся запись.
- Если цель — точная причина, а есть только формулировка симптома без движений и регистратора, причина не установлена: запроси минимальный недостающий набор доказательств.
Не придумывай имена объектов метаданных, регистров, полей и ролей. Имена бери из выгрузки, модели EDT, кода или официальной документации проекта.
Что смотреть в движениях документа
По фактической выгрузке или модели: документ и дата; проведён ли; регистратор; список регистров; период записи; вид движения; количество и сумма; организация и прочие аналитики, если присутствуют (склад, номенклатура, серия, назначение); активность; сторно или отмена; отличия от контрольного документа.
Пустое поле само по себе не ошибка без знания механизма. Набор движений одного вида документа не переноси на другой без доказательства.
Что смотреть в регистре
Для каждого найденного регистра: полное имя; тип, если подтверждён; измерения и ресурсы; регистратор; период и активность; ключевые аналитики; остаток до операции; движение; остаток после; сравнение с контрольным примером.
Для причинного вывода покажи, какой последующий механизм использует эту запись.
Проверка доказательств помогает выбрать различающий гипотезы эксперимент, сверить полноту строк и объяснить эффект изменения. Применяй её при исследовании, подготовке критериев спецификации, доработке и проверке результата.
Итог
Вывод называет раннюю точку расхождения, потребляющий механизм и какие данные ещё нужны, если цепочка не замкнута. Исправление без этой цепочки не предлагай как доказанное.
От разового расхождения к контролю качества учета
Когда пользователь поручил не только объяснить расхождение, но и предотвратить его повторение, проверь полноту проектирования контроля. Успешное проведение документа или закрытие месяца не доказывает соблюдение предметного правила.
- Зафиксируй правило учета, область применимости и исключения. Свяжи нарушение с документами, аналитиками, движениями и кодом, который их потребляет.
- Найди в конфигурации существующее рабочее место контроля, правила и механизм их запуска. Не утверждай, что типовая подсистема есть, пока не нашел ее. В упрощённой кастомной модели называй её кастомной; не переноси правила КА/ERP или ЗУП автоматически между продуктами.
- Воспроизведи отсутствие нужного контроля тестом пользовательского сценария. Красный результат — несовпадение ожидаемого предметного результата, а не неизвестный шаг, недоступный клиент или ошибка подключения.
- В разрешенной области добавь повторяемую проверку в найденный механизм. Результат должен содержать документ-источник, нарушенное правило, сумму или аналитику, понятное действие и переход к источнику. Не переноси оплаты, не меняй налоговый учет и не исправляй документы молча ради зеленого теста.
- Выполни тот же тест после изменения, затем проверь корректный пример, исключения и повторный запуск. Контроль должен обнаруживать нарушение до исправления данных и переставать показывать его после исправления. Зеленый тест контроля может означать найденную учетную ошибку: это разные статусы. «Нет отклонений» допустимо только для успешно выполненного правила; отсутствие реализации или неполные данные показывай отдельным состоянием.
- Сохрани исходные красный и зеленый отчеты и фактический экран рабочего места. Подготовленные данные и ручные исправления не выдавай за действия агента.
Наличие двух регистров (например, бухгалтерского и управленческого) не доказывает расхождение между ними. Не заменяй исходный документ удобным соседним механизмом. Если документ не формирует движений, исследуй его реквизиты и потребляющий алгоритм: отсутствие модуля проведения не разрешает выдумать проводку. В выводе о причине должны быть фактическая запись либо воспроизведение на явно описанных данных и прочитанный код. Слова «вероятно» не превращают догадку в доказанную причину и основание для доработки.
Повторное чтение неизменных метаданных не дает данных документов. После одинакового ответа не повторяй тот же вызов: переходи к модулю-потребителю, предоставленным материалам или разрешенному воспроизведению. Различай описание реквизита и его фактическое значение в конкретном документе.
Развитие поведения прикладного объекта
Сначала установи хозяйственное событие и результат для роли. План и факт — разные данные. Частичное выполнение должно оставлять исходное задание и отдельные документы факта, чтобы мастер видел историю и остаток. Не заменяй новые операции исправлением старого документа задним числом.
Исследование модели
Через существующий EDT MCP прочитай документ, его модуль объекта, регистры и регистраторы, формы, подписки и расширения. Уточни разрешение проведения, автоматическое удаление движений, режим блокировок и права роли. Название события само по себе не описывает существующую учётную модель.
Выбери место поведения по ответственности:
- ОбработкаЗаполнения переносит данные основания; произвольное СоздатьДокумент не гарантирует её вызов.
- ОбработкаПроверкиЗаполнения помогает человеку заполнить форму; программная запись не гарантирует эту проверку. Обязательные правила любой записи обеспечиваются серверным объектом.
- ПередЗаписью выполняет дозаполнение и проверки до сохранения самого объекта. Сравнивать прежние значения нужно до их замены.
- ПриЗаписи обрабатывает зависимые данные после записи объекта. Изменение собственных реквизитов здесь не является их сохранением.
- ОбработкаПроведения формирует движения факта. ПриЗаписи документа вызывается раньше неё.
- ОбработкаУдаленияПроведения обслуживает отмену. Не считать её зеркальной последовательностью проведения.
Для набора записей обработчики относятся к набору целиком, включая пустой набор. Не выводи количество бизнес-событий из количества вызовов обработчика. Поведение менеджера записи и режима замещения уточняй для версии платформы и конкретного регистра.
План, факт и повтор
Выбери устойчивое основание факта: задание, заказ или этап. Определи единицу измерения и период. Остаток задания вычисляй по проведённым фактам, а не через прибавление счётчика при каждом сохранении формы.
Движения формируй по сохранённым данным документа. Для обычного проведения достаточно заполнить коллекцию Движения и пометить нужный набор Записывать. Явная запись может требоваться алгоритму контроля остатков — обоснуй её, порядок блокировки и проверки; не переносить запрет или образец механически.
Повторное проведение должно заменять движения данного регистратора. Отмена должна удалять его вклад согласно настройке удаления движений, сохраняя чужой выпуск. Не присваивай Проведен вручную вместо штатного режима записи.
Если запрещён перевыпуск, блокируй область задания перед чтением доступного остатка и учитывай прежний вклад перепроводимого документа. Простое чтение остатка без блокировки не обеспечивает параллельную сдачу двумя мастерами. Внешние вызовы и ожидание человека вынеси из транзакции.
ОбменДанными.Загрузка рассматривай по контракту обмена: пропуск действий допустим, когда нужные движения и инварианты обеспечивает обмен. Безусловный Возврат способен оставить факт без учётного отражения.
Форма и проверка результата
Рабочее место показывает задание, план, сдано, осталось и список документов факта. Главное действие — оформить очередную сдачу. Документ из списка открывается; подписи и единицы понятны мастеру. Форму собирай средствами EDT MCP, не отдельным макетом, изображающим 1С.
Проверь на локальной тестовой базе два отдельных факта одного задания, повторное проведение первого и отмену второго. Сравни движения по регистратору и итог задания; проверь сохранность соседнего задания. Пользователь должен получить рабочую сдачу и остаток, а не только текст «тест зелёный».
Проверка исходников не доказывает выполнение. Не запускать новые клиенты для каждого чтения: используй установленный Runner и один принадлежащий задаче сеанс. При свежем исключении прочитай модуль и строку, исправь причину и только затем повтори операцию.
Разработка пакетов, тестов и сервисов на OneScript и Autumn
Используй навык, когда задача относится не к конфигурации внутри платформы 1С:Предприятие, а к скриптам, библиотекам, CLI-инструментам или серверам на OneScript (oscript), пакетному менеджеру opm и DI-фреймворку Autumn.
Контракт пакета OneScript и packagedef
- Проверь структуру пакета по файлу
packagedef: имя пакета, семантическая версия, поддерживаемая версия движкаoscript(учитывай различия линейки 1.x и 2.x), точки входа исполняемых команд, экспортируемые классы/модули и список зависимостей (Зависимость(...)). - Не полагайся на глобально установленные на машине разработчика пакеты, не объявленные в
packagedef, и не хардкодь локальные пути кoscript_modulesвне стандартного разрешения библиотек (oscript.cfg/lib.system/lib.additional). - Проверка чистоты поставки: собранный пакет
.ospxдолжен устанавливаться и запускаться в чистом временном каталоге без доступа к исходному репозиторию разработки (чтобы вовремя обнаружить забытые файлы, регистрозависимые пути на Linux/macOS против Windows и неуказанные транзитивные зависимости). - Для консольных и
stdio-протоколов (например, JSON-RPC / MCP поверхКонсоль) строго разделяй стандартный поток выводаstdout(только валидные сообщения протокола без отладочныхСообщить(...)и BOM) и поток ошибок/диагностикиstderr.
Модульное и сценарное тестирование (OneUnit и 1testrunner)
- Установи, какой именно тестовый раннер использует репозиторий (
oneunitс аннотациями&Тест/&ПередКаждымили1testrunnerсЗагрузитьИПроверить/ экспортными процедурами тест-кейсов), и следуй его контракту жизненного цикла — не смешивай соглашения двух фреймворков в одном тестовом модуле. - Обеспечивай полную изоляцию фикстур: временные файлы, каталоги, дочерние процессы и переменные окружения создавай в уникальной временной директории теста и гарантированно очищай в блоке
Попытка ... Исключение ... КонецПопытки/&ПослеКаждого. Падение одного теста не должно оставлять заблокированный порт, висящий дочерний процесс или мусор для следующего теста. - Тестируй как штатный путь, так и граничные отказы (невалидный JSON/аргумент CLI, отсутствующий файл, ненулевой код возврата внешней команды).
Компонентные границы во фреймворке Autumn
При использовании контейнера внедрения зависимостей Autumn (Поделка, Деталь, Фабрика, аннотации жизненного цикла):
- Чётко разделяй компоненты инфраструктуры (транспорт, логгер, работа с ФС/процессами) и компоненты предметной логики; передавай зависимости через внедряемые поля/сеттеры контейнера, а не через скрытые глобальные синглтоны.
- Проверяй область жизни компонента (одиночка на процесс или новый экземпляр на запрос/команду): изменяемое состояние конкретного запроса не должно храниться в полях разделяемого компонента-одиночки.
- При расширении сторонних библиотек экосистемы (например,
autumn-mcp,logos,cli) локальные исправления до принятия апстримом оформляй воспроизводимым патчем поверх зафиксированной версии вopm/mise.toml, а не ручным редактированием каталогаoscript_modulesбез фиксации.
Производительность, оптимизация кода и кластер серверов 1С
Используй навык, когда операция 1С выполняется медленно, нагружает СУБД или сервер приложений, требует выноса расчёта в фоновое задание (ДлительныеОперации) либо расследования зависших сеансов и процессов кластера 1С.
Синтаксис и прикладную логику самих запросов сверяй с навыком onec-query-composition, а инструменты профилирования EDT — с edt-mcp-project-profiling.
Достоверный замер до и после оптимизации
- Никогда не оценивай скорость запроса и формы только под «Полными правами» и на пустой демо-базе: у реального пользователя к каждому запросу с
РАЗРЕШЕННЫЕплатформа присоединяет подзапросы RLS, которые меняют план выполнения СУБД на порядки. Замер проводи под целевым профилем прав и на сопоставимом объёме данных. - Различай в профилировщике и замере чистое собственное время строки и суммарное время с вложенными вызовами, а также количество вызовов строки (
КоличествоВызовов): быстрый запрос на5 мс, вызванный4 000раз внутри цикла по строкам документа, даёт20 сзадержки. - Отличай холодный и прогретый кэш СУБД/платформы при сравнении вариантов «до / после».
Главные антипаттерны запросов и обхода коллекций в BSL
- Разыменование ссылок через точку в цикле (
Строка.Номенклатура.ВидНоменклатуры.СтавкаНДС) и вызовы запросов внутри цикла: каждое обращение через точку к объекту вне кэша порождает отдельный запрос чтения всего объекта из СУБД (N+1). Выгрузи массив ссылок черезТаблица.ВыгрузитьКолонку("Номенклатура")и прочитай все нужные реквизиты одним пакетным запросом вСоответствие. - Опасная механическая замена
ИЛИнаОБЪЕДИНИТЬ ВСЕ:ИЛИв условии соединения илиГДЕчасто мешает использованию индекса СУБД, но разбиение на ветвиОБЪЕДИНИТЬ ВСЕдопустимо только при непересекающихся условиях ветвей (или с явным исключением пересеченияИ НЕ (...)), иначе строки, удовлетворяющие обоим условиям, удвоятся и исказят суммы! - Сужение составного типа ссылки: условие вида
Таблица.Регистратор ССЫЛКА Документ.РеализацияТоваровУслугили обращение к реквизиту составного поля без предварительного отбора типа заставляет платформу соединять десятки таблиц всех возможных типов регистраторов (LEFT JOINко всем документам). Сужай тип или передавай типизированные параметры на самом раннем шаге пакета. - Параметры виртуальных таблиц регистров: условия отбора по измерениям и срез периода передавай внутрь параметров виртуальной таблицы
Остатки(&Момент, Номенклатура В (&СписокНоменклатуры)), а не в секциюГДЕвнешнего запроса (вГДЕплатформа сначала рассчитает остатки по всей базе, а затем отфильтрует их). - Временные таблицы и индексы: помещай промежуточные выборки во временные таблицы (
ПОМЕСТИТЬ ВТ_...) сИНДЕКСИРОВАТЬ ПОпо полям последующих соединений, а после последнего использования освобождай большие таблицы черезУНИЧТОЖИТЬ ВТ_..., чтобы не раздуватьtempdb/ временное табличное пространство СУБД.
Длительные операции и временное хранилище
Для операций дольше нескольких секунд в управляемой форме используй штатную подсистему ДлительныеОперации БСП (не блокируй клиент синхронным серверным вызовом):
- Передавай тяжёлые данные и итоговый результат (сформированный
ТабличныйДокумент, файл, таблицу ошибок) между фоновым заданием и формой черезПоместитьВоВременноеХранилище(..., ИдентификаторФормы), а после чтения результата очищай временное хранилище (УдалитьИзВременногоХранилища), чтобы не допускать утечки памяти рабочего процесса. - Таймаут ожидания на клиенте не отменяет серверное фоновое задание автоматически: если пользователь закрыл окно ожидания или истёк клиентский таймер, явно предусмотренная команда отмены должна вызывать штатную отмену задания, а обработчик завершения
ОписаниеОповещенияобязан проверять актуальность открытой формы и идентификатора запущенной операции.
Сеансы, соединения и процессы кластера серверов 1С
При расследовании зависаний, утечек памяти и блокировок на сервере не смешивай сущности кластера:
| Сущность | Роль и диагностический смысл |
|---|---|
ragent | Агент сервера 1С на хосте — запускает и контролирует менеджеры и рабочие процессы узла |
rmngr | Менеджер кластера — хранит реестр кластера, управляет сеансами, лицензиями, управляемыми блокировками (TLOCK) и балансировкой |
rphost | Рабочий процесс — непосредственно исполняет код BSL, строит запросы к СУБД и держит память контекстов вызовов |
| Сеанс (Session) | Логическое состояние работы пользователя или фонового задания в кластере (может сохраняться в гибернации без активного соединения) |
| Соединение (Connection) | Активный сетевой канал клиента/фонового потока с конкретным rphost или СУБД в данный момент |
Не перезапускай весь ragent и не убивай rphost по имени образа вслепую ради одного зависшего отчёта: это оборвёт транзакции и несохранённую работу всех сеансов на этом рабочем процессе. Сначала сопоставь номер сеанса, активный серверный вызов, блокирующего владельца и запрос СУБД.
Парный инструментальный навык EDT-MCP
- Для проведения контролируемого замера производительности через профилировщик EDT-MCP применяй в паре
edt-mcp-project-profiling.
Печатные формы, макеты MXL и подсистема печати БСП
Используй навык, когда требуется создать или изменить печатную форму документа/справочника, настроить макет табличного документа (.mxl), подключить команду печати к БСП (УправлениеПечатью) или устранить дефект вывода/форматирования печатного бланка.
Чтение и изменение метаданных объекта, макетов и модулей выполняй через edt-mcp, а проверку сформированного печатного бланка по эталону — через навык onec-vanessa-scenario.
Устройство макета табличного документа (MXL)
До написания кода модуля менеджера изучи структуру макета:
- Горизонтальные и вертикальные области: обычные полосы бланка (
Шапка,ШапкаТаблицы,Строка,Подвал) задаются именованными областями строк. Если количество колонок динамическое, используются пересечения областей строк и колонок:Макет.ПолучитьОбласть("Строка|КолонкаДанных")и вывод по горизонтали черезТабДок.Присоединить(ОбластьЯчейки). - Режим свойства
Заполнениеячейки — частая причина пустых значений или литералов вместо данных:Текст— выводит строку ячейки как есть, игнорируяОбласть.Параметры;Параметр— выводит значение одноимённого свойства изОбласть.Параметры.<Имя>с сохранением типа (число, дата, формат ячейки);Шаблон— подставляет параметры в квадратных скобках внутри текста, напримерДоговор № [НомерДоговора] от [ДатаДоговора].
- Расшифровка (
ПараметрРасшифровки): если ячейка содержит ссылку на документ, контрагента или номенклатуру, заполняй параметр расшифровки, чтобы двойной щелчок в печатной форме открывал карточку объекта. - Параметры страницы и разрывы: проверяй
АвтоМасштаб(ПоШиринеСтраницы=Истинадля широких накладных/актов), ориентацию листа (Портрет/Ландшафт),ПовторятьПриПечатиСтрокидля шапки многостраничной таблицы иПроверитьВывод(МассивОбластей)перед выводом подвала с подписями, чтобы блок подписей не отрывался на пустой последний лист без единой строки таблицы.
Контракт подсистемы УправлениеПечатью БСП
В конфигурациях на БСП печать размещается в модуле менеджера объекта (или в модуле объекта внешней печатной формы), а не в модуле управляемой формы документа!
- Регистрация команды в
ДобавитьКомандыПечати(КомандыПечати):- Укажи уникальный
Идентификатор(совпадающий с именем макета или списком макетов через запятую), локализованноеПредставление(НСтр),Обработчик(если отличается от стандартногоПечать),СписокФорм(при ограничении показа),ПроверкаПроведенияПередПечатьюи параметры комплекта.
- Укажи уникальный
- Формирование в процедуре
Печать(МассивОбъектов, ПараметрыПечати, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода):- Всегда проверяй
УправлениеПечатью.НужноПечататьМакет(КоллекцияПечатныхФорм, "<ИмяМакета>")в начале ветки каждого макета; - Передавай сформированный табличный документ через
УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию(КоллекцияПечатныхФорм, "<ИмяМакета>", "<Синоним>", ТабДок, , "<ПолноеИмяМакета>"); - Заполняй соответствие области каждого документа через
УправлениеПечатью.ЗадатьОбластьПечатиДокумента(ТабДок, НомерНачальнойСтроки, ОбъектыПечати, СсылкаНаДокумент)— без этого сломаются постраничная разбивка пакета, сохранение присоединённых PDF и отправка по ЭДО/почте!
- Всегда проверяй
Пакетная выборка данных: ни одного запроса в цикле по МассивОбъектов
Процедура Печать обязана одинаково быстро печатать и один документ из карточки, и пачку из 200 документов из формы списка:
- Выполни один пакетный запрос с условием
ГДЕ Док.Ссылка В (&МассивОбъектов)(поместив шапки во временную таблицу и отдельным пакетом выбрав строки табличной части, упорядоченные поСсылка, НомерСтроки); - При выводе пачки вставляй горизонтальный разделитель страниц
ТабДок.ВывестиГоризонтальныйРазделительСтраниц()между документами; - Сумму прописью, склонения, представление валюты, ФИО подписантов и телефон/адрес организации получай пакетно или из подготовленного кэша по организациям пачки, не вызывая БСП-функции чтения базы на каждой строке товара.
Внешние печатные формы и проверка результата
- При поставке печатной формы как внешней обработки (
.epf) добавь в модуль объектаСведенияОВнешнейОбработке()сВид = УправлениеПечатью.ТипКомандыПечати()/"ПечатнаяФорма", перечисли целевые метаданные вНазначениеи соблюдай контрактПечать(...)с тем же набором параметров (см. навыкonec-external-processors-and-delivery). - Для приёмки сформируй печатную форму на контрольном документе в клиенте тестирования (тонком или веб-клиенте) и сверь видимые строки или
.mxl-эталон черезonec-vanessa-scenario: простого отсутствия синтаксических ошибок в модуле менеджера недостаточно.
От хозяйственного вопроса к запросу
Начни с результата для роли: какую строку человек должен увидеть и какое действие выполнить. Для обеспечения производства это материал в задании, его потребность, свободное количество и заявка на недостающее. Не заканчивай текстом SQL, если человеку нужен рабочий список.
Установи смысл данных
Через существующий EDT MCP прочитай реальные имена объектов, реквизитов, табличных частей, измерений, ресурсов, единиц и связей. Прочитай код заполнения источников. Не подставляй знакомые имена из другой конфигурации. Установи:
- что представляет одна строка каждого источника;
- по каким ссылкам источники связаны, где связь один-ко-многим;
- на какой момент, по какой организации, складу и заданию нужен результат;
- что означает количество: норма на изделие, потребность на выпуск, физический остаток, резерв или свободный остаток;
- какие данные и права доступны роли. Недоступные строки не равны нулевому остатку.
Для упрощённого снимка остатков явно назови его снимком, не выдавай его за регистр движений полноценного складского учёта. Не читай уже рассчитанную потребность как независимый источник факта.
Собери расчёт без размножения строк
Перед соединением приведи независимые источники к нужной детализации. Например, суммируй строки состава по материалу и единице, умножь норму на количество выпуска. Остатки и резервы агрегируй отдельно по тем же ключам. Соединение сырых табличных частей может умножить количество строк и суммы.
Соединяй ссылки совместимых типов, а не представления. Сравнение ссылки реквизита со ссылкой справочника в условии ПО допустимо. Одинаковые наименования не доказывают тождество объектов. РАЗЛИЧНЫЕ не исправляет неверную связь.
ЛЕВОЕ СОЕДИНЕНИЕ сохраняет потребность, для которой нет строки остатка. ЕСТЬNULL заменяет отсутствующий ресурс нулём только после установления его хозяйственного смысла. Отбор правой таблицы в ГДЕ способен убрать такую строку; условия склада ставь при подготовке источника или в ПО.
Свободное количество = физический остаток минус резервы по согласованной модели. Не вычитай резерв повторно из уже свободного остатка. Потребность и остатки должны иметь совместимые единицы; коэффициент пересчёта нельзя придумывать. Дефицит неотрицателен, но отрицательный остаток не прячь без объяснения. В заявку включай только положительный дефицит.
Язык и исполнение
Пиши многострочный запрос с понятными псевдонимами. Внешние значения передавай параметрами, включая ссылки и перечисления; не склеивай текст пользовательского ввода. СГРУППИРОВАТЬ ПО задаёт детализацию, ИМЕЮЩИЕ отбирает группы, ИТОГИ добавляет итоги. Для промежуточных наборов используй пакет и временные таблицы там, где это упрощает модель.
Сигнатуру виртуальной таблицы уточняй для её вида и версии платформы. Запятые разделяют позиционные параметры; несколько условий одного параметра соединяются И. Отбор до СрезПоследних и после среза имеет разный смысл. Не переносить условия механически ради скорости.
Не заменяй ИЛИ на ОБЪЕДИНИТЬ ВСЕ без анализа пересечения ветвей. Индексирование временных таблиц обосновывай объёмом и использованием. Не объявляй синтаксически допустимые вложенные соединения запрещёнными. Оптимизацию подтверждай замером на целевой базе, а не универсальным порогом строк.
РАЗРЕШЕННЫЕ может скрыть часть результата. Не повышай привилегии ради быстрого запроса и не объявляй скрытые данные отсутствующими. Согласуй полноту результата с правами роли.
Узнай доступные инструменты через каталог MCP. Для статической проверки используй validate_query, если он реально доступен, передав проект и queryText либо modulePath. Не выдумывай execute_query: выполнение в базе обеспечивается доступным штатным Runner или прикладным кодом. Проверка синтаксиса не доказывает правильность результата.
Доведи до рабочего действия
Добавь в форму понятные колонки с единицами, основание расчёта и главное действие. Сохрани заявку как документ, связанный с заданием; повторное нажатие не должно незаметно создавать вторую заявку. Перед записью пересчитай данные, не доверяй редактируемой таблице клиента. Расчёт потребности не резервирует товар сам по себе.
На контрольных данных проверь материал без остатка, несколько строк одного материала, достаточный остаток, резерв и чужой склад. Проверь созданную заявку и повтор действия. Сохрани фактический результат штатного теста; изображение с надписью «пройдено» не является отчётом прогона. Отдельно сообщи, что проверено в исходниках, а что выполнено в 1С.
Парный инструментальный навык EDT-MCP
- Для статической проверки запросов (
validate_query) и работы со схемами запросов в EDT применяй в пареedt-mcp-project-query-dcs.
Регуляторные процессы РФ в 1С: ЭДО, ЭП/МЧД, Честный ЗНАК и ЕГАИС
Используй этот навык при разборе сбоев и проектировании доработок в подсистемах электронного документооборота (ЭДО), электронной подписи и МЧД, интеграции с Государственной системой маркировки (ГИС МТ / СУЗ «Честный ЗНАК», Национальный каталог) и ЕГАИС (УТМ).
1. Четыре независимых уровня состояния (главный инвариант диагностики)
Никогда не своди статус регуляторной операции к одному флагу «проведён / отправлен». Всегда явно разделяй четыре уровня истины:
| Уровень | Что хранит 1С | Типичная ошибка смешения |
|---|---|---|
| 1. Учётный документ 1С | Ссылка, Проведен, движения по регистрам склада, взаиморасчётов и НДС | Считать, что проведённая РеализацияТоваровУслуг означает принятый покупателем УПД или выведенные из оборота марки. |
| 2. Транспортный пакет ЭДО | Текущий электронный документ ЭДО, идентификатор пакета у оператора ЭДО, входящие/исходящие квитанции (извещение о получении, титул покупателя, уведомление об уточнении) | Переформировывать новый электронный документ с новым ИдентификаторДокумента вместо штатного исправления/УКД, когда первый пакет уже подписан и ушёл оператору. |
| 3. Криптография: ЭП и МЧД | Отпечаток сертификата КЭП, штамп времени, регистрационный номер МЧД в распределённом реестре ФНС, полномочия подписанта и срок действия | Искать ошибку в XML-формате УПД ФНС, когда отказ вызван просроченной МЧД, несовпадением ИНН доверителя/представителя или отсутствием привязки МЧД к организации в настройках ЭДО БСП. |
| 4. Госреестр прослеживаемости (ГИС МТ / СУЗ / УТМ ЕГАИС) | Коды маркировки (КИЗ, КИГУ, транспортные КИТУ/SSCC), текущий владелец кода (ИНН участника оборота), статус марки (EMITTED, APPLIED, INTRODUCED, RETIRED), справки 2 / регистры ЕГАИС | Пытаться провести отгрузку или возврат марок, которые по данным ГИС МТ числятся за другой организацией, не введены в оборот или агрегированы в неразархивированный транспортный короб SSCC. |
2. ЭДО (УПД / УКД) и связка с НДС и складским учётом
- Версия формата ФНС и вид документа (
СЧФДОП/ДОП/СЧФ):- Проверяй актуальный формат электронного УПД/УКД (например, приказы ФНС 970 / 736 и переходные периоды форматов) по настройкам соглашения ЭДО с контрагентом в конкретной версии БСП / библиотеки БЭД. Не зашивай устаревшую версию XSD-схемы константой в модуль.
- Титул продавца и титул покупателя:
- В исходящем ЭДО учётные движения реализации обычно формируются при отгрузке, но при наличии маркируемых товаров передача прав на
КИЗв ГИС МТ завершается только после подписания обоих титулов и обработки пакета оператором ЭДО (или прямой подачи сведений с учётом режима учёта: поэкземплярный vs объёмно-сортовой ОСУ).
- В исходящем ЭДО учётные движения реализации обычно формируются при отгрузке, но при наличии маркируемых товаров передача прав на
- Уведомление об уточнении vs Корректировочный документ (УКД) vs Исправление УПД:
- Различай: исправление ошибки первичного УПД (исправительный счёт-фактура / УПД(и) к исходному номеру) и согласованное изменение цены/количества (УКД). Ручное удаление связки регистра ЭДО ради повторной отправки «с нуля» по уже подписанному документу создаёт юридический дубль у оператора ЭДО и расхождение книги продаж/покупок НДС.
3. Электронная подпись (ЭП) и МЧД в 1С
При подписании сертификатом физического лица от имени юрлица/ИП обязательно проверяй цепочку МЧД:
- Соответствие троицы:
ИНН/ОГРН организации-доверителяв документе ↔СНИЛС/ИНН физлица в сертификате КЭП↔Номер и статус МЧД (формат 003 / ФНС)в справочнике МЧД 1С. - Способ передачи МЧД оператору ЭДО: передаётся ли в пакете только регистрационный номер МЧД и ИНН (автопроверка из реестра ФНС) или требуется приложенный файл XML доверенности с откреплённой подписью руководителя.
- Серверное vs клиентское подписание: криптопровайдер (КриптоПро CSP и внешняя компонента криптографии БСП) обычно доступен в тонком клиенте у рабочего места пользователя, а не в серверном фоновом задании (если не настроен серверный контур DSS / обезличенный сертификат информационной системы). Не переноси интерактивный вызов подписания в
&НаСерверебез проверки архитектуры криптографии проекта — см.onec-bsp-api.
4. Маркировка «Честный ЗНАК» (ГИС МТ / СУЗ) и розничное выбытие (ККТ)
Структура кодов DataMatrix и экранирование GS1 (Символ(29))
- Полный код маркировки с криптохвостом содержит разделители групп GS (
ASCII 29/\u001d) между идентификаторами применения (01GTIN,21серийный номер,91/92криптопроверка,93код проверки). - Критическая ошибка доработок: обрезка или потеря непечатаемого символа
Символ(29)при передаче строки черезСокрЛП, HTML-поля, CSV-обмен или неэкранированный JSON/XML!- Для проверки статуса и передачи в УПД часто используется КИЗ (
01<GTIN>21<Serial>без криптохвоста), а для ввода в оборот, нанесения и проверки на кассе (ККТ / разрешительный режим) требуется полный код с крипточастью и сохранённымиGS(Символ(29))! Всегда проверяй, какую именно часть марки ожидает вызываемый метод библиотеки интеграции с ГИС МТ (ИСМП).
- Для проверки статуса и передачи в УПД часто используется КИЗ (
Поэкземплярный учёт vs Объёмно-сортовой учёт (ОСУ)
- В УПД по ОСУ передаётся
GTINи количество (02+37), без перечисления индивидуальныхКИЗ, тогда как поэкземплярный учёт требует точного совпадения каждой марки в таблице проверки/подбора с товарной строкой и упаковкой (КИТУ/SSCC). - При приёмке короба (
SSCC) без предварительной разагрегации вложенные индивидуальные марки наследуют операции упаковки; продажа отдельной единицы из вскрытого короба корректно отрабатывает, но повторная отгрузка того жеSSCCцеликом упадёт по составу агрегата.
Розничная продажа, РМК и разрешительный режим на кассе
- На кассе (РМК) различай три шага: (1) онлайн/офлайн проверка марки в разрешительном режиме (CDN ГИС МТ и локальный модуль ЧЗ) с сохранением
reqIdиreqTimestampв тег1265чека ККТ → (2) фискализация тега1162/ уведомления о реализации маркированного товара ОФД → (3) проведениеОтчетаОРозничныхПродажах/ЧекаККМв 1С. - Отказ фискального накопителя или запрет продажи на шаге (1) не должен списывать марку из регистра кодов маркировки ИБ как проданную.
5. ЕГАИС (УТМ)
- ТТН ЕГАИС проходит через локальный транспортный модуль УТМ (входящие/исходящие XML-документы в очереди УТМ, фиксация в ЕГАИС, акты подтверждения / расхождения / отказа, помарочный учёт акцизных марок PDF417 / DataMatrix).
- Защита от дублей и потери тикетов УТМ: УТМ удаляет обработанные документы из транспортной очереди по правилам настройки; перед повторной отправкой ТТН всегда проверяй входящие квитанции (
Ticket) поTransportIdи регистрационному номеруTTNInformF2Regв регистрах обмена с ЕГАИС.
Связанные навыки
- Подсистемы ЭП, МЧД и защиты ПДн в БСП:
onec-bsp-api - Протоколы обмена, идемпотентность очередей и XDTO:
onec-integration-and-exchangeиonec-xdto-import - Диагностика движений и учётных расхождений КА/ERP (включая НДС и склад):
onec-ka-incident-router
Потребность, возможность программы и приемка
Я как аналитик 1С хочу сопоставить учетное требование с возможностями конфигурации, настроить достаточный механизм и принять его на хозяйственной операции, чтобы избежать ненужной доработки и сохранить неизменяемый учет.
Отдели потребность человека от предложенного способа реализации. Просьба вести учет в новом разрезе еще не означает создать справочник, регистр или интеграцию. Сохрани исходные условия: роль, хозяйственную операцию, виды учета, период, ожидаемый результат и то, что должно остаться неизменным.
Настройка или изменение программы
Через доступные инструменты исследуй фактическую конфигурацию, ее расширения, формы, функциональные опции и код потребляющего механизма. Наличие объекта с подходящим именем не доказывает возможность: проследи, кто читает настройку, при какой операции и как она влияет на запись или результат.
Сопоставь варианты: имеющаяся команда/настройка, изменение НСИ, организационное действие, программное изменение. Выбирай минимальное достаточное действие по доказанному поведению. Если типовая возможность уже покрывает потребность, покажи, где ее настроить, и продемонстрируй результат на разрешенных данных. Если найден разрыв, назови конкретный неподдержанный сценарий, а не перечень объектов, которые можно написать. Не изменяй код по одному вопросу о его работе; учитывай отдельно выданное разрешение на изменения тестового окружения.
Границы учетного требования
Не смешивай бухгалтерский и управленческий учет, дату запрета изменений, завершение регламентных расчетов и границу последовательности. Их связь надо установить в коде конкретной конфигурации. Перенос даты запрета сам по себе не восстанавливает последовательность и не пересчитывает проводки.
Для изменения закрытого периода сначала установи допустимый вид учета и отдельный механизм контроля. Не предлагай автоматически открыть все периоды или обойти контроль обменом данных. Проверь также отрицательный результат: операция, которая должна остаться запрещенной, по-прежнему запрещена.
Проверь направление ограничения на конкретной дате: если запрещены записи по 31 октября включительно, для открытия октября границу переносят на 30 сентября. Перенос на декабрь дополнительно закрывает период, а не открывает. Результат изменения каждой настройки сверяй с исходной хозяйственной операцией.
Приемка через наблюдаемый результат
Раздели исходное состояние, действие и ожидаемый результат. Срок поставки, дата хозяйственной операции и период действия правила — разные условия. Не придумывай недостающие сроки или бизнес-правила. Для противоречивых требований сначала проверь, одинаковы ли организация, вид учета и период.
По запросу на проверку подготовь исполнимый сценарий с подходящим навыком тестирования. Проверка интерфейса выполняет пользовательскую команду и проверяет видимый результат; проверка регистров сравнивает реальные записи и границы до/после. Добавь контроль сохранности второго вида учета и повторного выполнения, если они входят в требование. Снимок формы не заменяет эти проверки.
Итог для аналитика: что уже умеет программа, какое действие нужно выполнить, что проверено на стенде и какое ограничение осталось. Локальная кастомная реализация не доказывает, что так же работает неизвестная типовая ERP или УХ.
Обычный вопрос и границы вывода
Пользователь задает хозяйственный вопрос и не обязан указывать навык, MCP, путь к исходникам или процедуру проверки. Среду определяй по открытому проекту и настройкам окружения; уточняй только недостающие предметные условия. Подтверждай, что исследуются основная конфигурация и нужные расширения этой среды.
Найденная настройка означает возможность, но еще не доказанное выполнение операции. Отдельно сообщай: что следует из кода, что настроено в базе и что подтверждено выполненным сценарием. Не добавляй микродоработку в учетные правила ради демонстрации. Разрешенное улучшение формы должно сохранять эти правила.
Вопрос как запрос на развитие
В контексте уже разрешённого развития решения переводи вопрос аналитика в небольшое полезное поведение: кто начинает действие, что программа добавляет и чем заканчивается работа человека. Не подменяй реализацию перечнем проверок. Например, пожелание менеджера об особых условиях клиента приводит к карточке с датой действия и заполнению нового заказа; согласованные заказы сохраняют свои условия. Недостающие цены не выдумывай: тестовые значения явно обозначай. Явный режим «только объяснить, без изменений» сохраняется.
Дополнительная памятка
Развёртывание стенда и подключение базы 1С
Используй этот навык, когда пользователь просит проверить или завершить настройку плагина 1c-ai-pipeline, присылает свои имя и корпоративный e-mail, присылает ссылку на конфигурацию 1С от релиз-инженера, пишет «я поставил EDT», просит разобраться с недоступным EDT MCP или Vanessa Runner, либо хочет начать работу со своей тестовой базой 1С:КА, 1С:ЗУП, 1С:ERP или другой конфигурацией 1С.
1. Правила безопасности и общения с пользователем
- Пользователь не обязан знать Git, SSH или командную строку:
- Никогда не проси пользователя вручную вводить
git config,git clone,ssh-keygenв терминале. - Спрашивай простым языком только человеческие данные (Имя и Фамилию, корпоративный e-mail, ссылку от релиз-инженера, путь к тестовой копии базы), а все команды выполняй сам.
- Никогда не проси пользователя вручную вводить
- Никогда не работай на продуктивной (боевой) информационной базе — для диагностики, выгрузки исходников и автотестов используй только тестовую копию базы.
- Обязательно проверяй ручной первый запуск и лицензию 1С: перед автоматическими запусками уточни у пользователя, открывал ли он эту тестовую базу 1 раз вручную в «1С:Предприятии» и запускается ли она без окна лицензии (иначе фоновый запуск
1cv8черезVanessa Runnerповиснет на модальном диалоге пин-кода лицензии). - Не проси пароль от базы в открытом тексте чата, не создавай отчётных
.md/.txt-файлов об установке в папке пользователя и не останавливай запущенные процессы пользователя (1cv8,1cv8c,1cedt,rphost,rmngr,ragent). - На Windows запускай
winget,git,miseиpipeline-deploy.cjs deploy / deploy-edtвне песочницы клиента ИИ: песочница AppContainer в десктопных клиентах блокирует локальные loopback-сокеты JVM (Unable to establish loopback connection/sandbox_loopback_blocked) при сборке./edt-mcpи работеp2.director. При полученииsandbox_loopback_blockedсразу повтори команду вне песочницы.
2. Шаг 1 — Точная диагностика машины (doctor)
Запусти встроенный скрипт диагностики из корня установленного плагина (${PLUGIN_ROOT} или .agents/plugins/1c-ai-pipeline внутри клона vanessa-ai-pipeline):
node "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" doctor --json
Скрипт возвращает полную картину без догадок:
nodePath: исправностьnodeв системномPATHи наличиеmise;gitIdentity: установлен лиGitи заполнены лиuser.nameиuser.email(configured: true/false);platforms: найденные на диске версии платформы 1С:Предприятие 8 (8.3.x/8.5.x);vanessaRunner: путь кoscript,runner_root, зависимостиoscript_modulesи фактическое число ответивших инструментов MCP;vanessaAutomation: наличие клона и собранных обработок.epf;edt: точный статус связки с 1С:EDT (ready,edt_not_running,port_conflict,plugin_not_installed,edt_not_installed).
3. Шаг 2 — Автор Git, вход в корпоративный GitLab (SSH), скачивание и активация проекта в 1С:EDT
-
Если
gitIdentity.configured == false:- Спроси у пользователя в чате простым языком: «Как вас зовут (Имя и Фамилия) и какой у вас корпоративный e-mail?»
- Как только пользователь ответит, сам пропиши настройки командой:
(Команда также включаетnode "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" setup-git --name "Имя Фамилия" --email "user@company.ru"core.quotepath=false, чтобы русские имена объектов 1С читались без восьмеричных кодов.)
-
Проактивная подготовка SSH-ключа и вход пользователя в корпоративный GitLab:
- Не проси пользователя открывать терминал или запускать
ssh-keygen. Сам подготовь публичный ключ командой:
(Если пользователь уже назвал адрес GitLab или ссылку на репозиторий — сразу передайnode "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" setup-ssh--open-keys "<URL_ИЛИ_ХОСТ>", чтобы в его браузере автоматически открылась страницаhttps://<gitlab>/-/user_settings/ssh_keys.) - Покажи пользователю прямо в чате его готовую публичную строку
publicKey(ssh-ed25519 ..., закрытый ключ никогда не читай!) и проведи по 3 простым шагам:- Войти в корпоративный GitLab в открывшемся окне браузера (если доступа к проекту ещё нет — попросить релиз-инженера выдать доступ на корпоративную почту и прислать ссылку на проект);
- На странице Preferences → SSH Keys (
/-/user_settings/ssh_keys, в старых версиях GitLab —/-/profile/keys) вставить показанный ключssh-ed25519 ...в поле Key и нажать Add key; - Прислать в чат ссылку на проект из GitLab (кнопка Code → Clone with SSH или обычную ссылку из адресной строки браузера) и написать «ключ добавил».
- Не проси пользователя открывать терминал или запускать
-
Безопасное скачивание проекта (
clone-project) и активация в 1С:EDT:- Выполни скачивание вне песочницы через встроенную команду (она автоматически подставляет
StrictHostKeyChecking=accept-newиBatchMode=yes, чтобы Git не зависал на первом подключении к корпоративному GitLab, и умеет переключаться с HTTPS на SSH URL):node "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" clone-project --url "<ССЫЛКА_ИЗ_GITLAB>" --open-keys - Если вернулся статус
git_auth_or_ssh_required— передай пользователю готовую подсказкуuserActionRu(войти в открытое окно GitLab, нажать Add key, проверить доступ к проекту) и после его подтверждения повториclone-project --url "<ССЫЛКА_ИЗ_GITLAB>" --prefer-ssh. - Как только проект скачан (
status == "cloned"или"already_cloned"), обязательно доведи пользователя до активации проекта в 1С:EDT:- Сообщи пользователю точный путь к скачанной папке
targetDir(и список найденных внутри проектовedtProjects); - Попроси в окне 1С:EDT нажать: Файл → Импорт → 1С:Предприятие → Проекты 1С:Enterprise Development Tools в рабочую область → указать папку
targetDir→ отметить проект конфигурации (и при необходимости расширения) → нажать Готово; - Дождись индексации модели и подтверди готовность проекта вызовом
list_projects(status: "READY") иget_project_errorsвedt-mcp.
- Сообщи пользователю точный путь к скачанной папке
- Выполни скачивание вне песочницы через встроенную команду (она автоматически подставляет
4. Шаг 3 — Разбор статуса 1С:EDT и EDT MCP
Действуй строго по полю edt.status из вывода doctor --json:
Случай А: edt_not_installed (1С:EDT на компьютере не установлена)
- Открой страницу скачивания 1С:EDT прямо в браузере пользователя (если она ещё не была открыта на этапе
deploy --open-edt-download):node "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" open-edt-download - Сообщи пользователю простым языком:
- в его браузере открыта официальная страница https://edt.1c.ru/ (также доступно на https://releases.1c.ru/project/DevelopmentTools10 — скачивание бесплатное по обычной учётной записи
portal.1c.ru, платный договор ИТС не требуется; бесплатная комьюнити-лицензия при необходимости оформляется на https://developer.1c.ru/); - нужно скачать установщик 1C:EDT Start и через него поставить 1С:EDT
2025.2,2026.1или2026.2, один раз запустить и закрыть окно EDT, после чего написать в чат «EDT поставил»; - при этом ждать установки EDT не обязательно — начинать диагностику тестовой копии базы КА / ЗУП можно уже сейчас напрямую через Платформу 1С и
Vanessa Runner.
- в его браузере открыта официальная страница https://edt.1c.ru/ (также доступно на https://releases.1c.ru/project/DevelopmentTools10 — скачивание бесплатное по обычной учётной записи
Случай Б: plugin_not_installed (или пользователь написал «EDT поставил»)
- Убедись, что окна 1С:EDT сейчас закрыты, и выполни сборку из локального форка
./edt-mcpи установку во все найденные поддерживаемые версии 1С:EDT (2025.2,2026.1,2026.2) на диске (на Windows запускай вне песочницы):
Скрипт по умолчанию собирает p2-репозиторий из живых исходниковnode "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" deploy-edt./edt-mcpчерезmise(mise install+mise run build) и устанавливает плагинcom.ditrix.edt.mcp.server.feature.feature.groupчерезorg.eclipse.equinox.p2.directorсразу во все закрытые поддерживаемые установки 1С:EDT на компьютере. (Крайний резервный флаг--from-releaseдля скачивания архива из GitHub Releases используй только если на корпоративном ПК полностью заблокирован доступ к Maven.)
Случай Б2: edt_version_unsupported (на компьютере установлена только старая 1С:EDT младше 2025.2)
Попроси пользователя открыть уже установленный у него 1C:EDT Start, поставить актуальную версию 1С:EDT 2026.1 или 2026.2, один раз запустить и закрыть её и написать «EDT обновил», после чего выполни deploy-edt.
Случай В: port_conflict (порт 8765 занят посторонним процессом, например возвращает HTTP 404)
Ответ HTTP 404 на 127.0.0.1:8765 означает, что порт занят чужим локальным сервисом, а не сервером 1С:EDT. Используй свободный порт edt.suggestedPort из отчёта doctor (обычно 8766) через deploy-edt --port <порт> и синхронизируй URL подключения edt-mcp в настройках клиента (http://127.0.0.1:<порт>/mcp).
Случай Г: edt_not_running (плагин в 1С:EDT установлен, но окно 1С:EDT закрыто)
Поясни пользователю: vanessa-runner запускается чатом автоматически в фоне, а edt-mcp работает внутри открытого приложения 1С:EDT — чтобы появились инструменты edt-mcp, нужно запустить 1С:EDT с открытым проектом и дождаться готовности модели (list_projects → READY).
4а. Шаг 3а — Обязательная активация 1С:Напарник и проверка связи с EDT MCP
- Посмотри поле
edt.workmateизdoctor --json(а при открытой 1С:EDT — вызови инструментget_server_statusвedt-mcpи проверь объектworkmate):installed: установлен ли плагин1С:Напарник(com.e1c.edt.ai) в эту 1С:EDT;enabledиtokenConfigured: включён ли1С:Напарники введён ли ключ доступа;askWorkmateToolEnabled: включён ли инструментask_workmateв профилеEDT MCP.
- Если
workmate.status != "ready"(нет плагина, он выключен или не указан ключtokenConfigured == false):- Открой страницу получения ключа в браузере пользователя:
node "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" open-edt-download --workmate - Попроси пользователя простым языком (как при активации лицензии): «Зайдите на открывшуюся страницу https://code.1c.ai/, получите ключ доступа 1С:Напарник и вставьте его в окне 1С:EDT: Окно → Параметры → 1С:Напарник (сам ключ в чат не отправляйте). Когда сохраните настройки — напишите мне "ключ указал", я проверю связь».
- Открой страницу получения ключа в браузере пользователя:
- Контрольная проверка живой связки
EDT MCP ↔ 1С:Напарник:- Как только
get_server_statusпоказалworkmate.status == "ready"иtokenConfigured == true:- если
askWorkmateToolEnabled == false— вызовиenable_toolsetсtoolsets: ["workmate"](или попроси включитьask_workmateвОкно → Параметры → MCP Server); - выполни быструю безоператорную проверку моста без изменения проекта: вызови
ask_workmateсworkmateTool: "JShellSession",workmateArgs: "{}",waitSeconds: 15(при необходимости дождисьget_job_status) и подтверди пользователю, что1С:Напарникактивирован и связан сEDT MCP.
- если
- Как только
5. Шаг 4 — Лицензия и подключение тестовой базы (Файловая ИБ / Автономный сервер 1С ibsrv / Кластер)
-
Автоматический поиск баз и проверка ручного первого запуска:
- В выводе
doctor --jsonполеinfobasesуже содержит все базы пользователя изibases.v8iбез паролей (kind: "file","standalone_or_web","cluster_or_direct"), аplatforms[*].standaloneServerAvailableпоказывает наличиеibsrvиibcmd. - Убедись, что выбранная база — тестовая копия (не боевая!) и пользователь открывал её хотя бы 1 раз вручную в «1С:Предприятии» без окна лицензии (при необходимости открой https://developer.1c.ru/ командой
node "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" open-edt-download --license).
- В выводе
-
Если тестовая база развёрнута на Автономном сервере 1С (
ibsrv/ibcmd) — поддерживаются оба промышленных варианта:- Вариант А: Автономный сервер внутри
1С:EDT(wst-server):- Вызови
get_applications(projectName)вedt-mcp: для приложений типаcom.e1c.g5.dt.applications.type.wst-server(applicationKind: "standaloneServer") инструмент сразу вернётwebUrl,port,wsConnectionString(/WS"http://...") иinfobaseFile. - Если нужно обернуть существующую файловую базу в Автономный сервер EDT — используй
create_infobase(projectName=..., infobaseFile=..., applicationKind="standaloneServer", mode="register"). - Важно: для обновления БД на Автономном сервере EDT не вызывай голый
update_database— используй координированный запускlaunch(projectName=..., applicationId=..., updateBeforeLaunch=true)илиrun_yaxunit_tests(..., updateBeforeLaunch=true). - Для запуска клиента или автотестов через
Vanessa Runnerпо этому же серверу передавайibconnection: "<wsConnectionString>"(либо--ibsrv --ibsrv-attach --ibsrv-port <port>).
- Вызови
- Вариант Б: Внешний уже запущенный Автономный сервер
ibsrv(служба /config.yaml/ веб-строкаws=вibases.v8i):- В
run_enterpriseиtest_vanessaпередавайibconnectionнапрямую:/WS"http://localhost:8314/...",http://localhost:8314/...или строкуws="http://..."изibases.v8i(либо флаги--ibsrv --ibsrv-attach --ibsrv-port <порт>— при завершенииVanessa Runnerне останавливает чужой процессibsrv). - Пока процесс
ibsrvзапущен и держит монопольную блокировку1Cv8.1CD, не вызывай пакетный Конфигуратор (1cv8 DESIGNER /F...) напрямую по файлу; для офлайн-операций черезibcmd(cf_load,cfe_load,infobase_update,cf_dump) при остановленномibsrvпередавай флаг--ibcmdи путь кconfig.yamlавтономного сервера (или каталог базы) вibconnection.
- В
- Вариант В: Подъём временного
ibsrvсамимVanessa Runnerповерх файловой ИБ:- Передавай файловый путь
/F"..."вместе с флагом--ibsrv(при необходимости--ibsrv-debug/--ibsrv-direct): раннер сам выберет свободный порт, подниметibsrv, прогонит сценарий и штатно погасит свой экземпляр сервера.
- Передавай файловый путь
- Вариант А: Автономный сервер внутри
-
Старт работы по задаче:
- В связке с
1С:EDTубедись черезlist_projects, что проект в статусеREADY, а в режиме прямой работы с ИБ используйvanessa-runnerи предметные навыки (onec-requirements-analysis,onec-ka-incident-router,onec-zup-payroll-diagnosticsи др.).
- В связке с
6. Как дорабатывать и патчить компоненты локально
Все 4 компонента развёрнуты в живых Git-клонах, чтобы ИИ-исполнитель мог исправлять их на месте:
- Навыки (
skills/) и перехватчики (hooks/): правь в клонеvanessa-ai-pipeline(.agents/plugins/1c-ai-pipeline) и переподключай плагин (codex plugin add 1c-ai-pipeline@1c-ai-pipeline). - Плагин
EDT MCP: правь исходники в./edt-mcp, закрывай окно 1С:EDT и запускайnode "<PLUGIN_ROOT>/bin/pipeline-deploy.cjs" deploy-edt --rebuild. Vanessa Runner: правь.os-исходники в./vanessa-runner—runner_rootуказывает прямо на этот клон.Vanessa Automation: правь исходники в./vanessa-automationи пересобирай обработки черезmise run compile.
Технологический журнал (logcfg.xml), журнал регистрации и диагностика сбоев 1С
Используй навык, когда на стенде или в рабочей базе возникают ошибки конфликта блокировок при выполнении транзакции, взаимоблокировки (Deadlock), необработанные исключения фоновых заданий, обрывы сеансов или деградация запросов, требующие разбора событий платформы и сопоставления их с кодом в edt-mcp.
Для интерактивного замера строк BSL в сеансе используй edt-mcp-project-profiling, а для пошаговой остановки на строке — edt-mcp-project-runtime-debug.
Безопасная настройка технологического журнала (logcfg.xml)
Никогда не включай на рабочей сервере сбор всех событий SDBL и DBMSSQL/DBPOSTGRS с Context без фильтров по длительности или информационной базе: это за минуты переполняет диск и кратно замедляет рабочий процесс rphost.
Собирай только минимальный целевой профиль под конкретный симптом, всегда ограничивая history (например, 4–24 часа) и отбор ib (p:processName="<ИмяИБ>"):
| Симптом | События logcfg.xml | Обязательные свойства и фильтры |
|---|---|---|
| «Конфликт блокировок при выполнении транзакции» / ожидания | TLOCK, TTIMEOUT, TDEADLOCK (+ SDBL только с порогом длительности) | Для TTIMEOUT и TDEADLOCK события редкие — собирай все (property name="all"), чтобы получить WaitConnections и стек Context |
| Скрытые исключения, падения регламентных заданий и HTTP-сервисов | EXCP, EXCPCNTX | Фильтр по имени базы p:processName; читать Descr и Context |
| Медленные запросы к СУБД | DBPOSTGRS / DBMSSQL, SDBL | Обязательный фильтр длительности (например, Durationus >= 1000000 — от 1 с в микросекундах! Помни, что единица Duration зависит от версии платформы — сверяй разрядность в файле ТЖ) |
| Тяжёлые серверные вызовы и утечка памяти контекста | CALL, SCALL, MEM, LEAKS | Порог по Duration или MemoryPeak для CALL |
Алгоритм расследования TTIMEOUT и TDEADLOCK
- Найди событие жертвы (
TTIMEOUTилиTDEADLOCK): зафиксируй время,t:connectIDжертвы, еёContext(точный модуль и строку BSL, где запрос илиБлокировка.Заблокировать()упёрлись в ожидание) и атрибутWaitConnections— номер соединения-виновника! - Установи уровень блокировки:
- События
TLOCKс заполненнымRegionsиLocksозначают ожидание на менеджере управляемых блокировок 1С (rmngr); - Отсутствие конфликта в
TLOCKпри ошибке блокировки на запросеDBPOSTGRS/DBMSSQLозначает блокировку или эскалацию на уровне СУБД (часто из-за чтения/записи таблицы без предварительной управляемой блокировки либо отсутствия нужного индекса приUPDATE/DELETE).
- События
- Найди активную транзакцию виновника (
t:connectID = WaitConnections) на том же отрезке времени до момента таймаута: посмотри, какойTLOCK/SDBLон захватил и что держало его транзакцию открытой (медленный запрос, вызов внешнего HTTP-сервиса внутри транзакции, необъявленная управляемая блокировка по пустому измерению). - При
TDEADLOCKсравни порядок захвата пространств у обоих соединений: если соединение A блокируетТоварыНаСкладах → СвободныеОстатки, а соединение B —СвободныеОстатки → ТоварыНаСкладах, приведи порядок блокировки в коде к единому алфавитному порядку черезedt-mcp(см. навыкonec-transactions-and-locks).
Сопоставление с журналом регистрации и моделью edt-mcp
- Журнал регистрации (ЖР) фиксирует бизнес-контекст: пользователя, имя регламентного задания, метаданные и ссылку на документ (
Данные), текстПодробноеПредставлениеОшибки. Технологический журнал (ТЖ) фиксирует низкоуровневый системный стек, SQL-текст, планы запросов и номера соединенийt:connectID/ сеансовSessionID. Связывай их поSessionIDи метке времени. - Получив из
Contextпуть видаДокумент.<Имя>.МодульОбъекта(<Строка>)илиОбщийМодуль.<Имя>.Модуль(<Строка>), прочитай метод черезedt-mcp(read_method_source/read_module_source), учитывая возможное смещение строк при наличии активных перехватчиков расширений (&ИзменениеИКонтроль/&Вместо)!
Гигиена серверной отладки (RDBG / dbgs)
При подключении к серверу отладки (через edt-mcp-project-runtime-debug):
- На точке останова внутри открытой транзакции рабочий процесс удерживает все захваченные блокировки БД и кластера! Не останавливай выполнение внутри транзакции на общей базе с другими пользователями.
- При вычислении выражений в отладчике (
evaluate) не вызывай функции с побочными эффектами (Записать(), модифицирующие серверные методы, сдвигВыборка.Следующий(), изменяющий позицию курсора текущего цикла!), чтобы сама отладка не исказила проверяемый сценарий.
Транзакции, управляемые блокировки и контроль остатков
Используй навык, когда операция 1С читает остатки/лимиты и принимает решение о записи или проведении, выполняется параллельно несколькими пользователями или фоновыми заданиями, использует явные транзакции либо кэширует расчётные данные.
Чтение метаданных регистров, режима управления блокировками и модулей проведения выполняй через edt-mcp.
Сначала проверь режим блокировок и контекст транзакции
Через get_configuration_properties и get_metadata_details установи:
- режим управления блокировкой данных конфигурации и затронутых объектов (
УправляемыйилиАвтоматический); - вызывается ли код внутри уже открытой платформенной транзакции (
ОбработкаПроведения,ПередЗаписью,ПриЗаписи) или из внешней серверной процедуры.
В ОбработкаПроведения платформа уже открыла транзакцию: повторный НачатьТранзакцию() создаёт лишь вложенный уровень и не фиксирует изменения в СУБД до завершения внешнего проведения, тогда как непарный вызов или проглоченное исключение без ОтменитьТранзакцию() нарушает контракт транзакции.
Управляемая блокировка до ответственного чтения
Обычный запрос к таблице остатков в управляемом режиме читает зафиксированные данные без блокировки конкурентов: два параллельных сеанса увидят один и тот же свободный остаток 10 шт. и оба спишут по 10 шт., образовав -10 шт..
- Порядок «сначала заблокируй — потом прочитай»: создай
Новый БлокировкаДанных, добавь элементы блокировки по пространствам регистров в едином каноническом порядке (по алфавиту полных имён метаданных, чтобы исключить встречные взаимоблокировкиDeadlock), заполни измерения из набора записей или таблицы значений (ИсточникДанных) и вызовиБлокировка.Заблокировать()до запроса контроля остатков. - Точность измерений: блокируй только фактически изменяемые комбинации измерений (например,
Организация,Склад,Номенклатура,Серия). Пустое измерение в элементе управляемой блокировки расширяет блокировку на все значения этого измерения и парализует работу соседних складов или менеджеров. - Агрегация строк документа: перед проверкой остатка сверни табличную часть по ключу измерений регистра. Две строки одного товара по
6 шт.при остатке10 шт.пройдут построчную проверку по отдельности, но дадут дефицит-2 шт.в сумме.
Новая и классическая методики контроля остатков
Различай момент запроса к регистру относительно записи движений текущего документа:
| Методика | Порядок действий | Главная ловушка |
|---|---|---|
| Контроль после записи движений (рекомендуемая для типовых регистров остатков) | Сформировать наборы движений → установить управляемую блокировку → Движения.Записать() → проверить отсутствие строк с КоличествоОстаток < 0 в виртуальной таблице Остатки(МоментВремени() / Граница(..., Включая)) по товарам документа → при дефиците выставить Отказ = Истина | Запрос без Граница(..., ВидГраницы.Включая) на момент документа не увидит только что записанный расход самого документа или пропустит будущие отрицательные точки на оси времени |
| Контроль до записи движений | Установить управляемую блокировку → прочитать доступный остаток без старых движений перепроводимого документа (Регистратор <> &Ссылка или предварительное очищение) → сравнить со свёрнутой потребностью | Забытый прежний вклад этого же документа при перепроведении ложно удваивает расход и блокирует сохранение уменьшенного количества |
При Отказ = Истина внутри ОбработкаПроведения платформа сама откатывает записанные в этой транзакции движения; не оставляй побочных записей вне транзакции.
Внешние вызовы и длительные действия — строго вне транзакции
Никогда не выполняй внутри открытой транзакции (НачатьТранзакцию() ... ЗафиксироватьТранзакцию(), ОбработкаПроведения, ПередЗаписью, ПриЗаписи):
- синхронные вызовы HTTP/Web-сервисов, отправку почты, обращение к внешним СУБД или очередям сообщений;
- ожидание файловых сетевых ресурсов, торгового оборудования или генерацию тяжёлых внешних файлов;
- обращение к LLM/внешним API распознавания.
Сетевой таймаут внутри транзакции удерживает блокировки таблиц СУБД для всех пользователей кластера, а откат транзакции после уже отправленного внешнего HTTP-запроса создаёт неустранимое расхождение систем. Используй двухфазную схему (регистрация задания в регистре очереди внутри транзакции → отправка фоновым заданием вне транзакции).
Полнота ключа кэша и границы дат / часовых поясов
- При использовании модулей
ПовтИспили прикладного кэша проверяй полноту ключа: если результат зависит от организации, валюты, даты среза, склада или прав текущего пользователя (RLS), все эти параметры обязаны входить в аргументы закэшированной функции. При частичной ошибке расчёта не сохраняй неполный результат в кэш как успешный. - Различай
ТекущаяДата()(время клиентского компьютера, ненадёжное для учёта) иТекущаяДатаСеанса()(серверное время с учётом часового пояса сеанса). Границы суток (НачалоДня,КонецДня) и запрета изменений вычисляй в часовом поясе хозяйственной операции / организации, а не произвольного фонового процесса.
Чем доказывается надёжность
Чтение модуля или одиночный прогон одного документа не доказывают защиту от гонки. Проверь:
- перепроведение уже проведённого документа с тем же, меньшим и большим количеством;
- документ с двумя строками одной номенклатуры;
- конкурентную попытку списания одного остатка из двух пересекающихся сеансов (один должен зафиксировать списание, второй — получить предметный отказ без отрицательного остатка в регистре).
Сценарии Vanessa Automation
Используй навык, когда результат задачи доказывается сценарием Vanessa Automation: открытие форм, действия пользователя, печатные формы, подготовка эталонных данных перед прогоном.
Навык описывает предметную методику фич. Запуск и наблюдение выполняет MCP Runner; его навык описывает параметры и квитанции.
Перед первой записью feature
Сначала найди общие модули через list_modules и прочитай подходящий код через
read_module_source: проект может уже содержать подготовку контрольных данных и
экспортные функции проверки. Используй подтверждённые функции вместо сочинения
API создания объектов. Отсутствие прочитанного кода — повод исследовать, а не
угадывать названия методов.
Проверка расхождения не должна создавать дополнительный документ на величину расхождения. Документы должны отражать заявленные исходные условия. Ожидаемое значение — по документам; ошибочное значение отчёта не становится эталоном. Неизвестный шаг или ошибка BSL в JUnit означает неготовый сценарий: исправь его и повтори запуск, пока проверка не дойдёт до сравнения предметных значений.
Сначала отличи проверку от подготовки
- Сценарий проверки — файл
.feature. Модуль BSL его не заменяет. - Подготовка базы и проверка — разные фичи. Подготовка отбирается тегом из её файла настроек; не выдумывай тег, которого в проекте нет.
- В JSON имя тега без
@, в фиче — с@. Если у подготовки и основного прогона разные файлы настроек, их списки тегов не смешивай.
Пиши фичу шагами проекта
- Файлы лежат в
features/**/*.feature, в корне или в каталоге вродеЭкспортные сценарии/. Это Gherkin на русском. Фичи OneScript с# language: ru— это 1bdd, не Vanessa. - Первая строка:
# language: ruили#language: ru. Заголовок —Функционал:илиФункциональность:.@treeчастый; если в настройках включён тег дерева по умолчанию, иерархия работает и без него. - Текст шага бери из соседних фич этого проекта. Не придумывай формулировку, которой в проекте нет. Новую формулировку добавляй только вместе с реализацией шага.
- Клиента подключай шагом из соседних фич: уже существующий TestClient или именной клиент с логином и паролем.
- Библиотека экспортных сценариев помечена
@ExportScenarios(сравнение тега без учёта регистра). Имя сценария — вызываемый шаг; параметр в заголовке в кавычках, в теле — в квадратных скобках. На такую библиотеку часто вешают@IgnoreOnCIMainBuild: это не сценарий проверки. - В приёмке пользовательского интерфейса не подменяй действия пользователя выполнением кода встроенного языка. В подготовке код на сервере допустим только когда шага недостаточно: окно ИТС, классификатор поставки, запись, которую подписка пускает лишь в режиме загрузки. Если в проекте уже есть свой экспортный шаг записи константы, вызывай его.
Данные и печатные формы
- Скалярные константы и эталонные справочники загружай шагами генератора тестовых данных Vanessa: перезаполнение константы и проверка или создание объектов справочника. Источник значений — файл рядом с фичами, не модуль.
- Ссылочные константы ставь после справочников, на которые они смотрят.
- Печатную форму не считают проверенной тем, что её открыли. После формирования сравни Табличный документ с эталоном
.mxlрядом с фичей шагом видаТабличный документ "ИмяРеквизита" равен макету "Эталон.mxl". Имя реквизита бери с формы печати. Эталон не собирай кодом и не набирай таблицей внутри шага вместо файла. - Заголовок окна в шаге «открылось окно» бери с формы, а не выдумывай.
Доказательство
- Каталог фич в настройках бывает каталогом или одним файлом. Выгрузка формы часто вложена; булево пишут
trueили строкойИстина. - Одна информационная база — один владелец прогона. Независимые прогоны идут по очереди. Для проверки конкурентности нужны несколько согласованных сеансов внутри одного прогона: общий набор тестовых данных, управляемое пересечение операций и результаты каждого сеанса. Возможность такого исполнения подтвердить у штатного инструмента; два последовательных действия гонку не проверяют. Живое окно после сценария само по себе не определяет итог: проверяй квитанцию и владение процессом. Не запускай независимый прогон поверх незавершённого и не завершай чужие сеансы.
- Запуск и наблюдение выполняет vanessa-runner. Не подменяй его прямым CLI и не объявляй успех по наличию EPF без квитанции прогона.
Обращение о видимом отчёте
Слова пользователя «отчёт показывает» задают объект проверки — сформированный отчёт в клиенте 1С. Найденная серверная функция помогает объяснить механизм, но её вызов не воспроизводит обращение. Читай модуль формы, её команды и тип реквизита результата. Если формы нет, зафиксируй неполноту стенда; не меняй критерий приёмки на проверку функции.
До запуска сверь feature с цепочкой: подключение TestClient → открытие формы → формирование → проверка видимого результата. Каждому действию соответствует реальный шаг установленной библиотеки. Имена формы, команды и реквизита бери из проекта; ожидаемые строки — из исходных условий и документов.
Где найти определения в стандартной Vanessa Automation:
features/Libraries/TestClients/step_definitions/РаботаСTestClient/Forms/Форма/Ext/Form/Module.bsl:Когда я подключаю клиент тестирования с параметрами:. Затем отдельной таблицей колонкиИмя,Тип клиента,Порт,Строка соединенияи значения разрешённой среды. Это запуск TestClient, а не просто текстовое имя базы.features/Libraries/VB/step_definitions/ОткрытьФормуЧерезКоманду/Forms/Форма/Ext/Form/Module.bsl:Дано я открываю основную форму отчета "<имя отчёта в метаданных>"либоДано я открываю навигационную ссылку "<ссылка>". Для отчёта навигационная ссылка имеет видe1cib/app/Отчет.<Имя>, а путь модуля EDT навигационной ссылкой не является.features/Libraries/UITestRunner/step_definitions/РаботаСИнтерфейсом/Forms/Форма/Ext/Form/Module.bsl:И я нажимаю на кнопку "<кнопка>"иИ табличный документ "<реквизит>" содержит строки:с таблицей ожидаемых заголовков и строк. Для реквизита типа таблицы используй шаг таблицы, а не табличного документа.
Пути выше — указатели на определения, не разрешение угадывать параметры. Прочитай определения шагов и примеры перед записью feature. Проверь, что их каталоги включены в настройки загрузки библиотек. При неизвестном шаге найди его точное определение и исправь текст; удаление подключения или формирования не исправляет сценарий.
Новые результаты хранятся в каталоге текущего прогона. Сохраняй исходный JUnit/Allure, различая ошибку шага и несовпадение видимых данных. Если нужен снимок экрана для разбора, сохраняй сформированный отчёт; код шага и текст чата не являются изображением отчёта.
Воспроизведение серверной логики
Это отдельный вид диагностики, когда предмет задачи — серверная функция или запрос. Такой прогон не проверяет экран и не заменяет воспроизведение обращения о пользовательском отчёте. В UI-сценарии серверный код допустим для подготовки данных и проверки состояния регистров после пользовательского действия. Он не заменяет само действие в форме. Прочитай подходящие модули проекта до записи проверки.
Определения шагов находятся в
features/Libraries/ВстроенныйЯзык/ВстроенныйЯзык/Forms/Форма/Ext/Form/Module.bsl.
Многострочный блок начинается на следующей строке после текста шага:
И я выполняю код встроенного языка на сервере
"""bsl
// Проверенный код подготовки из проекта
"""
Не добавляй """bsl в строку шага и не смешивай блок кода с таблицей Gherkin.
Используй подтверждённые методы проекта вместо сочинения API. Не создавай
дополнительные документы ради получения желаемой разницы и не меняй ожидаемое
значение ради зелёного результата.
Приемка последовательностей и достоверность результата
Выборка.Следующий() возвращает булево, а не количество записей. После перехода
читай поле агрегата Выборка.Количество. Сравнение двух значений Истина
не проверяет отсутствие дублей. Проверяй ожидаемое число записей и их сумму,
а для неизменного вида учета — состав проводок, границу и дату запрета до/после.
Повторный вызов восстановления должен сохранить число и состав проводок.
Дата BSL задается Дата(год, месяц, день, часы, минуты, секунды); не передавай
произвольную строку вместо даты. Строку соединения бери из окружения без
перепечатывания. До запуска сверь каждый шаг с реальным определением библиотеки.
Перед выводом «проверено» прочитай конечный JUnit/Allure именно своего runId.
task_result без ошибки, завершенный процесс или уверенность в исходниках
не доказывают успех. При ошибке шага не перечисляй ожидаемые проверки как
выполненные. Укажи конкретную ошибку и фактически пройденную часть.
Действие в форме и проверка учета
Для приемки учетной команды раздели три части: исходное состояние → команда формы через TestClient → проверка проводок и границ. Снимай исходные записи до действия; сравнивай одинаковые поля в устойчивом порядке после него. Сумма без состава записей не доказывает сохранность учета: две ошибки могут взаимно компенсироваться. В отрицательной проверке подтверждай ожидаемый текст или код отказа, а не любое исключение.
Отчет о прогоне должен соответствовать проверенному feature и конкретному runId. Не заменяй исходный упавший отчет успешным: храни результаты разных запусков раздельно и показывай отчет принятого запуска.
После принятого прогона используй его отчет и уже сформированную форму. Снимок экрана не требует повторного изменения данных. Если для съемки форму нужно открыть заново, выполни только открытие формы без повторного заполнения базы.
Дополнительная памятка
- Среда исполнения, фикстуры БСП и достоверность прогонов
- Запуск сценариев и управление ИБ через MCP:
vanessa-runner
Sponsors
Details
- Marketplace
- infostart-hub/vanessa-ai-pipeline
- Source
- .agents/plugins/1c-ai-pipeline
- Category
- Community