public ScanResult scan()

in doc-architect/doc-architect-core/src/main/java/com/docarchitect/core/scanner/impl/python/SqlAlchemyScanner.java [181:235]
44 lines of code
6 McCabe index (conditional complexity)

    public ScanResult scan(ScanContext context) {
        log.info("Scanning SQLAlchemy entities in: {}", context.rootPath());

        List<DataEntity> dataEntities = new ArrayList<>();
        List<Relationship> relationships = new ArrayList<>();
        ScanStatistics.Builder statsBuilder = new ScanStatistics.Builder();

        List<Path> pythonFiles = context.findFiles(PYTHON_FILE_PATTERN).toList();
        statsBuilder.filesDiscovered(pythonFiles.size());

        if (pythonFiles.isEmpty()) {
            return emptyResult();
        }

        int skippedFiles = 0;

        for (Path pythonFile : pythonFiles) {
            if (!shouldScanFile(pythonFile)) {
                skippedFiles++;
                continue;
            }

            statsBuilder.incrementFilesScanned();

            // Use three-tier parsing with fallback
            FileParseResult<EntityResult> result = parseWithFallback(
                pythonFile,
                classes -> extractEntitiesFromAST(pythonFile, classes),
                createFallbackStrategy(),
                statsBuilder
            );

            if (result.isSuccess()) {
                for (EntityResult entityResult : result.getData()) {
                    dataEntities.add(entityResult.entity());
                    relationships.addAll(entityResult.relationships());
                }
            }
        }

        ScanStatistics statistics = statsBuilder.build();
        log.info("Found {} SQLAlchemy entities and {} relationships (success rate: {:.1f}%, overall parse rate: {:.1f}%, skipped {} files)",
                dataEntities.size(), relationships.size(), statistics.getSuccessRate(), statistics.getOverallParseRate(), skippedFiles);

        return buildSuccessResult(
            List.of(),           // No components
            List.of(),           // No dependencies
            List.of(),           // No API endpoints
            List.of(),           // No message flows
            dataEntities,        // Data entities
            relationships,       // Relationships
            List.of(),           // No warnings
            statistics
        );
    }