objets_metier_rs 1.0.2

Bibliothèque Rust moderne et sûre pour l'API COM Objets Métier Sage 100c - Production Ready
use crate::com::{SafeDispatch, SafeVariant};
use crate::errors::SageResult;
use windows::Win32::System::Com::IDispatch;

/// Wrapper pour un document générique (IBODocument)
///
/// Représente un document commercial générique qui peut être de vente, achat, stock ou interne.
/// Cette classe est une abstraction commune pour tous les types de documents.
///
/// ⚠️ IMPLÉMENTATION MINIMALE - Version Phase 1
///
/// Pour un accès typé par type de document, utilisez les wrappers spécifiques:
/// - `DocumentVente` pour les devis, commandes, BL, factures de vente
/// - `DocumentAchat` pour les documents fournisseurs
/// - `DocumentStock` pour les mouvements de stock
/// - `DocumentInterne` pour les documents internes
///
/// # Exemple
/// ```no_run
/// use objets_metier_rs::wrappers::cial::CialApplication;
///
/// let cial_app = CialApplication::new("Objets100c.CIAL")?;
/// let factory = cial_app.factory_document()?;
/// // Accès générique à tous types de documents
/// # Ok::<(), Box<dyn std::error::Error>>(())
/// ```
pub struct Document {
    pub(crate) dispatch: IDispatch,
}

impl Document {
    /// Crée un SafeDispatch temporaire pour les appels
    fn dispatch(&self) -> SafeDispatch<'_> {
        SafeDispatch::new(&self.dispatch)
    }

    // ==================== PROPRIÉTÉS PRINCIPALES ====================

    /// Numéro de pièce du document
    pub fn do_piece(&self) -> SageResult<String> {
        self.dispatch()
            .call_method_by_name("DO_Piece", &[])?
            .to_string()
    }

    pub fn set_do_piece(&self, value: &str) -> SageResult<()> {
        let param = SafeVariant::from_string(value);
        self.dispatch().call_property_put("DO_Piece", &[param])?;
        Ok(())
    }

    /// Type de document (enum DocumentType)
    pub fn do_type(&self) -> SageResult<i32> {
        self.dispatch()
            .call_method_by_name("DO_Type", &[])?
            .to_i32()
    }

    /// cbMarq - Identifiant unique du document
    pub fn cbmarq(&self) -> SageResult<i32> {
        self.dispatch().call_method_by_name("cbMarq", &[])?.to_i32()
    }

    // ==================== MÉTHODES D'ÉCRITURE ====================

    /// Écrit le document dans la base de données
    pub fn write(&self) -> SageResult<()> {
        self.dispatch().call_method_by_name("Write", &[])?;
        Ok(())
    }

    /// Supprime le document de la base de données
    /// ⚠️ ATTENTION : Cette opération est irréversible
    pub fn remove(&self) -> SageResult<()> {
        self.dispatch().call_method_by_name("Remove", &[])?;
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_document_creation_needs_factory() {
        // Les documents sont créés via FactoryDocument
        // Ce test documente le pattern d'utilisation
    }
}